Agentes AI con MCP

Calendaria puede conectarse a agentes AI mediante MCP remoto en:

https://api.calendaria.co/mcp

Usa esta URL en Claude, Cursor u otro cliente MCP compatible con OAuth cuando quieras que ese cliente use herramientas de calendario de Calendaria. El soporte MCP vive dentro de la API existente de Calendaria; no hay una app separada de Calendaria que instalar para clientes MCP remotos.

Para ChatGPT, Calendaria está creando una app dedicada de Calendaria para ChatGPT. La configuración en ChatGPT usará ese flujo de app en vez de pedir a usuarios que peguen la URL MCP remota en ChatGPT.

Flujo de conexión

El flujo normal es:

1. Agrega la URL MCP de Calendaria en tu cliente MCP.
2. El cliente abre la página de autorización de Calendaria.
3. Inicia sesión con tu magic link de Calendaria.
4. Autoriza al agente AI.
5. Vuelve al cliente y usa las herramientas de Calendaria desde el agente.

Los clientes MCP no reciben cookies del dashboard, tokens OAuth de Google, credenciales del proveedor ni datos cifrados de tokens. El cliente recibe acceso a las herramientas MCP de Calendaria mediante la autorización que apruebas.

Configuración en Cursor

Agrega Calendaria al mcp.json de Cursor:

{
  "mcpServers": {
    "calendaria": {
      "type": "http",
      "url": "https://api.calendaria.co/mcp"
    }
  }
}

Después de guardar la configuración, sigue el aviso de inicio de sesión o autorización de Cursor. Calendaria abrirá su página de autorización, enviará tu magic link y pedirá que autorices al agente.

No pongas usuario, contraseña, magic link, token de Google ni cookie del dashboard de Calendaria en el mcp.json de Cursor.

App para ChatGPT

Calendaria está creando una app dedicada para usuarios de ChatGPT. Usa el flujo de la app de ChatGPT cuando esté disponible; usa la URL MCP remota de esta página para Claude, Cursor y otros clientes MCP compatibles con OAuth.

Claude y otros clientes

En Claude u otro cliente MCP compatible con OAuth, agrega Calendaria como servidor MCP remoto con esta URL:

https://api.calendaria.co/mcp

El cliente debería manejar el redireccionamiento OAuth, el inicio de sesión de Calendaria y la pantalla de autorización. Si tu cliente pregunta si confías o quieres habilitar el servidor, revisa la URL y continúa solo si es https://api.calendaria.co/mcp.

Qué pueden hacer los agentes

Con autorización, un agente AI puede usar herramientas de Calendaria para:

• inspeccionar calendarios y detalles de eventos
• encontrar tiempo libre, conflictos, links de reserva e invitaciones grupales
• preparar acciones para crear, mover, borrar, actualizar, responder RSVP, crear links de reserva o crear invitaciones grupales

Las herramientas de solo lectura pueden ejecutarse de inmediato. Las acciones que cambian el calendario se preparan como acciones pendientes y esperan tu confirmación explícita en Calendaria antes de cambiar un calendario.

Revocar acceso

Puedes revocar agentes AI conectados desde el dashboard de Calendaria. Revocar acceso sirve cuando dejas de usar un cliente, pierdes acceso a un dispositivo o quieres reconectar con una autorización nueva.

Resolución de problemas

Cursor sigue apareciendo conectado después de quitar la configuración

Quita la configuración, revoca el agente AI desde el dashboard de Calendaria y vuelve a conectar desde Cursor.

El cliente muestra herramientas antiguas o faltantes

Desconecta y reconecta Calendaria después de cambios en herramientas MCP o autorización. Así el cliente refresca los descriptores de herramientas y los tokens de autorización.

El cliente pide credenciales en la configuración

No agregues credenciales a mcp.json ni a ninguna configuración del cliente. Calendaria usa OAuth en el navegador e inicio de sesión con magic link durante el flujo de autorización.