プレミアリーグのデータを、あなたのAIに。

順位・スタッツ

順位表と、クラブ/選手のシーズンスタッツ。並べ替えを指定できるので「〇〇のトップ5」がそのまま答えられます。

• league_table
  順位・勝点・得失点
• player_stats
  選手個人の得点・アシスト・シュート・守備・出場時間
• squad_stats
  クラブ単位の集計（チーム同士の比較）

試合データ

結果と日程、1試合ごとの詳細。「この試合で何が起きたか」に答えられます。

• fixtures
  結果と日程。節で絞り込み
• match_detail
  スコア・xG・チームスタッツ・得点/カード

レポート・ニュース

AIによるプレ/ポストマッチの分析文と、掲載中のニュース。予想かAI生成かの但し書きが返り値に入ります。

• search_reports
  プレマッチ分析（予想）とポストマッチレポート
• search_news
  掲載中のニュース記事

シーズンの状況

「今何節？」の答え。他のツールを呼ぶ前提にもなります。

• season_context
  現在のシーズン・消化節・データ更新時刻

APIキーは不要。接続時にログインと許可の画面が出ます。

1. 設定を開く（デスクトップ: Ctrl+, ／ ブラウザ: プロフィール → 設定）
2. サイドバーの「コネクタ」
3. 右上「追加」→「カスタムコネクタを追加」
4. 上の接続URLを貼り付ける
5. ログイン → 許可 で完了

※「OAuth クライアントID / シークレット」の欄は空のままで構いません（自動で登録されます）。

APIキーは不要。先に開発者モードを有効にします。

1. 設定 → アプリ → 詳細設定
2. 「開発者モード」をオンにする
3. カスタムコネクタの追加で、上の接続URLを登録
4. 認証は OAuth を選ぶ
5. ログイン → 許可 で完了

※ 開発者モードは Plus / Pro / Business / Enterprise / Education のウェブ版が対象です。

キーは 設定 → Web API & MCP で発行できます。

claude mcp add --transport http premanalytics \
  https://premie-backend-lvuzwxd3aq-uc.a.run.app/mcp/ \
  --header "Authorization: Bearer pak_..."

MCP対応クライアント共通の書式です。

{
  "mcpServers": {
    "premanalytics": {
      "type": "http",
      "url": "https://premie-backend-lvuzwxd3aq-uc.a.run.app/mcp/",
      "headers": {
        "Authorization": "Bearer pak_..."
      }
    }
  }
}

ステータスコード

• 401 Unauthorized
  認証していない・トークンやキーが無効／失効している
• 403 Forbidden
  認証は通ったがプランが対象外（ファン/解約後）
• 429 Too Many Requests
  レート制限（分間）または月間上限を超過

切り分けの手順

1. まずキー自体が有効か確かめる（200 が返れば正常）

   curl -s -o /dev/null -w "%{http_code}\n" \
     -H "X-API-Key: pak_..." \
     https://premie-backend-lvuzwxd3aq-uc.a.run.app/v1/league-table/overall

2. URLの末尾スラッシュを省くとリダイレクトが1回挟まります。嫌うクライアントでは末尾まで含める
3. それでも解決しない場合はお問い合わせください