https://api.wondeya.com/mcp y se autentica con OAuth 2.1. No creas ni pegas una credencial: apuntas un cliente a la URL, este descubre que el endpoint necesita OAuth, tu navegador se abre en wondeya y apruebas una pantalla de consentimiento. Como el inicio de sesión es un flujo de navegador, los asistentes de navegador se conectan igual que los agentes de código.
Cómo funciona la conexión
Todo cliente sigue los mismos tres pasos, la mayoría invisibles:1
Agrega el servidor por su URL
https://api.wondeya.com/mcp, como servidor HTTP (Streamable HTTP). Sin encabezado, sin token.2
Inicia sesión cuando se abra el navegador
El cliente descubre que el endpoint necesita OAuth, se registra a sí mismo y abre wondeya en tu navegador. Inicia sesión si aún no lo hiciste.
3
Aprueba la pantalla de consentimiento
Una sola pantalla nombra al cliente, el espacio de trabajo al que se ligará la conexión, a ti y los permisos que solicita. Apruébala y el cliente queda conectado.La conexión se liga al espacio de trabajo activo en tu sesión en ese momento. Para conectar a un espacio de trabajo distinto, primero cambia de espacio de trabajo en la consola y luego inicia la conexión.
Otorga los permisos más acotados que resuelvan la tarea. Una conexión con solo
landings:read y knowledge:read puede auditar un espacio de trabajo y no puede cambiar nada. Tu rol limita lo que puedes otorgar: un propietario o administrador puede otorgar lectura y escritura; un miembro puede otorgar solo lectura. La introducción a MCP lista cada permiso y lo que desbloquea.Asistentes de navegador: Claude y ChatGPT
Agrega wondeya como conector personalizado, usando la misma URL. En la configuración de conectores del asistente, agrega un conector cuya URL seahttps://api.wondeya.com/mcp; te enviará a wondeya para iniciar sesión y aprobar, y luego listará las herramientas. Este es el flujo para el que existe OAuth: sin encabezado que configurar, nada que guardar en tu máquina.
Claude Code
Agrégalo con la CLI (sin encabezado esta vez, porque el handshake de OAuth lo reemplaza):/mcp dentro de Claude Code y elige autenticarte: abre tu navegador para el inicio de sesión y el consentimiento, y luego muestra el servidor como conectado con sus herramientas. También puedes declararlo en el .mcp.json de un proyecto:
Cualquier otro cliente que soporte MCP por HTTP
Editores y agentes como Cursor, Windsurf, VS Code, opencode y Codex toman la misma forma: un servidor HTTP en la URL, sin encabezadoAuthorization. Cuando el cliente llega por primera vez al endpoint, dispara el inicio de sesión en el navegador, y una vez que apruebas, él mismo guarda el token.
Clientes que solo hablan stdio
Puentea el endpoint HTTP hacia un proceso stdio conmcp-remote, que ejecuta el handshake de OAuth en tu máquina y cachea el token:
Gestionar y revocar una conexión
Cada conexión aparece listada en la consola en Configuración → Aplicaciones conectadas, con los permisos que tiene. Revócala ahí; la revocación surte efecto en la siguiente solicitud, y el cliente debe iniciar sesión de nuevo para reconectarse. No hay caché que esperar a que expire.Comprueba que funciona
Pídele a tu cliente que liste las herramientas del servidor. Todo cliente de MCP tiene una manera de mostrarlas, ytools/list es la respuesta autoritativa sobre lo que ofrece este servidor. Deberías ver las herramientas de agente, site key, proyecto, página, conocimiento, imagen, marca, tema y uso.
Una buena primera solicitud, porque es de solo lectura y prueba toda la cadena: «lista las páginas en mi espacio de trabajo de wondeya».