Mcp Typebot

O que é o MCP-typebot?

O MCP-typebot é um projeto inovador hospedado no GitHub, desenvolvido pelo usuário osdeibi. Este repositório foi projetado para facilitar a criação e gerenciamento de chatbots usando o framework MCP (Multi-Channel Protocol). O objetivo do projeto é simplificar o processo de construção de bots que podem operar em várias plataformas de mensagens, fornecendo aos usuários uma ferramenta versátil para aprimorar a comunicação e a automação.

Recursos do MCP-typebot

• Suporte Multi-Canal: O MCP-typebot permite que os desenvolvedores criem bots que podem interagir com os usuários em várias plataformas de mensagens, garantindo um alcance mais amplo e melhor engajamento do usuário.
• Interface Amigável: O projeto é projetado com a usabilidade em mente, facilitando para desenvolvedores de todos os níveis de habilidade a criação e gerenciamento de seus chatbots.
• Modelos Personalizáveis: Os usuários podem personalizar seus bots com vários modelos, permitindo que ajustem as respostas e funcionalidades do bot para atender a necessidades específicas.
• Código Aberto: Sendo um repositório público, o MCP-typebot está aberto a contribuições, permitindo que os desenvolvedores colaborem e aprimorem ainda mais o projeto.

Como Usar o MCP-typebot

1. Clone o Repositório: Comece clonando o repositório do MCP-typebot do GitHub para sua máquina local usando o comando:

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

2. Instale as Dependências: Navegue até o diretório do projeto e instale as dependências necessárias. Isso pode ser feito normalmente usando um gerenciador de pacotes como npm ou yarn:

   cd MCP-typebot
   npm install
   

3. Configure Seu Bot: Modifique os arquivos de configuração para definir os parâmetros do seu bot, incluindo chaves de API, modelos de resposta e configurações de canal.

4. Execute Seu Bot: Uma vez que tudo esteja configurado, você pode iniciar seu bot usando o comando:

   npm start
   

5. Teste e Implemente: Teste seu bot em um ambiente de desenvolvimento antes de implantá-lo em produção. Certifique-se de que ele interaja corretamente em todas as plataformas de mensagens pretendidas.

Perguntas Frequentes

Quais linguagens de programação são usadas no MCP-typebot?

O MCP-typebot utiliza principalmente JavaScript, aproveitando o Node.js para funcionalidade do lado do servidor.

Posso contribuir para o projeto MCP-typebot?

Sim! Como um projeto de código aberto, contribuições são bem-vindas. Você pode fazer um fork do repositório, fazer suas alterações e enviar um pull request para revisão.

Existe documentação disponível para o MCP-typebot?

Sim, documentação detalhada está disponível no arquivo README do repositório e em arquivos markdown adicionais que explicam várias funcionalidades e instruções de configuração.

Como posso relatar problemas ou bugs?

Você pode relatar problemas navegando até a aba "Issues" no repositório do MCP-typebot no GitHub e enviando um novo problema com uma descrição detalhada do problema.

O MCP-typebot é adequado para iniciantes?

Absolutamente! O MCP-typebot foi projetado para ser amigável, tornando-o acessível para desenvolvedores de todos os níveis de habilidade, incluindo iniciantes.

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.