Affonso MCP Server

Affonso MCP Server とは？

Affonso MCP サーバーは Affonso 公式のホスト型エンドポイント（https://api.affonso.io/mcp）で、AI アシスタントから Affonso のアフィリエイトプログラムを管理できます。対象はアフィリエイト、紹介、コミッション、支払い、不正イベント、パートナー探しです。

Affonso はソフトウェア企業向けのパートナーグロースプラットフォームです。アフィリエイト、クリエイター、アプリ内紹介プログラムの運営、どのパートナーが有料顧客を連れてきたかの追跡、課金連携によるサブスクリプション・更新・返金とコミッションの同期、本人確認・税務・不正チェック後のパートナーへの支払いを支援します。MCP サーバーはこれらの操作を 35 個のツールとして提供するため、ダッシュボードをクリックして回る代わりに、Claude などのアシスタントにコミッションの承認やパートナーの検索を頼めます。

Affonso MCP Server の使い方

Affonso のアカウントが必要です。Affonso の料金ページによると、MCP 連携は Growth と Elite プランに含まれ、Launch プランには含まれません。

認証方法は 2 つあります。

• OAuth 2.1（AI アプリに推奨）：URL を追加し、ブラウザで Affonso にサインインします。複数のチームに所属している場合はチームを選び、要求された権限を承認します。API キーは不要です。
• API キー（IDE やカスタムクライアント向け）：Affonso でキーを作成し（本番用キーは sk_live_ で始まります）、Authorization: Bearer ${AFFONSO_API_KEY} として送信します。Affonso は、キーにはアフィリエイトデータへのフルアクセス権があるため、バージョン管理にコミットしないよう注意しています。

Claude Code

Affonso のドキュメントでは次のコマンドを使い、求められたらサインインします（Claude Code 内で /mcp を実行すると認証の開始や確認ができます）。

claude mcp add --transport http --scope user affonso https://api.affonso.io/mcp

API キーを使う場合は、キーをエクスポートしてヘッダーとして渡します。

export AFFONSO_API_KEY="sk_live_..."
claude mcp add --transport http affonso https://api.affonso.io/mcp --header "Authorization: Bearer ${AFFONSO_API_KEY}"

Claude Desktop と claude.ai

Settings > Connectors > Add custom connector を開き、名前を「Affonso」として https://api.affonso.io/mcp を入力します。接続するとブラウザで Affonso の OAuth サインインが開きます。

Cursor

Affonso のドキュメントに記載された ~/.cursor/mcp.json のエントリーを追加し、Cursor を再起動します。

{
  "mcpServers": {
    "affonso": {
      "url": "https://api.affonso.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

VS Code

.vscode/mcp.json にサーバーを追加します。初回接続時に VS Code がブラウザで OAuth サインインを処理します。

{
  "servers": {
    "affonso": {
      "type": "http",
      "url": "https://api.affonso.io/mcp"
    }
  }
}

Affonso MCP Server の主な機能

• Streamable HTTP で提供される公式ホスト型サーバー。ローカルへのインストールは不要です。
• チーム選択付きの OAuth 2.1 サインイン、または IDE やスクリプト向けの API キーアクセス。
• アフィリエイト、不正イベント、紹介、コミッション、支払い、パートナー検索（Finder）、クリエイティブの 7 領域にわたる 35 個のツール。
• アフィリエイトの一括更新やコミッションの一括承認などのバッチ操作。
• Risk Center へのアクセス：チャットから不正イベントの一覧、確認、解決ができます。
• Finder ツールとチームのショートリストによるパートナー探し。
• 既定は Markdown 形式のレスポンスで、response_format パラメーターで JSON も選べます。

Affonso MCP Server のユースケース

• 月次のコミッション確認：「今月の保留中のコミッションを一覧にして、認証済みアフィリエイトのものを承認して」
• 支払いの実行：「支払い対象のアフィリエイトを表示して、支払いを処理して」
• 不正の切り分け：「Risk Center の未解決の不正イベントを一覧にして、自己紹介（セルフリファラル）らしいものをまとめて」
• パートナーのオンボーディング：「jane@example.com のアフィリエイトを作成して、現在のクリエイティブを一覧にして」
• パートナー募集：「当社の製品に合うアフィリエイト機会を Finder で探して、上位 5 件をショートリストに追加して」
• レポート：「前四半期に最もコンバージョンを生んだアフィリエイトは？」

Affonso MCP Server のトラブルシューティング

• 「API key is required. Use Authorization: Bearer <api_key>」：クライアントが OAuth を完了しておらず、キーも送っていません。ブラウザでのサインインを完了するか、Authorization: Bearer ヘッダーを追加してください。
• プランに MCP が含まれているかわからない：Affonso の料金ページでは、MCP 連携は Growth と Elite にのみ記載されています。クライアントを設定する前にプランを確認してください。
• 別のチームのデータが表示される：複数のチームに所属している場合、OAuth でチームを選択します。再接続して正しいチームを選んでください。
• Cursor がサーバーを認識しない：Affonso のガイドでは、mcp.json を保存したあと Cursor を再起動するよう案内しています。