Muntuai Mcp

MuntuAI MCP

このリポジトリには、稼働中の MuntuAI MCP サーバーの公開ドキュメント、マニフェスト、リファレンスクライアントが含まれています。実行可能なサーバーの実装は、Muntu のメインバックエンドにあります。

MuntuAI の公式 Model Context Protocol（MCP）サーバーです。AI エージェントが、メールアウトリーチキャンペーン、リード管理、ドメインインフラストラクチャ、リアルタイムのワークスペースイベントにプログラムからアクセスできるようにします。

---

このサーバーについて

MuntuAI は、AI ネイティブなメールアウトリーチプラットフォームです。この MCP サーバーを使うと、外部エージェント（Claude、Cursor、カスタムスクリプト）を MuntuAI ワークスペースに接続し、キャンペーンの作成、リードのインポート、ドメインの検証、メールの送信、Webhook イベントの購読などの操作を、HTTP 上の標準 MCP インターフェース経由で実行できます。

プロトコル： HTTP 上の Model Context Protocol（JSON-RPC 2.0）
トランスポート： ストリーミング可能な HTTP（text/event-stream または application/json）
サーバープロトコルのリビジョン： 2025-03-26
サーバー URL： https://api.muntuai.com/api/mcp

---

クイックスタート

1. エージェントキーを取得する

app.muntuai.com にログインし、Settings → Agent Keys に移動してキーを作成します。エージェントに必要な自律性レベルを選択してください。

レベル	実行できる操作
observer	キャンペーン、リード、ドメイン、送信者、イベントなど、あらゆる情報の読み取り
copilot	読み取りに加え、キャンペーン、ドメイン、送信者、リード、Webhook の作成と変更
autonomous	上記すべてに加え、一時停止、再開、削除

キーは mnt_<keyId>.<secret> の形式で一度だけ表示されます。すぐにコピーしてください。

2. クライアントを設定する

セキュリティに関する注意：エージェントキーの生の値は、環境変数またはシークレットマネージャーに保存してください。ソース管理にコミットしたり、共有ファイルに貼り付けたりしないでください。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Cursor（.cursor/mcp.json または Settings → MCP）：

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Python：

pip install requests
export MUNTU_AGENT_KEY="mnt_YOUR_KEY_HERE"
python clients/python/muntu_mcp_client.py list-campaigns

推奨：

export MUNTU_SESSION_ID="$(uuidgen)"

Muntu では、オプションの MUNTU_SESSION_ID を使ってリクエストを1つの論理 MCP セッションにまとめ、セッション単位の安全制御と予算管理を行います。

3. 最初の呼び出しを行う

接続したら、エージェントに次のように尋ねてください。

「MuntuAI ワークスペースのすべてのキャンペーンを一覧表示してください」

エージェントは muntu://campaigns/{workspaceId} に対して resources/read を呼び出し、キャンペーン一覧を返します。

または、Python CLI から：

python clients/python/muntu_mcp_client.py list-campaigns
python clients/python/muntu_mcp_client.py list-domains
python clients/python/muntu_mcp_client.py list-emails

---

エージェントができること

リソース（読み取り専用ビュー）

リソース	URI	説明
workspace	muntu://workspace/{id}	プロフィール、ポリシー、インフラストラクチャの件数
domains	muntu://domains/{id}?cursor=0&limit=50	DNS 情報と検証状態を含むすべてのドメイン
senders	muntu://senders/{id}?cursor=0&limit=50	ステータスを含むすべてのメールアカウント
campaigns	muntu://campaigns/{id}?cursor=0&limit=20	統合されたキャンペーン一覧
campaign-plans	muntu://campaign-plans/{id}?cursor=0&limit=20	下書きのレビューキュー
events	muntu://events/{id}?cursor=0	最近のシステムイベント（フィルタリング可能）

ツール（全30個）

ドメイン別に分類されています。完全な一覧は tools/README.md を参照してください。

• キャンペーン — 作成、開始、一時停止、再開、監視、下書きのレビュー、送信
• リード — 配列または CSV URL からインポート、情報の補完、サンプル取得
• 送信者 — 作成、削除、ヘルスチェック、キャンペーンへの割り当て
• ドメイン — 追加、検証、ステータスの確認
• メール生成 — プレビュー、調整、キャンペーンガイドの生成
• Webhook — ワークスペースイベントの購読
• メタ — エージェントキー情報の取得

---

リポジトリ構成

muntuai-mcp/
├── README.md                    # This file
├── QUICKSTART.md                # 5-minute setup guide
├── docs/
│   ├── authentication.md        # Token format, headers, rate limits
│   ├── autonomy-levels.md       # Permission model
│   ├── resources.md             # All 6 resources with schemas
│   ├── events.md                # All event types and payloads
│   ├── webhooks.md              # Register, sign, verify
│   └── errors.md                # Error codes and handling
├── tools/
│   ├── README.md                # Full tool index
│   ├── campaigns.md
│   ├── leads.md
│   ├── senders.md
│   ├── domains.md
│   ├── email-generation.md
│   └── meta.md
├── workflows/
│   ├── README.md                # What workflows are
│   ├── launch-first-campaign.md
│   ├── review-and-send-drafts.md
│   ├── domain-setup.md
│   └── monitor-campaign.md
├── reference/
│   ├── event-types.md
│   ├── resource-schemas.md
│   └── tool-schemas.md
├── clients/
│   └── python/
│       ├── muntu_mcp_client.py  # Reference Python client
│       ├── README.md
│       └── examples/
├── agent-guides/
│   ├── for-claude.md
│   ├── for-cursor.md
│   └── decision-guide.md
└── .well-known/
    └── mcp-manifest.json        # Machine-readable capabilities manifest

---

主な概念

ワークスペース — MuntuAI のすべてのデータはワークスペースごとに管理されます。エージェントキーは 1 つのワークスペースに紐づけられ、そのワークスペース内のデータにのみアクセスできます。

自律性レベル — すべてのツールには最低限必要なレベルが設定されています。キーのレベルが要件を満たしていない場合、呼び出しは拒否され、その試行がログに記録されます。詳細は docs/autonomy-levels.md を参照してください。

キャンペーンのライフサイクル — uploaded → enriching → drafting → sending → completed。エージェントは get_campaign_performance とイベントリソースを通じて、このライフサイクルを確認できます。詳細は workflows/monitor-campaign.md を参照してください。

ドメインの検証 — メールプロバイダーを使用して送信する前に、ドメインを検証する必要があります。これには、DNS レコードの公開と検証の開始が含まれます。詳細は workflows/domain-setup.md を参照してください。

---

サポート

• ドキュメントに関する問題： このリポジトリで issue を作成してください
• プラットフォームのサポート： [email protected]
• ウェブサイト： muntuai.com