Mcp Typebot

¿Qué es MCP-typebot?

MCP-typebot es un proyecto innovador alojado en GitHub, desarrollado por el usuario osdeibi. Este repositorio está diseñado para facilitar la creación y gestión de chatbots utilizando el marco MCP (Protocolo Multi-Canal). El proyecto tiene como objetivo simplificar el proceso de construcción de bots que pueden operar en varias plataformas de mensajería, proporcionando a los usuarios una herramienta versátil para mejorar la comunicación y la automatización.

Características de MCP-typebot

• Soporte Multi-Canal: MCP-typebot permite a los desarrolladores crear bots que pueden interactuar con los usuarios en múltiples plataformas de mensajería, asegurando un mayor alcance y mejor participación del usuario.
• Interfaz Amigable: El proyecto está diseñado con la usabilidad en mente, facilitando a los desarrolladores de todos los niveles de habilidad la creación y gestión de sus chatbots.
• Plantillas Personalizables: Los usuarios pueden personalizar sus bots con varias plantillas, lo que les permite adaptar las respuestas y funcionalidades del bot para satisfacer necesidades específicas.
• Código Abierto: Al ser un repositorio público, MCP-typebot está abierto a contribuciones, permitiendo a los desarrolladores colaborar y mejorar aún más el proyecto.

Cómo Usar MCP-typebot

1. Clona el Repositorio: Comienza clonando el repositorio de MCP-typebot desde GitHub a tu máquina local usando el comando:

   git clone https://github.com/osdeibi/MCP-typebot.git
   

2. Instala Dependencias: Navega al directorio del proyecto e instala las dependencias necesarias. Esto se puede hacer típicamente usando un gestor de paquetes como npm o yarn:

   cd MCP-typebot
   npm install
   

3. Configura Tu Bot: Modifica los archivos de configuración para establecer los parámetros de tu bot, incluyendo claves API, plantillas de respuesta y configuraciones de canal.

4. Ejecuta Tu Bot: Una vez que todo esté configurado, puedes iniciar tu bot usando el comando:

   npm start
   

5. Prueba y Despliega: Prueba tu bot en un entorno de desarrollo antes de desplegarlo en producción. Asegúrate de que interactúe correctamente en todas las plataformas de mensajería previstas.

Preguntas Frecuentes

¿Qué lenguajes de programación se utilizan en MCP-typebot?

MCP-typebot utiliza principalmente JavaScript, aprovechando Node.js para la funcionalidad del lado del servidor.

¿Puedo contribuir al proyecto MCP-typebot?

¡Sí! Como proyecto de código abierto, se aceptan contribuciones. Puedes bifurcar el repositorio, hacer tus cambios y enviar una solicitud de extracción para revisión.

¿Hay documentación disponible para MCP-typebot?

Sí, hay documentación detallada disponible en el archivo README del repositorio y en archivos markdown adicionales que explican varias funcionalidades e instrucciones de configuración.

¿Cómo puedo reportar problemas o errores?

Puedes reportar problemas navegando a la pestaña "Issues" en el repositorio de GitHub de MCP-typebot y enviando un nuevo problema con una descripción detallada del problema.

¿Es MCP-typebot adecuado para principiantes?

¡Absolutamente! MCP-typebot está diseñado para ser amigable con el usuario, lo que lo hace accesible para desarrolladores de todos los niveles de habilidad, incluidos los principiantes.

MCP-Typebot

A small MCP server that exposes Typebot’s REST API as callable tools in Claude Desktop (via STDIO). You can create, list, get, update, delete, publish/unpublish Typebots, list results, and start chats—using natural-language commands.

Features

• createBot
  Create a new Typebot in your workspace.
  Required: name
  Optional: workspaceId, description

• listBots
  List all Typebots in your workspace.
  Optional: workspaceId

• getBot
  Fetch a Typebot by its ID.
  Required: botId

• updateBot
  Patch an existing Typebot (e.g. rename).
  Required: botId, typebot (object with fields to change)
  Optional: overwrite

• deleteBot
  Delete a Typebot by its ID.
  Required: botId

• publishBot / unpublishBot
  Toggle a Typebot’s published state.
  Required: botId

• listResults
  Retrieve conversation results for a Typebot.
  Required: botId
  Optional: limit, cursor, timeFilter, timeZone

• startChat
  Begin a new chat session with a Typebot.
  Required: botId
  Optional: chat.context

Prerequisites

1. Node.js 18+
2. A valid Typebot API token and workspace ID
3. Claude Desktop connected to your local MCP server

Installation

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

You can also install the published package directly via npm:

npm install mcp-typebot
npm start

Running

npm start

This starts the MCP server on STDIO. Claude Desktop (or any MCP client) will connect to it automatically.

Usage in Claude Desktop

Simply write natural commands like:

User: “Create me a new typebot”
Claude: “Sure—what name?”
User: “MyDemoBot”
Claude (internally invokes):

@createBot {"name":"MyDemoBot"}

Or, explicitly:

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

You can also start a chat:

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

Extending

• Add new tools by implementing them in src/tools/bots.ts and registering them in src/index.ts.
• Define a Zod schema for each tool to get automatic prompting and validation.

License

Configuring Claude Desktop

To connect Claude Desktop to this MCP server, add the following to your Claude configuration (e.g. 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"
      }
    }
  }
}

Make sure the command and args point to your local built index.js, and that your .env values match those in env.