Mcp Typebot

Cos'è MCP-typebot?

MCP-typebot è un progetto innovativo ospitato su GitHub, sviluppato dall'utente osdeibi. Questo repository è progettato per facilitare la creazione e la gestione di chatbot utilizzando il framework MCP (Multi-Channel Protocol). Il progetto mira a semplificare il processo di costruzione di bot che possono operare su varie piattaforme di messaggistica, fornendo agli utenti uno strumento versatile per migliorare la comunicazione e l'automazione.

Caratteristiche di MCP-typebot

• Supporto Multi-Channel: MCP-typebot consente agli sviluppatori di creare bot che possono interagire con gli utenti su più piattaforme di messaggistica, garantendo una maggiore portata e un migliore coinvolgimento degli utenti.
• Interfaccia Intuitiva: Il progetto è progettato tenendo presente l'usabilità, rendendo più facile per gli sviluppatori di tutti i livelli di abilità creare e gestire i propri chatbot.
• Modelli Personalizzabili: Gli utenti possono personalizzare i propri bot con vari modelli, consentendo loro di adattare le risposte e le funzionalità del bot per soddisfare esigenze specifiche.
• Open Source: Essendo un repository pubblico, MCP-typebot è aperto ai contributi, consentendo agli sviluppatori di collaborare e migliorare ulteriormente il progetto.

Come Usare MCP-typebot

1. Clona il Repository: Inizia clonando il repository MCP-typebot da GitHub sul tuo computer locale utilizzando il comando:

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

2. Installa le Dipendenze: Naviga nella directory del progetto e installa le dipendenze necessarie. Questo può essere fatto tipicamente utilizzando un gestore di pacchetti come npm o yarn:

   cd MCP-typebot
   npm install
   

3. Configura il Tuo Bot: Modifica i file di configurazione per impostare i parametri del tuo bot, inclusi le chiavi API, i modelli di risposta e le impostazioni dei canali.

4. Esegui il Tuo Bot: Una volta che tutto è impostato, puoi avviare il tuo bot utilizzando il comando:

   npm start
   

5. Testa e Distribuisci: Testa il tuo bot in un ambiente di sviluppo prima di distribuirlo in produzione. Assicurati che interagisca correttamente su tutte le piattaforme di messaggistica previste.

Domande Frequenti

Quali linguaggi di programmazione sono utilizzati in MCP-typebot?

MCP-typebot utilizza principalmente JavaScript, sfruttando Node.js per la funzionalità lato server.

Posso contribuire al progetto MCP-typebot?

Sì! Essendo un progetto open-source, i contributi sono benvenuti. Puoi forkare il repository, apportare le tue modifiche e inviare una pull request per la revisione.

È disponibile documentazione per MCP-typebot?

Sì, è disponibile una documentazione dettagliata nel file README del repository e in ulteriori file markdown che spiegano varie funzionalità e istruzioni di configurazione.

Come posso segnalare problemi o bug?

Puoi segnalare problemi navigando nella scheda "Issues" nel repository GitHub di MCP-typebot e inviando un nuovo problema con una descrizione dettagliata del problema.

MCP-typebot è adatto ai principianti?

Assolutamente! MCP-typebot è progettato per essere intuitivo, rendendolo accessibile per sviluppatori di tutti i livelli di abilità, compresi i principianti.

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.