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）
トランスポート: Streamable HTTP（text/event-stream または application/json）
サーバープロトコルリビジョン: 2025-03-26
サーバーURL: https://api.muntuai.com/api/mcp

Related MCP server: KeyID Agent Kit

クイックスタート

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

app.muntuai.com にログインし、Settings → Agent Keys に移動してキーを作成します。エージェントのニーズに合った自律レベルを選択してください:

生のキーは一度だけ表示されます: 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

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

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

ツール（全30）

ドメインごとにグループ化されています — 完全なインデックスは tools/README.md を参照してください。

• Campaigns — 作成、起動、一時停止、再開、監視、下書きレビュー、送信

• Leads — 配列または CSV URL からのインポート、エンリッチ、サンプリング

• Senders — 作成、削除、ヘルスチェック、キャンペーンへの割り当て

• Domains — 追加、検証、ステータス確認

• Email generation — プレビュー、改善、キャンペーンガイドの生成

• Webhooks — ワークスペースイベントへの登録

• Meta — エージェントキー情報の取得

リポジトリ構成

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 と events リソースを通じてこのライフサイクルを監視できます。workflows/monitor-campaign.md を参照してください。

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

サポート

• ドキュメントに関する問題: このリポジトリで issue を開いてください

• プラットフォームサポート: support@muntuai.com

• ウェブサイト: muntuai.com