Conectar clientes MCP

Todos los clientes deben apuntar al endpoint remoto:

https://api.wodira.app/mcp

Cuando el cliente soporte OAuth, deja que haga discovery desde WODira y completa el login en el navegador. El scope mínimo requerido es profile.

Conectar rápido

El único deeplink público estable que podemos ofrecer ahora es el de Claude. Abre el modal de conector personalizado con nombre y URL ya rellenados:

Añadir WODira a Claude

Ver otros clientes

Para Codex, Cursor, Gemini CLI, ChatGPT, Perplexity y Grok usa las configuraciones siguientes. Si esos clientes publican un deeplink oficial equivalente, añadiremos su botón aquí.

Codex

Codex soporta servidores MCP Streamable HTTP en config.toml.

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

Después inicia sesión:

codex mcp login wodira

Dentro de Codex usa /mcp para revisar que el servidor está conectado y que la tool hello aparece disponible.

Claude Code

Si usas Claude web, puedes abrir el modal directo:

Añadir conector en Claude

Si usas Claude Code, añade el servidor remoto por HTTP:

claude mcp add --transport http wodira https://api.wodira.app/mcp

En una sesión de Claude Code, abre:

/mcp

Desde ahí puedes revisar estado, autenticarte y ver las tools descubiertas. Si tu versión usa JSON, el transport streamable-http es equivalente al HTTP remoto.

Cursor

Cursor permite añadir servidores MCP desde su configuración MCP. Añade un servidor remoto llamado wodira con URL:

https://api.wodira.app/mcp

Si tu versión permite editar JSON compatible con MCP, usa este bloque como base:

{
  "mcpServers": {
    "wodira": {
      "url": "https://api.wodira.app/mcp"
    }
  }
}

Selecciona Streamable HTTP si el UI te pide elegir transport. Si el cliente solicita autorización, completa el flujo OAuth de WODira.

Gemini CLI

Gemini CLI usa settings.json y distingue entre SSE (url) y Streamable HTTP (httpUrl). Para WODira usa httpUrl:

{
  "mcpServers": {
    "wodira": {
      "httpUrl": "https://api.wodira.app/mcp"
    }
  }
}

Después ejecuta /mcp en Gemini CLI para comprobar conexión, tools y recursos.

ChatGPT

Para ChatGPT, el camino recomendado es una app basada en Apps SDK/MCP Apps. WODira ya expone tools y recursos UI con URIs ui://wodira/..., por lo que una app o conector compatible puede usar el servidor remoto:

https://api.wodira.app/mcp

En el manifiesto/configuración de tu app, declara el servidor MCP remoto y habilita OAuth para usuarios. Después prueba hello y una tool de lectura antes de activar acciones de escritura.

Perplexity y Grok

Perplexity y Grok cambian con frecuencia su soporte de conectores externos. Si tu plan o workspace ofrece MCP remoto con OAuth, usa:

https://api.wodira.app/mcp

Si no aparece una opción de MCP remoto/Streamable HTTP, usa un cliente soportado actualmente como Codex, Claude Code, Cursor o Gemini CLI. No uses proxies con tokens pegados en prompts salvo que estén controlados por tu equipo y revisados para seguridad.

Fallback SSE

Solo para clientes antiguos sin Streamable HTTP:

https://api.wodira.app/mcp/sse

El endpoint de mensajes asociado es:

https://api.wodira.app/mcp/messages

Prefiere Streamable HTTP siempre que el cliente lo soporte.

Verificación

1. Conecta el servidor wodira.
2. Completa OAuth si el cliente lo pide.
3. Ejecuta hello.
4. Ejecuta una tool de lectura, por ejemplo search_events.
5. Para organizer, ejecuta organizer_list_my_organizations antes de operar sobre eventos.