MCP-Typebot

Integra la API REST de Typebot como herramientas invocables

GitHub
4
Prueba este MCPPatrocinado

Documentación

MCP-Typebot

Un pequeño servidor MCP que expone la API REST de Typebot como herramientas invocables en Claude Desktop (a través de STDIO). Puedes crear, listar, obtener, actualizar, eliminar, publicar/despublicar Typebots, listar resultados e iniciar chats—usando comandos en lenguaje natural.

Características

  • createBot
    Crea un nuevo Typebot en tu espacio de trabajo.
    Requerido: name
    Opcional: workspaceId, description

  • listBots
    Lista todos los Typebots en tu espacio de trabajo.
    Opcional: workspaceId

  • getBot
    Obtiene un Typebot por su ID.
    Requerido: botId

  • updateBot
    Actualiza parcialmente un Typebot existente (por ejemplo, renombrar).
    Requerido: botId, typebot (objeto con los campos a cambiar)
    Opcional: overwrite

  • deleteBot
    Elimina un Typebot por su ID.
    Requerido: botId

  • publishBot / unpublishBot
    Alterna el estado de publicación de un Typebot.
    Requerido: botId

  • listResults
    Recupera los resultados de conversación de un Typebot.
    Requerido: botId
    Opcional: limit, cursor, timeFilter, timeZone

  • startChat
    Inicia una nueva sesión de chat con un Typebot.
    Requerido: botId
    Opcional: chat.context

Requisitos previos

  1. Node.js 18+
  2. Un token de API de Typebot válido y un ID de espacio de trabajo
  3. Claude Desktop conectado a tu servidor MCP local

Instalación

git clone <repo-url>
cd mcp-typebot
npm install
npm run build

También puedes instalar el paquete publicado directamente vía npm:

npm install mcp-typebot
npm start

Ejecución

npm start

Esto inicia el servidor MCP en STDIO. Claude Desktop (o cualquier cliente MCP) se conectará automáticamente.

Uso en Claude Desktop

Simplemente escribe comandos naturales como:

Usuario: "Créame un nuevo typebot"
Claude: "Claro—¿qué nombre?"
Usuario: "MyDemoBot"
Claude (invoca internamente):

@createBot {"name":"MyDemoBot"}

O, explícitamente:

@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}

También puedes iniciar un chat:

@startChat {"botId":"<your_bot_id>"}

Extensión

  • Agrega nuevas herramientas implementándolas en src/tools/bots.ts y registrándolas en src/index.ts.
  • Define un esquema Zod para cada herramienta para obtener indicaciones y validación automáticas.

Licencia

Configuración de Claude Desktop

Para conectar Claude Desktop a este servidor MCP, agrega lo siguiente a tu configuración de Claude (por ejemplo, claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-typebot": {
      "command": "node",
      "args": [
        "path/to/project/dist/index.js"
      ],
      "env": {
        "TYPEBOT_TOKEN": "YOUR_TOKEN_HERE",
        "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
      }
    }
  }
}

Asegúrate de que command y args apunten a tu index.js compilado localmente, y que tus valores de .env coincidan con los de env.