Typebot Mcp Server

MCP-Typebot

Typebot の REST API を、Claude Desktop で呼び出し可能なツールとして公開する小規模な MCP サーバーです（STDIO 経由）。 自然言語コマンドを使って、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

---

前提条件

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

---

インストール

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

---

公開済みパッケージを npm から直接インストールすることもできます：

npm install mcp-typebot
npm start

---

実行

npm start

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

---

Claude Desktop での使用方法

次のような自然言語のコマンドを入力するだけです：

ユーザー：「新しい typebot を作成して」
Claude：「もちろんです。名前を教えてください」
ユーザー：「MyDemoBot」
Claude（内部で呼び出し）：

@createBot {"name":"MyDemoBot"}

または、明示的に指定します：

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

チャットを開始することもできます：

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

---

拡張

• src/tools/bots.ts に実装し、src/index.ts に登録することで、新しいツールを追加できます。
• 各ツールに Zod スキーマを定義すると、プロンプトと検証を自動化できます。

---

ライセンス

---

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 の値と一致していることを確認してください。