Mcp Typebot

Что такое MCP-typebot?

MCP-typebot — это инновационный проект, размещенный на GitHub, разработанный пользователем osdeibi. Этот репозиторий предназначен для упрощения создания и управления чат-ботами с использованием фреймворка MCP (Многоканальный Протокол). Проект нацелен на оптимизацию процесса создания ботов, которые могут работать на различных платформах обмена сообщениями, предоставляя пользователям универсальный инструмент для улучшения коммуникации и автоматизации.

Особенности MCP-typebot

• Поддержка нескольких каналов: MCP-typebot позволяет разработчикам создавать ботов, которые могут взаимодействовать с пользователями на нескольких платформах обмена сообщениями, обеспечивая более широкий охват и лучшее взаимодействие с пользователями.
• Удобный интерфейс: Проект разработан с учетом удобства использования, что упрощает создание и управление чат-ботами для разработчиков любого уровня подготовки.
• Настраиваемые шаблоны: Пользователи могут настраивать своих ботов с помощью различных шаблонов, позволяя адаптировать ответы и функциональность бота под конкретные нужды.
• Открытый исходный код: Будучи публичным репозиторием, MCP-typebot открыт для вкладов, что позволяет разработчикам сотрудничать и дальше улучшать проект.

Как использовать MCP-typebot

1. Клонируйте репозиторий: Начните с клонирования репозитория MCP-typebot с GitHub на ваш локальный компьютер с помощью команды:

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

2. Установите зависимости: Перейдите в каталог проекта и установите необходимые зависимости. Это обычно можно сделать с помощью менеджера пакетов, такого как npm или yarn:

   cd MCP-typebot
   npm install
   

3. Настройте вашего бота: Измените конфигурационные файлы, чтобы установить параметры вашего бота, включая API-ключи, шаблоны ответов и настройки каналов.

4. Запустите вашего бота: После того как все настроено, вы можете запустить вашего бота с помощью команды:

   npm start
   

5. Тестируйте и развертывайте: Протестируйте вашего бота в среде разработки перед развертыванием в продуктивной среде. Убедитесь, что он правильно взаимодействует на всех целевых платформах обмена сообщениями.

Часто задаваемые вопросы

Какие языки программирования используются в MCP-typebot?

MCP-typebot в основном использует JavaScript, используя Node.js для серверной функциональности.

Могу ли я внести вклад в проект MCP-typebot?

Да! Как проект с открытым исходным кодом, вклады приветствуются. Вы можете сделать форк репозитория, внести изменения и отправить запрос на слияние для рассмотрения.

Есть ли документация для MCP-typebot?

Да, подробная документация доступна в файле README репозитория и в дополнительных markdown-файлах, которые объясняют различные функции и инструкции по настройке.

Как я могу сообщить о проблемах или ошибках?

Вы можете сообщить о проблемах, перейдя на вкладку "Issues" в репозитории MCP-typebot на GitHub и отправив новую проблему с подробным описанием проблемы.

Подходит ли MCP-typebot для начинающих?

Абсолютно! MCP-typebot разработан так, чтобы быть удобным для пользователей, что делает его доступным для разработчиков любого уровня подготовки, включая начинающих.

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.