> ## 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

> Qué es el servidor MCP de woku, cómo se autentica y qué puede tocar un agente conectado

woku expone un **servidor MCP** (Model Context Protocol) para que un agente de IA consulte los datos de tu empresa sin un navegador de por medio: wokus, métricas de NPS, CSAT y CES, respuestas de formularios, planes de acción y más, directamente desde la conversación. Es el mismo motor que usa el panel administrativo: cada herramienta ejecuta el comando o la consulta que corre el panel, así que las dos superficies no pueden divergir.

<Info>
  La autenticación es **OAuth 2.1**. Te conectas iniciando sesión en woku desde tu navegador y aprobando una pantalla de consentimiento; no hay clave que crear ni pegar. Eso es lo que permite que asistentes de navegador (Claude, ChatGPT) se conecten, no solo agentes de código. La lista `tools/list` en una conexión viva es siempre la respuesta autoritativa sobre lo que ofrece el servidor.
</Info>

## El endpoint

```
POST https://api.woku.app/mcp
```

* **Transporte:** Streamable HTTP.
* **Nombre del servidor:** `woku`.
* **Sin estado por diseño.** `GET` y `DELETE` responden `405`: no hay stream iniciado por el servidor ni sesión que terminar, así que anunciar cualquiera de los dos sería anunciar una capacidad que no existe.
* **Sin claves de API.** La autenticación usa OAuth y el cliente descubre el flujo por sí solo; tú solo apruebas el acceso desde tu cuenta de woku.

## Autenticación

El acceso se aprueba desde tu sesión en el panel administrativo, nunca compartiendo tu contraseña ni una clave de API con el agente.

* **OAuth 2.1 con PKCE obligatorio.** El cliente descubre los endpoints de autorización y token por sí solo y completa el flujo en el navegador.
* **Consentimiento explícito.** Eliges la empresa que quieres conectar en la pantalla de consentimiento; la conexión queda ligada a esa empresa.
* **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.

## Una conexión, una empresa

Cada conexión queda asociada a **una sola empresa**: el agente solo ve los datos de la empresa que aprobaste en la pantalla de consentimiento. Si perteneces a varias empresas y quieres consultarlas todas, crea una conexión por empresa.

## Los permisos habilitan herramientas

Las conexiones manejan dos permisos: `mcp:read` para consultar datos y `mcp:write` para las herramientas que crean o modifican. Si la conexión no tiene `mcp:write`, las herramientas de escritura responden con un error que lo indica y el resto sigue funcionando con normalidad. El detalle de qué herramienta es de lectura o de escritura está en [Herramientas](/docs/mcp/herramientas).

## Gestionar y revocar conexiones

* **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.

Para conectar un cliente paso a paso, revisa [Conectar un cliente](/docs/mcp/conectar-un-cliente).