> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Servidor MCP
> Conecta agentes de IA como Claude, ChatGPT o Claude Code a los datos de tu empresa en woku mediante el protocolo MCP
woku incluye un **servidor MCP** (Model Context Protocol) que permite conectar agentes de IA a los datos de tu empresa. Una vez conectado, un agente como Claude o ChatGPT puede consultar tus wokus, métricas de NPS, CSAT y CES, respuestas de formularios, planes de acción y más, directamente desde la conversación.
La única URL que necesitas es:
```
https://api.woku.app/mcp
```
No hay claves de API que copiar ni configuración manual. La autenticación usa OAuth y el cliente descubre el flujo por sí solo: tú solo apruebas el acceso desde tu cuenta de woku.
## Requisitos
* Una cuenta de woku con acceso a la empresa que quieres conectar.
* Un cliente compatible con MCP sobre HTTP, como claude.ai, Claude Code, ChatGPT u otro agente que soporte el protocolo.
## Conectar paso a paso
El flujo es el mismo en todos los clientes:
Pega la URL `https://api.woku.app/mcp` donde tu cliente pida el servidor o conector MCP.
El navegador abre la pantalla de consentimiento del panel administrativo de woku. Inicia sesión si aún no lo has hecho, elige la empresa que quieres conectar y aprueba.
La conexión queda ligada a la empresa que elegiste y el agente ya puede usar las herramientas de woku.
En claude.ai abre la configuración, entra a la sección de **conectores** y agrega un **conector personalizado** con la URL `https://api.woku.app/mcp`. Al guardarlo, el navegador abre la pantalla de consentimiento de woku.
Agrega el servidor desde la terminal:
```bash theme={null}
claude mcp add --transport http woku https://api.woku.app/mcp
```
Luego, dentro de Claude Code, ejecuta `/mcp`, selecciona **woku** y completa la autenticación en el navegador.
Activa el **modo desarrollador** en la configuración de conectores de ChatGPT y agrega el servidor con la URL `https://api.woku.app/mcp`.
Sin el modo desarrollador, ChatGPT solo puede usar las herramientas `search` y `fetch` en investigaciones profundas (deep research). Con el modo desarrollador activo tiene acceso a todas las herramientas.
Cada conexión queda asociada a **una sola empresa**. Si perteneces a varias empresas y quieres consultarlas todas, crea una conexión por empresa.
## Qué puede hacer el agente
El servidor expone **36 herramientas** organizadas por familia:
| Familia | Herramientas |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Wokus | `list_wokus`, `get_woku`, `list_woku_reviews` |
| NPS | `list_nps_tools`, `get_nps_statistics` |
| CSAT y CES | `get_csat_metrics`, `get_ces_metrics` |
| Formularios | `list_forms`, `get_form_summary`, `list_form_responses` |
| Clientes | `list_clients`, `get_client_stats` |
| Empresa | `get_company`, `get_company_statistics`, `simulate_quarantine` |
| Alertas | `list_alerts`, `list_alert_dispatches`, `test_alert_rule` |
| Metas | `create_goal`, `get_goals_compliance` |
| Planes de acción | `list_action_plans`, `get_action_plan`, `approve_action_plan`, `reply_to_action_plan`, `update_action_plan_task` |
| Tickets | `list_tickets`, `get_ticket`, `update_ticket` |
| Trackers | `list_trackers`, `create_tracker`, `assign_tracker_to_woku` |
| Reportes | `list_report_definitions`, `run_report` |
| Inteligencia de reseñas | `query_review_intelligence` |
| Búsqueda universal | `search`, `fetch` |
Con esto, un agente puede resumir las reseñas de la última semana, comparar el NPS entre sucursales, revisar el cumplimiento de metas, aprobar un plan de acción o crear un tracker, todo desde la conversación.
Las herramientas `search` y `fetch` siguen el contrato de investigación profunda de ChatGPT: `search` busca en todos los datos de la empresa y `fetch` trae el detalle de un resultado.
### Lectura y escritura
Las conexiones manejan dos permisos: `mcp:read` para consultar datos y `mcp:write` para las herramientas que crean o modifican, como crear metas o trackers, aprobar y responder planes de acción o actualizar tickets. Si la conexión no tiene el permiso `mcp:write`, las herramientas de escritura responden con un error que lo indica y el resto sigue funcionando con normalidad.
## Seguridad y límites
* **Una empresa por conexión.** El agente solo ve los datos de la empresa que aprobaste en la pantalla de consentimiento.
* **OAuth con PKCE obligatorio.** Nunca compartes tu contraseña ni claves de API con el agente. El acceso se aprueba desde tu sesión en el panel administrativo.
* **Vigencias acotadas.** El código de autorización dura 10 minutos, el token de acceso 1 hora y el token de renovación 30 días. La renovación es automática mientras uses la conexión.
* **Membresía verificada en cada renovación.** Al renovar el token se comprueba que sigas siendo miembro de la empresa. Si te remueven de la empresa, la conexión deja de funcionar cuando expira el token de acceso, a más tardar en 1 hora.
* **Revocación desde el cliente.** Puedes eliminar el conector en tu cliente en cualquier momento para cortar el acceso.