MCP 経由で API-Football を Meta Muse に接続する方法

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

API-Football + Meta Muse

API-Football で AI にサッカーを追わせます。ライブスコアと試合イベント、日程、順位表、チームと選手の統計、スタメン、負傷者、移籍、対戦成績、試合予想、ブックメーカーのオッズを、世界中のリーグとカップ戦について取得できます。API-Sports アカウントの API キーを使います。

前提条件

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

API_FOOTBALL_KEY

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

1. dashboard.api-football.com で無料アカウントを作成します。サインインするとダッシュボードに API キーが表示されます。試すだけなら無料プランで十分です。
2. キーを API_FOOTBALL_KEY に貼り付けて、コネクターをインストールします。キーは x-apisports-key ヘッダーとして API-Sports に送られます。API-Sports のダッシュボードのキーを使ってください。API マーケットプレイス経由で購入したキーは別のヘッダーを使うため、ここでは動きません。
3. 最初に af_status を実行します。プラン、1 日のリクエスト上限、これまでの使用数が表示され、このツール自体はクォータを消費しません。
4. 分析をするときは、まず af_analysis_playbook から始めてください。API を呼び出さずに、依頼の種類ごとに使うツールの順番を返します。対象は試合のプレビューや予想、試合後のレポート、チームの調子、順位表、トッププレーヤー、選手のスカウティング、スカッド、負傷者、移籍、オッズ、ライブの試合です。

まず名前を ID に変換: ほぼすべてのツールが数値 ID を必要とし、AI が ID を推測してはいけません。大会は af_leagues の search フィルターで探します（例: ブンデスリーガは ID 78、ワールドカップは ID 1）。利用できるシーズンも一緒に表示されます。チームは af_teams で探します。チーム ID を指定し next を 1 にして af_fixtures を呼ぶと、次の試合とその fixture ID が返ります。af_predictions、af_fixture_lineups、af_fixture_events、af_fixture_statistics、af_fixture_players はこの ID を使います。選手はチームとシーズンを指定して af_players で、名前で探すなら af_player_profiles で取得します。

シーズンと時刻: season はシーズンが始まる年の 4 桁です。2025 は 2025/26 シーズン、2026 年のワールドカップは 2026 です。日付は YYYY-MM-DD 形式です。AI が af_timezone の値を timezone に渡さない限り、時刻は UTC です。

1 日のクォータ: データ系ツールの呼び出しは 1 回ごとに API-Sports への 1 リクエストになり、プランの 1 日のクォータを消費します。コネクターの説明は 1 日 100 リクエストの無料プランを前提にしています。有料プランではもっと多く使えます。af_status と af_analysis_playbook はクォータを消費しません。完全な試合プレビュー（予想、オッズ、スタメン、両チームの統計と負傷者、得点ランキング、選手の統計、対戦成績）には 12 回前後の呼び出しが必要です。af_players のようにページ分けされる結果は 1 ページごとに 1 リクエストかかるため、リーグ、シーズン、チーム、日付で絞り込むと大きく節約できます。

予想とオッズはデータであり、賭けの助言ではありません: af_predictions は 1 試合について、API-Football 独自の勝ち・引き分け・負けの確率、アドバイス、調子の比較を返します。af_odds_prematch と af_odds_live はブックメーカーのオッズを返し、AI はそれを暗示確率に換算して予想と比べられます。どちらも結果を保証するものではありません。小規模な試合やまだ先の試合ではオッズがないことがあります。af_odds_mapping はオッズのある試合を、af_odds_bookmakers、af_odds_bets、af_odds_live_bets はブックメーカーと賭けの種類を一覧にします。

データの範囲: スタメンは通常、キックオフの約 1 時間前に確定します。af_injuries では、Missing Fixture は欠場、Questionable は出場が不確かという意味です。審判用のツールはありません。審判は試合データにだけ載り、決まるのが遅いこともあります。対戦成績はクラブについては充実していますが、代表チームについてはほとんどありません。

読み取り専用: 40 個のツールはすべてデータを読み取るだけで、API-Sports アカウントの内容は何も変更しません。インストール時にオフになっているツールもありません。

よくあるエラー: API-Football は HTTP 200 を返しても失敗していることがあります。その場合、理由は errors フィールドにあり、response は空です。token の項目は、キーが間違っているか未設定であることを示します。API_FOOTBALL_KEY を確認してください。plan の項目は、そのシーズンや機能がプランに含まれていないことを示します。API-Sports のダッシュボードでプランを上げるか、プランの対象になっているシーズンで聞き直してください。1 日のクォータを使い切ると、リセットされるまで呼び出しは失敗します。残りは af_status で確認できます。errors がなく response が空なら、条件に合うデータがありません。たとえばオッズがまだ公開されていない、シーズンがまだ始まっていない、といった場合です。

このコネクターは賭けを行わず、API-Sports のほかの競技には対応せず、ライブ通知も送りません。ライブスコアは AI が問い合わせたときに取得します。また、football-data.org 独自のトークンを使う football-data.org コネクター とは別のものです。

ステップ 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 — Muse にコネクタを追加

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

Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。

1. Muse で Settings → Connectors を開き、Add custom connector を選びます。
2. MCP サーバーの URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を貼り付けます。
3. Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
4. チャットで、API-Football のツールが必要になる依頼を Muse にしてみましょう。

チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

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

利用可能なツール

プロンプトの例

• 「アルゼンチンの次の試合を詳しくプレビューして。勝敗の確率、ブックメーカーのオッズ、予想スタメン、負傷者、両チームの最近の調子を教えて。」
• 「ブンデスリーガの現在の順位表と、今シーズンの得点ランキング上位 10 人を見せて。」
• 「今ライブ中のセリエ A の試合はどれ？スコアとここまでの得点者も教えて。」
• 「レアル・マドリードで今けがや出場停止で欠場しているのは誰？前回の移籍市場でクラブが獲得した選手も教えて。」

FAQ

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

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