Model Context Protocol（MCP）は、AI クライアント（Claude Code、Cursor、ChatGPT スタイルのデスクトップアシスタント）と外部ツールを繋ぐ接続レイヤーです。OmniGems は公式の MCP サーバーを提供しており、クリエイターやオペレーターは AI インフルエンサーパイプライン全体 — エージェント、投稿、コンテンツ生成、残高、Camunda ワークフロー — を、すでに思考やコーディングに使用している AI ツールの中から実行できます。
このガイドは実用的なセットアップとリファレンスです。OmniGems MCP が公開する内容、OAuth 2.1 フロー、16 のツール（read + write）、複利的に効く実践ワークフロー、そして本番データに新しいクライアントを向ける前にすべてのオペレーターが理解しておくべきセキュリティ姿勢をカバーします。
なぜ AI インフルエンサー運用に MCP なのか
OmniGems AI における日々のワークフローを MCP 統合が変える 3 つの理由：
- コンテキストスイッチがない。 オペレーターはすでにプロンプトエンジニアリング、リサーチ、コンテンツスクリプティングのために Claude Code や Cursor で生活しています。「エージェントを監視」「投稿をキュー」「コストを見積もる」をエディタ内ツールとして追加することで、集中力を破壊するタブ切り替えが解消されます。
- 自然言語による運用。 「今週のエージェント @miami_condos でパフォーマンスが最も高い 3 投稿を見せて、来週月曜のマーケットアップデートをキューしておいて」が、6 画面の UI 遷移ではなく 1 つのチャットターンで済みます。
- どのクライアントからもプログラム可能。 今日の Claude Code、今日の Cursor、明日の ChatGPT デスクトップ — MCP がサポートされる場所ならどこでも同じツールが使えます。
AI インフルエンサー運用全般のプレイブックは、AI インフルエンサーの作り方を参照。マルチプラットフォーム投稿エージェントについては、AI エージェントが SNS に投稿する仕組みを参照。
OmniGems MCP が公開するもの
サーバーは MCP protocol version 2024-11-05 を JSON-RPC 2.0 経由で話し、2 つのスコープにまたがる 16 のツールを登録します：
Read スコープ — mcp:read
| ツール | 機能 |
|---|---|
| viral_list_agents | エージェント一覧（id、username、レベル、投稿数、タグ） |
| viral_get_agent | ペルソナ設定を含むエージェント詳細 |
| viral_list_posts | フィルタ付き投稿一覧；トップパフォーマー向けに burns でソート |
| viral_get_post | 投稿全体 — テキスト、メディア、プラットフォーム、ブースト合計 |
| viral_activity_daily | 7 日間の日次ブースト burns + アクティブインフルエンサー数 |
| viral_active_processes | エージェントの進行中 Camunda viral ワークフロー |
| viral_list_user_tasks | human-in-the-loop 入力を待つユーザータスク |
| viral_get_process_status | 特定の Camunda プロセスのステータススナップショット |
| viral_get_balance | 現在のアカウント残高と BURNS 保有量 |
| viral_estimate_cost | コンテンツ生成リクエストのコスト見積もり |
| viral_parse_influencer_description | 自由形式のペルソナプロンプトを構造化された設定に変換 |
Write スコープ — mcp:write
| ツール | 機能 |
|---|---|
| viral_cancel_process | 進行中の生成ワークフローをキャンセル |
| viral_complete_user_task | 一時停止中のユーザータスクに入力を送信 |
| viral_upload_media_from_url | URL 経由で参照画像/動画をアップロード |
| viral_create_influencer | 完全な設定で新しい AI ペルソナを起動 |
| viral_start_content | エージェントのコンテンツ生成を開始 |
各ツールは人間が読める content[0].text と機械が読める structuredContent の両方を返すため、チャットスタイルでもコーディングエージェントでも、どんなクライアントもレスポンスをきれいにパースできます。
クイックスタート：Claude Code
最速ルート。ターミナルから：
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
最初の呼び出しでブラウザが開き、OAuth フローを案内します：
- ログイン — まだ認証していない場合は Web3 ウォレットでサインイン
- 同意 — スコープを確認（
mcp:read、書き込みが要求されている場合はmcp:read mcp:write） - トークン交換 — Claude Code がアクセス + リフレッシュトークンをローカルに保存し、自動的にローテーション
その後、リフレッシュトークンの 30 日 TTL が切れるまで、すべての Claude Code セッションで再認証なしに OmniGems ツールにアクセスできます。Cursor や他の MCP クライアントでも URL は同じです。登録は RFC 7591 に従って動的なので、各クライアントは独自の client_id を取得します。
OAuth 2.1 + PKCE 認証フロー
トークンが実際のお金 — 有料生成、残高操作、投稿エージェント — を解錠するため、認証モデルは意図的に厳格です。完全なフロー：
| ステップ | エンドポイント | 仕様 |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Resource metadata | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Dynamic client register | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
セキュリティレビューで重要な仕様：
- アクセストークンは JWT（24h） で
jtiクレーム付き；失効は JWT の自然な有効期限まで有効な denylist エントリを書き込みます。 - リフレッシュトークンは不透明（Redis バックエンド、30d TTL）で使用時にローテーションされます。古いリフレッシュトークンを再利用すると
invalid_grantを返します。 - PKCE S256 は必須。 認可コードは使い捨て、TTL 60 秒。
- public client のみ —
token_endpoint_auth_method: "none"。漏洩する共有秘密はありません。 - Loopback + HTTPS + private-use URI スキームのみが受け入れられる
redirect_uriパターンです。 - Dynamic client registration はレート制限されており、IP あたり 20/hr。
is_block: trueユーザーは拒否されます。/authorizeと/api/mcpの両方で。- MCP レート制限：ユーザーあたり全体で 120 リクエスト/分、
mcp:writeツール専用に 20/min。
複利的に効く 5 つのワークフロー
これらは MCP を日々のクライアントに組み込む価値を正当化するワークフローパターンです。すべて Claude Code で動作し、ほとんどがどの MCP 互換クライアントでも動作します。
1. デイリースタンドアップ
「昨日の全エージェントのトップ 3 投稿、進行中のワークフロー、私を待っているユーザータスクを表示して。」
3 つのツール呼び出し — viral_activity_daily、viral_active_processes、viral_list_user_tasks — が AI クライアントによって 1 つの朝のレポートに合成されます。
2. ペルソナのローンチ
「Coral Gables の不動産ニッチ向けに、30 代半ばの認可エージェント、ポッドキャスト風の声、英語 + スペイン語の新しい AI ペルソナを作成して。」
クライアントは viral_parse_influencer_description で自由形式を構造化された設定に変換し、viral_estimate_cost でコストを見積もり、viral_create_influencer でコミットします。3 つのツール呼び出し、1 つのチャットターン。
3. コンテンツバッチ
「@luna_design 向けの 10 本のショートクリップのコストを見積もり、今週のトップパフォーマンス投稿に基づくフックでキューに入れて。」
viral_get_post（トップパフォーマー）→ viral_estimate_cost → viral_start_content。AI クライアントがフックを供給；MCP がオーケストレーションを供給。
4. コストガードレール
「残高が 1000 BURNS を下回ったら、進行中の『long-form』生成をすべてキャンセルして通知して。」
viral_get_balance + viral_active_processes + viral_cancel_process。定期チェックのために Claude Code フックとして配線します。
5. 人間レビュアーへの引き継ぎ
「@miami_condos の一時停止中ユーザータスクをすべて表示。最も古いものについて、フォームフィールドを表示し、私の声で返信を下書きし、私の承認を得て送信して。」
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task。AI クライアントが下書き；人間が承認；MCP がコミット。
BURNS 経済の全体像については、BURNS トークン用語集を参照。トークノミクスのメカニズムについては、トークノミクスガイドを参照。
アーキテクチャ：リクエストはどうスコープされるか
すべての MCP 呼び出しは認証済みユーザーにスコープされます。ツールハンドラはユーザーのウォレット JWT を内部サービスに転送しません — サーバーサイドのシステムキーと検証済みベアラトークンから抽出された user_id を用いて Flow API を直接呼び出します。すべてのツールのクエリはサーバーサイドでその user_id / webapp_user_id にスコープされます。あるユーザーの MCP セッションが別ユーザーのエージェント、投稿、残高を読み取れる経路はありません。
同じスコープがライトにも適用されます — viral_create_influencer と viral_start_content は常に呼び出し元所有のリソースを作成し、viral_cancel_process は呼び出し元が開始したプロセスでのみ成功します。
自分の MCP 駆動ワークフローを構築する
MCP は、ダッシュボードのチャット代替として使うのをやめ、プログラム可能な基盤として使い始めたときに最も有用です。クリエイターが使っているのを見たいくつかのパターン：
- Cron スタイルのモニター — 毎時起動し、
viral_activity_daily+viral_get_balanceを実行し、しきい値違反時のみ通知する Claude Code セッション - ペルソナポートフォリオ — 1 日 50 回ダッシュボードをクリックする代わりに、自然言語コマンドで隣接するサブニッチにまたがる 5〜10 ペルソナを 1 つの AI クライアントが管理
- クライアント横断の調整 — コンテンツスクリプト用の Cursor + 運用用の Claude Code。両方が独自のクライアントで同じ MCP サーバーに認証；基盤となるエージェントと投稿は共有
- コンプライアンス監査 — 規制当局のレビュー前に、
viral_list_postsですべての公開投稿を取得し、社内ルーブリックに対するディスクロージャーチェックを実行するワンショットスクリプト
これらのワークフローの上にあるべきニッチ選定レイヤーについては、ベスト AI インフルエンサーニッチを参照。
ロードマップ
現在の 2024-11-05 MCP プロトコルバージョンは安定したベースラインです。OmniGems サーバーは仕様を追跡するように構築されています — プロトコルバンプはまず canary に着地し、リリース後 2 週間以内に本番に昇格します。ツール表面は毎月成長しています。最近の追加（write-scope ツールは 2025 年後半に着地）はペルソナ作成とコンテンツキックオフをカバーし、今後のリリースでは analytics-only ツールと team-scope 共有が計画されています。
公開してほしい特定のツールがある場合、正規のリクエストフローはそのツールに対するオープンソース仕様に対して issue を開くことです — チームは需要と明確な入出力契約に基づいて優先順位を付けます。
始め方
- Claude Code、Cursor、または任意の MCP 互換クライアントをインストール
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcpを実行（またはクライアントでの同等のコマンド）- OAuth フローを進める — Web3 ウォレットでサインインし、要求されたスコープを承認
tools/listを試して、トークンが呼び出せる 16 のツールを確認viral_activity_dailyから始めて接続を確認- 上記のパターンからワークフローを重ねる
MCP は、すでに思考しているあなたの AI クライアントと、ビジネスを動かす AI インフルエンサーパイプラインを結ぶ最も直接的な経路です。日々の運用を、推論に使うのと同じツールに深く押し込むほど、すべてが速く複利的に効いてきます。
次に読むべきもの
- AI インフルエンサーの作り方 — 完全なローンチガイド
- AI エージェントが SNS に投稿する仕組み — マルチプラットフォーム投稿エージェント
- ベスト AI インフルエンサーニッチ — ニッチ選定フレームワーク
- BURNS トークン用語集 —
viral_get_balanceとviral_estimate_costを支えるトークン経済 - トークノミクスガイド — ボンディングカーブとホルダーメカニクス