Conectar un asistente de IA a SuperSaaS

SuperSaaS ofrece un servidor MCP (Model Context Protocol) que permite a asistentes de IA como Claude o ChatGPT gestionar tu agenda en lenguaje natural: comprobar disponibilidad, crear y cambiar reservas, buscar usuarios y mucho más. El asistente tiene el mismo acceso que tu cuenta, es decir, acceso de administrador, así que trata los datos de conexión como una contraseña.

Lo que podrás hacer

Tras la configuración, puedes hacerle preguntas y peticiones a tu asistente de IA como:

• “¿Qué citas tengo mañana?”
• “Encuentra un hueco libre para una consulta de 30 minutos la semana que viene y resérvalo para juana@example.es”
• “¿Qué reservas han cambiado desde ayer?”
• “Crea un nuevo usuario con el nombre jaime@example.es y la contraseña ‘secreto’ y dale 20 € de crédito”

Elige tu asistente de IA

La mayoría de los asistentes de IA deberían conectarse con OAuth. Introduces la URL del servidor, inicias sesión en SuperSaaS desde tu navegador y apruebas el acceso.

• Asistentes de IA con OAuth: ChatGPT y Claude
• Otros asistentes de IA: Claude Code, Codex, Visual Studio Code y otros clientes MCP

ChatGPT

ChatGPT se conecta introduciendo la URL del servidor y aprobando la conexión en SuperSaaS. ChatGPT requiere un plan de pago (Plus, Pro o Business) para los conectores personalizados.

1. Ve a https://chatgpt.com para conectarte. Usa la versión web; la app móvil y la de escritorio de ChatGPT aún no tienen opción MCP, pero una vez conectado puedes usar las herramientas desde la app.
2. Abre Configuración > Apps, desplázate hasta Configuración avanzada y activa el Modo desarrollador.
3. De vuelta en Apps, elige Crear app, nómbrala “SuperSaaS” y en la conexión escribe “https://www.supersaas.es/mcp”.
4. En Autenticación, asegúrate de que OAuth está seleccionado, marca la casilla de confirmación y termina de crear el conector. Al conectarte, se abrirá una página de SuperSaaS en tu navegador; inicia sesión y haz clic en Aprobar para volver a ChatGPT con las herramientas disponibles.

Claude (aplicación de escritorio y web)

Claude se conecta a SuperSaaS como conector personalizado. Solo necesitas la URL del servidor; inicias sesión en SuperSaaS desde tu navegador y apruebas la conexión.

1. En Claude, abre Configuración > Conectores y haz clic en Agregar conector personalizado.
2. Escribe un nombre como “SuperSaaS” y pega la URL del servidor (https://www.supersaas.es/mcp), después haz clic en Agregar.
3. Haz clic en Conectar. Se abrirá una página de SuperSaaS en tu navegador; inicia sesión con tu nombre de cuenta y contraseña (si no has iniciado sesión ya) y haz clic en Aprobar.
4. Volverás a Claude, que ahora muestra las herramientas de SuperSaaS bajo el icono de herramientas en el cuadro de chat.

Configuración manual para clientes sin OAuth

Algunos clientes aún no admiten el flujo de inicio de sesión por navegador. Estos clientes necesitan la URL del servidor y un valor de autorización que empiece por Bearer …. Puedes encontrar ese valor haciendo clic en Conectar un asistente de IA, que abrirá tu página Datos de cuenta con una sección adicional. Haz clic en Mostrar para ver la clave API que puedes rellenar en Bearer ….

Claude Code (terminal)

Ejecuta este único comando, sustituyendo el marcador de posición por tu clave API:

claude mcp add supersaas --transport http https://www.supersaas.es/mcp \
  --header "Authorization: Bearer PEGA_TU_VALOR_AQUI"

Codex

La forma más sencilla es a través de la aplicación Codex:

1. Abre Configuración en Codex.
2. Ve a Servidores MCP y haz clic en Agregar.
3. Elige Servidor remoto/HTTP e introduce la URL del servidor “https://www.supersaas.es/mcp”.
4. Añade una cabecera HTTP llamada Authorization con la palabra Bearer y tu clave API.
5. Guarda el servidor e inicia un nuevo chat en Codex. Las herramientas de SuperSaaS deberían estar disponibles en ese chat.

Si prefieres el terminal o quieres configurar Codex manualmente, edita ~/.codex/config.toml (créalo si no existe) y añade:

[mcp_servers.supersaas]
url = "https://www.supersaas.es/mcp"
http_headers = { "Authorization" = "Bearer PEGA_TU_VALOR_AQUI" }

Reinicia Codex después; las herramientas de SuperSaaS aparecerán automáticamente. En el terminal puedes comprobar la conexión con codex mcp list, y dentro de Codex puedes usar /mcp para inspeccionar los servidores conectados.

Visual Studio Code (GitHub Copilot)

En VS Code, los servidores MCP son utilizados por el chat de GitHub Copilot en modo agente, por lo que se requiere una suscripción a Copilot (el nivel gratuito funciona).

1. Abre la paleta de comandos (Ctrl/Cmd + Shift + P) y ejecuta MCP: Agregar servidor.
2. Elige HTTP e introduce la URL del servidor “https://www.supersaas.es/mcp”.
3. Cuando se abra el archivo mcp.json, añade la entrada headers para que la definición del servidor quede así:

{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.es/mcp",
      "headers": {
        "Authorization": "Bearer PEGA_TU_VALOR_AQUI"
      }
    }
  }
}

4. Abre el panel de chat de Copilot, cambia el menú desplegable de modo a Agente y haz clic en el icono de herramientas para confirmar que las herramientas de SuperSaaS están listadas.

Otros clientes MCP (Cursor, Le Chat y más)

Cualquier cliente que admita servidores MCP remotos con cabeceras personalizadas funcionará. Donde el cliente pida los detalles del servidor, usa:

• Tipo / transporte: Streamable HTTP
• URL: la URL del servidor, “https://www.supersaas.es/mcp”
• Cabecera: Authorization con la palabra Bearer y tu clave API

{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.es/mcp",
      "headers": {
        "Authorization": "Bearer PEGA_TU_VALOR_AQUI"
      }
    }
  }
}