MCP Typebot

🚀 MCP-Typebot

この小規模なMCPサーバーは、TypebotのREST APIをClaude Desktop（STDIO経由）で呼び出し可能なツールとして公開します。自然言語のコマンドを使用して、Typebotの作成、一覧表示、取得、更新、削除、公開/非公開の切り替え、結果の一覧表示、チャットの開始などを行うことができます。

🚀 クイックスタート

このMCPサーバーを使用することで、Claude Desktop上で自然言語コマンドを用いてTypebotを操作できます。以下の手順に沿ってセットアップしてください。

✨ 主な機能

• createBot
  ワークスペースに新しいTypebotを作成します。
  必須: name
  オプション: workspaceId, description

• listBots
  ワークスペース内のすべてのTypebotを一覧表示します。
  オプション: workspaceId

• getBot
  IDでTypebotを取得します。
  必須: botId

• updateBot
  既存のTypebotを更新します（例: 名前の変更）。
  必須: botId, typebot (変更するフィールドを持つオブジェクト)
  オプション: overwrite

• deleteBot
  IDでTypebotを削除します。
  必須: botId

• publishBot / unpublishBot
  Typebotの公開状態を切り替えます。
  必須: botId

• listResults
  Typebotの会話結果を取得します。
  必須: botId
  オプション: limit, cursor, timeFilter, timeZone

• startChat
  Typebotとの新しいチャットセッションを開始します。
  必須: botId
  オプション: chat.context

📦 インストール

リポジトリからのインストール

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

npm経由の直接インストール

npm install mcp-typebot
npm start

💻 使用例

基本的な使用法

Claude Desktopでの使用例を以下に示します。

自然言語でのコマンド例:

> **ユーザー**: “Create me a new typebot”  
> **Claude**: “Sure—what name?”  
> **ユーザー**: “MyDemoBot”  
> **Claude** (内部的に呼び出し):
> ```
> @createBot {"name":"MyDemoBot"}
> ```

明示的なコマンド例:

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

チャットの開始例:

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

🔧 技術詳細

前提条件

1. Node.js 18+
2. 有効な Typebot APIトークン と ワークスペースID
3. ローカルのMCPサーバーに接続されたClaude Desktop

実行方法

npm start

これにより、STDIO上でMCPサーバーが起動します。Claude Desktop（または他のMCPクライアント）は自動的に接続します。

Claude Desktopの設定

Claude DesktopをこのMCPサーバーに接続するには、Claudeの設定ファイル（例: 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"
      }
    }
  }
}

command と args がローカルでビルドされた index.js を指していること、および .env の値が env の値と一致していることを確認してください。

拡張方法

• 新しいツールを追加するには、src/tools/bots.ts で実装し、src/index.ts で登録してください。
• 各ツールにZodスキーマを定義することで、自動的なプロンプトとバリデーションを取得できます。