SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Qué es

El servidor MCP está en https://get-api.simplyboost.io/api/v1/mcp. Utiliza el transporte HTTP Streamable y el mismo token de API que la API REST (Authorization: Bearer sb_live_…), los mismos planes (Growth, Pro y Enterprise), los mismos permisos y los mismos límites. Cada herramienta hace lo mismo que el endpoint REST correspondiente y requiere el mismo ámbito; el asistente ve una herramienta que no puede usar como una denegación clara, no como un error.

No tiene estado: cada llamada es una solicitud y una respuesta, sin ninguna sesión que mantener, así que puedes conectarte desde cualquier máquina. El servidor nunca inicia una transmisión por su cuenta.

Conectar un cliente

Hay dos formas de conectarse. Iniciar sesión (OAuth): añade la dirección del servidor y, cuando el cliente lo solicite, apruébalo en una pestaña de SimplyBoost como propietario del equipo, eligiendo el equipo, los permisos y los chatbots. Así se conectan los conectores de claude.ai y ChatGPT, Cursor, Codex y Claude Code, sin tener que pegar nada. Un token: para un cliente que configures manualmente o un script propio, crea un token en Settings → API con solo los permisos que necesita el asistente y envíalo como encabezado.

Claude Code (inicia sesión cuando te lo solicite)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code y otros clientes con un mcp.json (inicia sesión cuando te lo soliciten)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Lo mismo, pero con un token en lugar de iniciar sesión

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Una conexión establecida al iniciar sesión dura 90 días, obtiene solo los permisos que el propietario dejó marcados (la eliminación está desactivada a menos que se marque) y aparece en Settings → API → Connected apps, donde el propietario puede desconectarla en cualquier momento. Solo el propietario de un equipo puede aprobar una conexión, igual que para crear un token. El nombre de la aplicación que aparece en la pantalla de aprobación es el que la aplicación declara sobre sí misma; SimplyBoost no lo verifica.

Un token en la configuración de un cliente es una contraseña de tu cuenta. Guárdalo en tu propio ordenador, asígnale una fecha de caducidad y renuévalo si se comparte el archivo de configuración. Iniciar sesión evita este problema: no se escribe ningún secreto en un archivo.

Para desarrolladores de clientes: el servidor sigue la especificación de autorización de MCP. Una solicitud sin credenciales responde 401 con un encabezado WWW-Authenticate que indica los metadatos del recurso protegido (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), donde se indica el servidor de autorización (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Los clientes se registran por sí mismos (Dynamic Client Registration), utilizan el flujo de código de autorización con PKCE (solo S256), pueden indicar el recurso y reciben tokens de actualización rotatorios. Los tokens de acceso duran una hora y solo funcionan en el endpoint MCP; los endpoints REST requieren tokens de API.

Las herramientas

Los argumentos y los resultados usan los mismos nombres que la API REST (chatbotId, threadId, campos camelCase), así que las páginas de los endpoints describen ambas. Empieza con list_chatbots para encontrar el id de un chatbot.

Herramienta	Requiere	Función
get_account	nada	La cuenta, el plan y los permisos del propio token.
get_usage	account:read	Mensajes utilizados en este período de facturación.
list_chatbots, get_chatbot	chatbots:read	Los chatbots que puede usar el token.
send_message	conversations:write	Pregunta a un chatbot como lo haría un visitante; cuenta para los mensajes del plan. Pasa threadId para continuar.
list_conversations, get_conversation, list_messages	conversations:read	Conversaciones de todos los canales y sus mensajes.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Gestiona una conversación como una persona: asígnatela, responde, devuélvela, resuélvela o vuelve a abrirla.
list_leads, get_lead	leads:read	Los leads captados por un chatbot.
update_lead	leads:write	Cambia los datos de un lead o márcalo como convertido.
delete_lead	leads:delete	Elimina un lead.
list_knowledge_sources, get_knowledge_source	knowledge:read	Lo que sabe un chatbot, con el estado y el texto de cada fuente.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Enseña al chatbot con texto o un sitio web, edita una fuente, vuelve a leer un sitio web.
delete_knowledge_source	knowledge:delete	Elimina una fuente.

Las cargas de archivos y los webhooks no se ofrecen como herramientas; para eso, usa los endpoints REST. Las herramientas de eliminación están marcadas como destructivas y las instrucciones del servidor indican al asistente que te pregunte primero.

Errores y límites

Una llamada a una herramienta rechazada (por falta de permisos, un chatbot que el token no puede ver, un argumento no válido o un límite del plan) se devuelve como un resultado de herramienta marcado como error, con el mismo code y el mensaje que devolvería la API REST, para que el asistente pueda indicarte qué debes cambiar. Un token ausente o no válido responde 401; un plan sin acceso a la API o una suscripción vencida, 403; y el límite de solicitudes por token, 429, exactamente igual que en la API REST.

Un mensaje que no sea JSON-RPC 2.0 genera un error JSON-RPC. GET y DELETE en el endpoint responden 405, porque no hay sesión ni transmisión del servidor.