Mcp Typebot

Qu'est-ce que MCP-typebot ?

MCP-typebot est un projet innovant hébergé sur GitHub, développé par l'utilisateur osdeibi. Ce dépôt est conçu pour faciliter la création et la gestion de chatbots en utilisant le cadre MCP (Multi-Channel Protocol). Le projet vise à simplifier le processus de construction de bots capables d'opérer sur diverses plateformes de messagerie, offrant aux utilisateurs un outil polyvalent pour améliorer la communication et l'automatisation.

Fonctionnalités de MCP-typebot

• Support Multi-Canal : MCP-typebot permet aux développeurs de créer des bots qui peuvent interagir avec les utilisateurs sur plusieurs plateformes de messagerie, garantissant une portée plus large et un meilleur engagement des utilisateurs.
• Interface Conviviale : Le projet est conçu en tenant compte de l'ergonomie, facilitant la création et la gestion de chatbots pour les développeurs de tous niveaux de compétence.
• Modèles Personnalisables : Les utilisateurs peuvent personnaliser leurs bots avec divers modèles, leur permettant d'adapter les réponses et les fonctionnalités du bot pour répondre à des besoins spécifiques.
• Open Source : Étant un dépôt public, MCP-typebot est ouvert aux contributions, permettant aux développeurs de collaborer et d'améliorer davantage le projet.

Comment utiliser MCP-typebot

1. Cloner le Dépôt : Commencez par cloner le dépôt MCP-typebot depuis GitHub sur votre machine locale en utilisant la commande :

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

2. Installer les Dépendances : Naviguez vers le répertoire du projet et installez les dépendances nécessaires. Cela peut généralement être fait en utilisant un gestionnaire de paquets comme npm ou yarn :

   cd MCP-typebot
   npm install
   

3. Configurer Votre Bot : Modifiez les fichiers de configuration pour définir les paramètres de votre bot, y compris les clés API, les modèles de réponse et les paramètres de canal.

4. Exécuter Votre Bot : Une fois tout configuré, vous pouvez démarrer votre bot en utilisant la commande :

   npm start
   

5. Tester et Déployer : Testez votre bot dans un environnement de développement avant de le déployer en production. Assurez-vous qu'il interagit correctement sur toutes les plateformes de messagerie prévues.

Questions Fréquemment Posées

Quels langages de programmation sont utilisés dans MCP-typebot ?

MCP-typebot utilise principalement JavaScript, tirant parti de Node.js pour la fonctionnalité côté serveur.

Puis-je contribuer au projet MCP-typebot ?

Oui ! En tant que projet open-source, les contributions sont les bienvenues. Vous pouvez forker le dépôt, apporter vos modifications et soumettre une demande de tirage pour révision.

Une documentation est-elle disponible pour MCP-typebot ?

Oui, une documentation détaillée est disponible dans le fichier README du dépôt et dans des fichiers markdown supplémentaires qui expliquent diverses fonctionnalités et instructions de configuration.

Comment puis-je signaler des problèmes ou des bogues ?

Vous pouvez signaler des problèmes en naviguant vers l'onglet "Issues" dans le dépôt GitHub de MCP-typebot et en soumettant un nouveau problème avec une description détaillée du problème.

MCP-typebot est-il adapté aux débutants ?

Absolument ! MCP-typebot est conçu pour être convivial, le rendant accessible aux développeurs de tous niveaux de compétence, y compris les débutants.

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.