MCP 経由で Trybe を Microsoft Copilot に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Trybe をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Trybe + Microsoft Copilot

ブランド向けの成果報酬型 UGC プラットフォーム Trybe に対応します。クリエイター名簿とサンプルの義務、クリエイターの成果（Meta、TikTok、AppLovin での報酬、GMV、広告費、購入数、ROAS）、クリエイターが投稿した動画を扱えます。投稿のレビューも含まれますが、インストール時はオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

TRYBE_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 2 分です。Brand API にアクセスできる Trybe のブランドアカウントと、ブランドの API キーが必要です。

1. API アクセスはブランドアカウントの機能です。すべての呼び出しが 403 feature_not_enabled を返す場合は、Trybe の担当者にブランドの Brand API を有効にするよう依頼してください。
2. Trybe のブランドポータルでブランドの API キーを作成するか、Trybe の担当者に発行してもらいます。キーは tk_live_ で始まります。TRYBE_API_KEY に貼り付けます。
3. コネクタをインストールし、trybe_list_creators を実行してキーを確認します。

キーは Authorization: Bearer tk_live_... として送信され、自社ブランドだけを参照できます。

読み取れるデータ: ブランドのアクティブなクリエイター（新しい順）と、ブランドでのサンプル状況（依頼済み、承認済み、履行済み、期限切れのサンプル、対応すべきサンプル、Sample Score）。sample_obligation=overdue で絞り込めば、動画を納品していないクリエイターがわかります。クリエイターごとのプログラムとコミッションルール（例: GMV の 10% と注文ごとの固定額）。期間ごとのクリエイターの成果（プログラム、最終アクティビティ、報酬、Trybe のコンバージョンと GMV、新規・稼働中の投稿、そのコンテンツを使った広告、広告費、購入数、購入金額、ROAS）。sort_by で並べ替えたり、1 人のクリエイター、1 つのプログラム、platforms で Meta、TikTok、AppLovin に絞り込んだりできます。クリエイターが投稿したコンテンツ（動画または画像）と、そのステータス（pending、approved、rejected、revision_requested）、クリエイター、プログラム、商品、アングル、文字起こし、累計の広告利用、サムネイル、ダウンロードリンク。status=pending でレビュー待ちの一覧を、query で特定の言葉を話している動画を探せます。

インストール時はオフ: trybe_approve_submission、trybe_reject_submission、trybe_request_submission_revision（クリエイターに変更点を伝える comment が必要）。クリエイターにはすぐに通知が届き、承認は報酬に影響するため、管理者が意図して有効にします。有効にした後も、AI は投稿とコメントを示し、あなたの承認を待ちます。

数値の読み方: 金額フィールドは _cents で終わり、米ドルのセント単位です（spend_cents 250000 は 2,500.00 USD）。日付は UTC の暦日 YYYY-MM-DD で、end_date に未来の日付は指定できません。日付を指定しない場合、成果は直近 30 日間（UTC で完了した日）が対象です。指標で並べ替えるか active_only=true を使うと、期間は最大 90 日になります。roas は購入金額を広告費で割った値で、広告費がない場合は null です。クリエイターの samples ブロックがすべてゼロならサンプルなし、null ならそのリクエストで読み取れなかったことを意味するため、AI はサンプルなしと判断せずに再試行します。

ID と広告: クリエイターは creator_<uuid>、プログラムは creator_program_<uuid>、投稿は submission_<uuid>、商品は product_<uuid>、グループは subgroup_<uuid> で、返された値をそのまま使います。投稿の trybe_id（末尾 8 文字）は、その投稿から作るすべての広告の遷移先 URL と広告名に含める必要があります。Trybe はこれで広告を紐づけ、クリエイターに報酬を支払います。

制限: リストは既定で 20 行、最大 100 行（limit）で、has_more が true の間は AI が after = next_cursor でページングします。API は 1 ウィンドウあたり 300 リクエストまでで、それを超えると 429 rate_limit_exceeded を返します。asset.url のダウンロードリンクは約 20 分で失効するため、AI は保存せずに毎回新しいリンクを取得します。

よくあるエラー: 401 invalid_api_key はキーがないか間違っています。403 feature_not_enabled は、ブランドで Brand API が有効になっていないことを意味します。400 validation_error は誤ったパラメータを示します（例: 開始日が終了日より後）。特定の ID で 404 になる場合は、その ID が存在しないか、別のブランドのものです。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Microsoft Copilot にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Trybe のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「今、動画を納品していないクリエイターは誰ですか。期限切れのサンプルと一緒に一覧にしてください。」
• 「過去 30 日間の購入金額でクリエイターをランク付けし、それぞれの広告費と ROAS を表示してください。」
• 「先月の TikTok でのクリエイターの成果はどうでしたか。報酬、広告費、購入数を見せてください。」
• 「レビュー待ちの投稿を一覧にして、それぞれの文字起こしを要約してください。」
• 「送料無料に触れている投稿を探して、広告でどれくらい使われたか教えてください。」

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続