Soporte
Documentación

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.com”
  • “¿Qué reservas han cambiado desde ayer?”
  • “Crea un nuevo usuario con el nombre jaime@example.com y la contraseña ‘secreto’ y dale 20 € de crédito”
La mayoría de los asistentes pedirán confirmación antes de realizar cambios importantes, pero recuerda que la conexión actúa con tus permisos de administrador.

¿Vienes de otro sistema de reservas? Las citas existentes no se pueden importar con la importación CSV habitual, que solo admite usuarios, pero un asistente de IA puede hacerlo por ti. Exporta las citas de tu sistema anterior, entrega el archivo a tu asistente y pídele que cree las reservas en la agenda de SuperSaaS correspondiente. Prueba primero con un lote pequeño y revisa el resultado antes de dejar que importe el resto.

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.

Para los asistentes de IA con OAuth, usa esta URL del servidor: https://www.supersaas.es/mcp

ChatGPT (versión web)

ChatGPT se conecta introduciendo la URL del servidor y aprobando la conexión en SuperSaaS. La conexión se añade como plugin personal. La disponibilidad del modo desarrollador depende de tu cuenta y de la política de tu espacio de trabajo. Los pasos siguientes usan los nombres en inglés de los botones y menús.

  1. Ve a https://chatgpt.com para conectarte.
  2. Abre Settings > Security and login y activa el Developer mode.
  3. Abre Plugins y elige Create app. En el formulario New Plugin, nómbralo “SuperSaaS” y escribe “https://www.supersaas.es/mcp” en MCP Server URL. La descripción es opcional.
  4. Deja Authentication en OAuth, lee el aviso, marca I understand and want to continue y haz clic en Create. Al conectarte, se abrirá una página de SuperSaaS en tu navegador; inicia sesión y haz clic en Aprobar para volver a ChatGPT.
  5. Busca SuperSaaS entre tus plugins personales, ábrelo y pulsa el botón de más para instalarlo.
  6. Vuelve a la página de inicio de ChatGPT, cambia de Chat a Work e inicia un nuevo chat. Escribe @ en el cuadro de mensaje y selecciona SuperSaaS para usar sus herramientas.

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 Personalizar > Conectores (el icono de la caja de herramientas en la parte inferior de la barra lateral), haz clic en el botón + y elige 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. Activa el conector para una conversación haciendo clic en el botón + del cuadro de chat (o escribiendo /), pasando el cursor sobre Conectores y activando SuperSaaS. Las herramientas de SuperSaaS quedan entonces disponibles en ese chat.

En un plan Team o Enterprise, el conector lo añade el propietario del espacio de trabajo en Configuración de la organización > Conectores; el resto de miembros solo tiene que hacer clic en Conectar e iniciar sesión en SuperSaaS. Una cuenta gratuita de Claude puede tener un conector personalizado, los planes de pago permiten varios. Una vez añadido el conector en la versión web o en la aplicación de escritorio, también funciona en las aplicaciones de Claude para iOS y Android.

Configuración manual con un valor de autorización

Si tu cliente no admite OAuth, o si prefieres la configuración manual, usa 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 con una sección adicional. Haz clic en Mostrar para ver la clave API que puedes rellenar en Bearer ….

Si más adelante haces clic en Regenerar, la clave API cambia y cualquier asistente de IA conectado que lo use dejará de funcionar hasta que lo actualices con el nuevo valor.

Claude Code (terminal, aplicación de escritorio e IDE)

Claude Code también admite OAuth, así que no necesitas ninguna clave API. Añade el servidor con este comando:

claude mcp add --transport http supersaas https://www.supersaas.es/mcp

Después escribe /mcp dentro de Claude Code, selecciona SuperSaaS y sigue los pasos en tu navegador para iniciar sesión y aprobar el acceso. Claude Code guarda el token y lo renueva automáticamente. El mismo comando funciona en el terminal, en la aplicación de escritorio de Claude Code y en las extensiones para Visual Studio Code y JetBrains.

Si prefieres usar la clave API de la sección de configuración manual anterior, pásala como cabecera:

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

Aplicación de escritorio de ChatGPT y Codex

La aplicación de escritorio de ChatGPT permite configurar MCP directamente, incluido el inicio de sesión con OAuth. Codex es el nombre del entorno de programación y del cliente para el terminal. Para conectarte desde la aplicación de escritorio, con los nombres en inglés de los botones y menús:

  1. Cambia a Codex en la aplicación de escritorio de ChatGPT y abre Settings.
  2. Ve a Plugins, abre el menú Add y elige Add MCP server. Si tu versión tiene una sección MCP servers separada en la configuración, abre esa sección y haz clic en Add server.
  3. Nombra el servidor SuperSaaS, elige Streamable HTTP e introduce https://www.supersaas.es/mcp.
  4. Guarda el servidor y selecciona Restart.
  5. Abre la pestaña MCPs en Settings > Plugins y selecciona Authenticate para SuperSaaS. Inicia sesión en SuperSaaS desde tu navegador y haz clic en Aprobar.
  6. Inicia un nuevo chat local en Codex y usa /mcp para comprobar que el servidor de SuperSaaS está conectado.

La aplicación de escritorio, el cliente Codex para el terminal y la extensión para IDE comparten la configuración MCP en el mismo ordenador. Como alternativa a OAuth, puedes usar la clave API de la sección de configuración manual anterior. 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"
      }
    }
  }
}
  1. 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
Para los clientes configurados con un archivo JSON (como el mcp.json de Cursor), el equivalente es:
{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.es/mcp",
      "headers": {
        "Authorization": "Bearer PEGA_TU_VALOR_AQUI"
      }
    }
  }
}