MCP-Typebot

MCP-Typebot

Um pequeno servidor MCP que expõe a API REST do Typebot como ferramentas chamáveis no Claude Desktop (via STDIO). Você pode criar, listar, obter, atualizar, excluir, publicar/despublicar Typebots, listar resultados e iniciar chats—usando comandos em linguagem natural.

---

Recursos

• createBot
  Crie um novo Typebot no seu workspace.
  Obrigatório: name
  Opcional: workspaceId, description

• listBots
  Liste todos os Typebots do seu workspace.
  Opcional: workspaceId

• getBot
  Busque um Typebot pelo seu ID.
  Obrigatório: botId

• updateBot
  Atualize um Typebot existente (ex.: renomear).
  Obrigatório: botId, typebot (objeto com os campos a alterar)
  Opcional: overwrite

• deleteBot
  Exclua um Typebot pelo seu ID.
  Obrigatório: botId

• publishBot / unpublishBot
  Alterne o estado de publicação de um Typebot.
  Obrigatório: botId

• listResults
  Recupere os resultados de conversa de um Typebot.
  Obrigatório: botId
  Opcional: limit, cursor, timeFilter, timeZone

• startChat
  Inicie uma nova sessão de chat com um Typebot.
  Obrigatório: botId
  Opcional: chat.context

---

Pré-requisitos

1. Node.js 18+
2. Um token de API do Typebot e um ID de workspace válidos
3. Claude Desktop conectado ao seu servidor MCP local

---

Instalação

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

---

Você também pode instalar o pacote publicado diretamente via npm:

npm install mcp-typebot
npm start

---

Execução

npm start

Isso inicia o servidor MCP no STDIO. O Claude Desktop (ou qualquer cliente MCP) se conectará a ele automaticamente.

---

Uso no Claude Desktop

Basta escrever comandos naturais como:

Usuário: "Crie um novo typebot para mim"
Claude: "Claro—qual nome?"
Usuário: "MyDemoBot"
Claude (invoca internamente):

@createBot {"name":"MyDemoBot"}

Ou, explicitamente:

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

Você também pode iniciar um chat:

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

---

Extensão

• Adicione novas ferramentas implementando-as em src/tools/bots.ts e registrando-as em src/index.ts.
• Defina um esquema Zod para cada ferramenta para obter prompts e validação automáticos.

---

Licença

---

Configurando o Claude Desktop

Para conectar o Claude Desktop a este servidor MCP, adicione o seguinte à sua configuração do Claude (ex.: 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"
      }
    }
  }
}

Certifique-se de que command e args apontem para o seu index.js local compilado, e que seus valores de .env correspondam aos de env.