Skip to main content
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:
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:
1

Agrega el servidor en tu cliente

Pega la URL https://api.woku.app/mcp donde tu cliente pida el servidor o conector MCP.
2

Aprueba el acceso

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

Empieza a preguntar

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