Conectar un cliente

https://api.woku.app/mcp

​

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.

​

Por cliente

• claude.ai
• Claude Code
• ChatGPT
• Codex
• OpenCode

En Claude Free puedes tener un conector personalizado. En Team y Enterprise, un propietario debe agregarlo primero en Organization settings → Connectors; después, cada integrante conecta su cuenta de woku.

1

Abre los conectores personalizados

En claude.ai, entra a Personalizar → Conectores. Haz clic en Agregar → Agregar conector personalizado.

2

Ingresa la URL de woku

Escribe woku en Nombre y https://api.woku.app/mcp en URL del servidor MCP. Haz clic en Continuar.

3

Confirma la autenticación

En el segundo paso, deja seleccionados Iniciar sesión ahora y Registrar automáticamente. Claude registra el cliente OAuth mediante DCR; no necesitas crear un ID ni un secreto de cliente. Haz clic en Agregar.

4

Autoriza la empresa

Abre woku en tus conectores y haz clic en Conectar. Si hace falta, inicia sesión en woku. En admin.woku.app, elige la empresa a la que Claude tendrá acceso, revisa los permisos y haz clic en Autorizar. La captura usa la empresa woku como ejemplo; elige la tuya.

5

Activa woku y comprueba la conexión

En un chat nuevo, abre + → Conectores y comprueba que woku esté activado. Si Claude pide permiso para usar una herramienta de lectura, revisa la solicitud y selecciona Permitir una vez.

Prueba con: «Usa el conector woku y la herramienta get_company para decirme solo el nombre de la empresa conectada. No modifiques ningún dato». La respuesta debe nombrar la empresa que autorizaste.

Si tu cuenta muestra opciones diferentes, consulta la guía oficial de conectores personalizados de Claude.

Agrega el servidor desde la terminal:

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.

Hazlo en ChatGPT desde un navegador. Necesitas acceso al modo desarrollador; en un espacio de trabajo, su administrador puede limitar los plugins personalizados.

1

Activa el modo desarrollador

Abre tu menú de perfil y entra a Configuración → Seguridad e inicio de sesión. Busca Modo de desarrollador y activa el interruptor. Las capturas muestran el estado inicial apagado y el resultado encendido.

2

Inicia la creación de una aplicación MCP

Cierra Configuración y abre Complementos en la barra lateral, o entra a chatgpt.com/plugins. Haz clic en + → Crear aplicación. Si aparece una ventana para subir un archivo, elige Crear aplicación MCP. No necesitas subir un paquete.

3

Configura woku y OAuth

Completa el formulario:

Campo	Valor
Nombre	woku
Conexión	URL del servidor: https://api.woku.app/mcp
Autenticación	OAuth

El ícono y la descripción son opcionales. Abre Configuración avanzada de OAuth y confirma que el Método de registro sea Registro dinámico de clientes (DCR). Revisa los alcances mcp:read y mcp:write: el primero permite consultas y el segundo, acciones de escritura. woku registra el cliente automáticamente, sin un ID ni un secreto que debas pegar. Marca Entiendo y quiero continuar y haz clic en Crear.

4

Instala la aplicación

En Complementos → Personal → Creados por mí, abre woku y haz clic en Instalar complemento. Crear la aplicación y agregarla a tu ChatGPT son pasos separados. Si el nombre ya existe, busca la aplicación que creaste en Creados por mí antes de intentar duplicarla.

5

Conecta woku a la conversación

Abre un chat nuevo. Escribe @woku y elige la aplicación de la lista. Envía: «Usa el plugin woku y su herramienta get_company para decirme solo el nombre de la empresa conectada. No modifiques ningún dato».

La primera vez, ChatGPT te pedirá Conectar y luego Iniciar sesión con woku.

6

Autoriza una empresa y verifica el resultado

En admin.woku.app, elige la empresa que podrá consultar ChatGPT, revisa los permisos y haz clic en Autorizar. La captura selecciona la empresa woku como ejemplo. Al volver al chat, comprueba que la herramienta respondió con el nombre de la empresa elegida.

Consulta la guía oficial del modo desarrollador de ChatGPT si los menús de tu cuenta se ven distintos.

Agrega el servidor a ~/.codex/config.toml:

[mcp_servers.woku]
url = "https://api.woku.app/mcp"

Codex usa el OAuth de woku de forma automática (auth = "oauth" por defecto). La primera vez, completa la autenticación en el navegador cuando Codex lo solicite.

Agrega el servidor a tu opencode.json:

{
  "mcp": {
    "woku": {
      "type": "remote",
      "url": "https://api.woku.app/mcp",
      "enabled": true
    }
  }
}

OpenCode maneja el OAuth de woku automáticamente (registro dinámico de cliente). Si necesitas iniciar la autenticación a mano, ejecuta opencode mcp auth woku.

​

Si no puedes conectar

• No aparece Agregar conector personalizado en Claude: revisa el acceso a conectores personalizados. En Team y Enterprise, pide a un propietario que agregue woku para la organización.
• No aparece Modo de desarrollador o el botón + en Complementos: verifica tu plan de ChatGPT, usa la versión web y revisa con el administrador del espacio si permite plugins personalizados.
• woku aparece conectado, pero el asistente no lo usa: actívalo en Claude o selecciónalo con @woku en ChatGPT y vuelve a enviar la prueba con get_company.
• La respuesta muestra otra empresa: desconecta woku en el asistente y vuelve a autorizarlo eligiendo la empresa correcta.
• Las consultas funcionan, pero las modificaciones fallan: revisa si autorizaste mcp:write. Reconecta y aprueba ese permiso si necesitas crear o editar datos.