Marvenn

Marvenn MCP サーバー

Marvenn MCP サーバー は、Marvenn の AI 搭載アウトリーチおよび CRM プラットフォームを、MCP 対応クライアント（Claude Desktop、Continue、Cursor など）に公開します。

AI アシスタントを Marvenn に接続すると、自然言語でキャンペーンの一覧表示、リードの確認、保留中のエージェント操作の管理などを行えます。

---

認証

API キーは、検出（tools/list、prompts/list、resources/list）には任意です。 ツールの実行（tools/call）には API キーが必要です。 キーは Bearer トークンとして渡してください：Authorization: Bearer <your-marvenn-api-key>

API キーにはスコープが設定されています。キーに付与されたスコープによって、利用できるツールが決まります。

スコープ	説明
read	キャンペーン、リード、操作、エージェントへの読み取り専用アクセス
write	read のすべてに加え、キャンペーンの作成および操作の承認／却下
admin	write のすべてに加え、ユーザー管理およびクレジット操作（Marvenn アカウントのロールが admin または super_admin であることも必要）

marvenn.ai のアカウント設定から、API キーを生成または管理できます。

---

トランスポート

トランスポート	URL	ステータス
Streamable HTTP（推奨）	https://marvenn.ai/mcp	動作中
SSE	https://marvenn.ai/mcp/sse	動作中

---

クイックスタート

Claude Desktop

claude_desktop_config.json（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "marvenn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://marvenn.ai/mcp/sse",
        "--header",
        "Authorization: Bearer <your-marvenn-api-key>"
      ]
    }
  }
}

Claude Desktop を再起動してください。ツールパネルに Marvenn のツールが表示されます。

curl

1 つ目のターミナルで SSE ストリームを開きます。

curl -N \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  https://marvenn.ai/mcp/sse

サーバーは、セッション固有のメッセージ URL を含む endpoint イベントを返します。例：

event: endpoint
data: https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345

2 つ目のターミナルで、そのエンドポイントに JSON-RPC メッセージを送信します。

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345"

結果は、開いている SSE ストリームを通じて返されます。

---

ツール

list_campaigns — Read スコープ

認証済みユーザーのすべてのキャンペーンを一覧表示します。キャンペーン名、ステータス、作成日、基本統計情報を返します。

パラメーター	型	必須	説明
status	string	いいえ	ステータスで絞り込みます：active、paused、completed、draft
limit	number	いいえ	返す結果の最大数（デフォルトは 20、最大 100）

---

get_campaign_stats — Read スコープ

特定のキャンペーンの詳細な分析情報とパフォーマンス統計を取得します。

パラメーター	型	必須	説明
campaign_id	number	はい	キャンペーンの数値 ID

---

create_campaign — Write スコープ

新しいアウトリーチキャンペーンを作成します。

パラメーター	型	必須	説明
name	string	はい	キャンペーン名（最大 200 文字）
type	string	はい	キャンペーンの種類：email、phone、social、multi_channel
targetAudience	string	いいえ	ターゲットオーディエンスの説明
objective	string	いいえ	キャンペーンの目的または目標

---

list_leads — Read スコープ

CRM のリードを、任意の絞り込みとページネーションを適用して一覧表示します。

パラメーター	型	必須	説明
status	string	いいえ	リードのステータスで絞り込みます：new、contacted、qualified、converted、lost
search	string	いいえ	名前、メールアドレス、または会社名に一致する検索語
limit	number	いいえ	ページあたりの結果の最大数（デフォルトは 20、最大 100）
page	number	いいえ	ページ番号（1 から開始、デフォルトは 1）

---

list_pending_actions — Read スコープ

承認待ちのすべての操作を一覧表示します。

パラメーター	型	必須	説明
limit	number	いいえ	返す結果の最大数（デフォルトは 20）

---

approve_action — 書き込みスコープ

人間による承認が必要な保留中のアクションを承認または拒否します。

パラメーター	型	必須	説明
action_id	number	はい	保留中のアクションの数値 ID
decision	string	はい	approve または reject
notes	string	いいえ	決定に関する任意のメモまたは理由

---

list_agents — 読み取りスコープ

認証済みユーザーのすべての AI エージェントを一覧表示します。

パラメーター	型	必須	説明
limit	number	いいえ	返す結果の最大数（デフォルトは 20）

---

list_users — 管理者スコープ

プラットフォーム上のすべてのユーザーを一覧表示します。admin スコープと管理者アカウントロールの両方が必要です。

パラメーター	型	必須	説明
limit	number	いいえ	返す結果の最大数（デフォルトは 50、最大 500）
subscriptionTier	string	いいえ	プランで絞り込みます：free、startup、team

---

manage_credits — 管理者スコープ

任意のユーザーのクレジット残高を確認または調整します。admin スコープと管理者アカウントロールの両方が必要です。

パラメーター	型	必須	説明
target_user_id	string	はい	クレジットを管理するユーザーの ID
action	string	はい	get、add、または subtract
amount	number	add／subtract の場合は必須	追加または差し引くクレジット数
reason	string	add／subtract の場合は必須	調整の理由

---

エラー処理

すべてのエラーは、次のコードを含む JSON-RPC エラーオブジェクトとして返されます。

コード	意味
-32600	無効な JSON-RPC リクエスト
-32601	メソッドまたはツールが見つかりません
-32602	無効な引数
-32603	内部サーバーエラー

スコープエラー（例：read 専用キーで create_campaign を呼び出した場合）は、JSON-RPC プロトコルエラーではなく、レスポンス本文の error フィールドを含むツールの結果として返されます。

---

リンク

• ウェブサイト：https://marvenn.ai
• MCP プロトコル：https://modelcontextprotocol.io