Magpipe

magpipe-mcp-server

Magpipe 用 MCP サーバーです。Claude Code や Cursor などの AI コーディングツールから、エージェント、通話、SMS、連絡先、電話番号を管理できます。

インストール

npm install -g magpipe-mcp-server

または、npx で直接実行します。

npx magpipe-mcp-server

セットアップ

1. API キーを取得する

magpipe.ai/settings に移動し、API タブ → Generate New Key を選択します。

2. AI ツールを設定する

Claude Code

~/.claude.json に追加します。

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

環境変数

変数	必須	説明
MAGPIPE_API_KEY	はい	mgp_ で始まる API キー
MAGPIPE_API_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.magpipe.ai/functions/v1）

利用可能なツール

エージェント

• list_agents — オプションのフィルターを指定して、すべてのエージェントを一覧表示します
• get_agent — 割り当てられた電話番号、カスタム関数、ナレッジソース、動的変数など、エージェントの詳細を取得します
• create_agent — 新しいエージェントを作成します
• update_agent — エージェントの設定を更新します
• delete_agent — エージェントを削除します

通話

• list_calls — フィルターを指定して、通話記録を一覧表示します
• get_call — 通話の詳細、文字起こし、要約を取得します
• initiate_call — 発信します
• terminate_call — 通話を終了します
• get_recording — 署名付き録音 URL を取得します

メッセージ

• list_messages — SMS メッセージを一覧表示します
• get_message — 1 件のメッセージを取得します
• send_sms — SMS を送信します

電話番号

• list_phone_numbers — 割り当て済みの電話番号を一覧表示します
• search_phone_numbers — 購入可能な電話番号を検索します
• provision_phone_number — 電話番号を購入します
• release_phone_number — 電話番号を解放します

連絡先

• list_contacts — 検索やフィルターを指定して、連絡先を一覧表示します
• get_contact — 連絡先の詳細を取得します
• create_contact — 連絡先を作成します
• update_contact — 連絡先を更新します
• delete_contact — 連絡先を削除します

ナレッジベース

• list_knowledge_sources — エージェントのナレッジソースを一覧表示します
• add_knowledge_source — URL ベースのナレッジを追加します
• add_knowledge_manual — 手動でテキストのナレッジを追加します
• delete_knowledge_source — ナレッジソースを削除します
• sync_knowledge_source — URL ソースを再クロールします

音声

• list_voices — 利用可能な音声を一覧表示します
• delete_voice — クローンした音声を削除します

カレンダー

• get_calendar_slots — 予約可能な時間枠を取得します
• create_booking — 予約を作成します
• cancel_booking — 予約をキャンセルします

API キー

• manage_api_keys — API キーの生成、一覧表示、取り消し、更新を行います

その他

• list_models — 利用可能な LLM モデルを一覧表示します
• chat_with_agent — エージェントにテキストメッセージを送信します
• list_chat_sessions — チャットセッションを一覧表示します
• list_custom_functions — カスタム関数を一覧表示します
• create_custom_function — カスタム関数を作成します
• manage_dynamic_variables — データ抽出用の変数を管理します
• list_scheduled_actions — スケジュール済みアクションを一覧表示します

開発

cd packages/mcp-server
npm install
npm run build
MAGPIPE_API_KEY=mgp_xxx node dist/index.js

ライセンス

MIT