AGS API MCP Server

Last updated on October 6, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

AGS API MCP Server は、AI アシスタントを AccelByte Gaming Services (AGS) に接続します。接続後は、「プレイヤーにアイテムを付与するエンドポイントはどれ？」や「自分のネームスペースにある統計コードを一覧表示して」といった質問をアシスタントにできます。アシスタントは推測ではなく、実際の AGS 環境の情報に基づいて回答します。

サーバーは AccelByte がホストしているため、何かをインストールしたり実行したりする必要はありません。アシスタントに URL を 1 つ登録し、AGS アカウントでログインするだけで完了です。

このページは 3 つのステージで構成されています。目的を達成できたステージで読み終えてかまいません。

  1. 接続: サーバーをアシスタントに追加してログインします。
  2. 試す: 読み取り専用の照会から実際の変更まで、いくつかのプロンプトを実行します。
  3. さらに活用する: チャートの作成、リクエストから分かる情報、セルフホスティング、よくある問題の解決方法について説明します。

MCP とは​

Model Context Protocol (MCP) は、AI アシスタントが外部のツールを使用できるようにするオープン標準です。MCP サーバーは一連のツールを提供し、それらをいつ呼び出すかはアシスタントが判断します。AGS API MCP Server の場合、アシスタントはこれらのツールを使って AGS API カタログを検索し、エンドポイントの詳細を読み取り、あなたに代わって AGS にリクエストを送信します。Claude、Cursor、Visual Studio Code (GitHub Copilot)、Gemini CLI、Antigravity など、現在のほとんどのアシスタントが MCP をサポートしています。

始める前に​

以下が必要です。

  • Admin Portal にログインできる AGS アカウント
  • MCP をサポートする AI アシスタント (以下のセットアップ手順では、Claude Desktop、Claude Code、Cursor、Visual Studio Code、Antigravity、Gemini CLI について説明します)

現時点で必要なのはこれだけです。一部のアシスタントでは Node.js も必要になりますが、該当する場合は手順の中で案内します。

注記

アシスタントが実行できるのは、あなたの AGS アカウントで実行できる操作だけです。サーバーはあなたのロールと権限を使い、あなた本人として動作します。Admin Portal で実行できない操作は、アシスタントにも実行できません。

ステージ 1: 接続​

接続方法は次の 2 つから選べます。

  • アシスタントに任せる: プロンプトを 1 つ貼り付けるだけで、アシスタントがセットアップを行います。
  • 自分で行う: 以下のステップ 1 から 3 に従います。

アシスタントに任せる​

この方法は、お使いのコンピューター上のファイルを編集できるアシスタント (Claude Code、Cursor、VS Code、Antigravity、Gemini CLI) で使用できます。次のプロンプトをアシスタントに貼り付けてください。

Install the AGS API MCP server for me. Fetch and follow the instructions at
https://raw.githubusercontent.com/AccelByte/ags-api-mcp-server/refs/heads/master/INSTALL.md

アシスタントが AGS のエディションとネームスペースを尋ね、URL を作成して設定を書き込み、接続できることを確認します。完了したら、ステージ 2: 試す に進んでください。

ヒント

Claude Desktop をお使いの場合は、手動で設定するほうが早く完了します。以下のステップ 1 から 3 に従い、ステップ 2 で Claude Desktop タブを選択してください。

ステップ 1: サーバー URL を確認する​

URL は、お使いの AGS エディションによって異なります。不明な場合は、AccelByte の管理者に確認してください。

URL には スタジオネームスペース を先頭と末尾の計 2 回使用します。

https://<YourStudioNamespace>.prod.gamingservices.accelbyte.io/mcp/<YourStudioNamespace>

たとえば、スタジオネームスペースが mystudio の場合、URL は次のようになります。

https://mystudio.prod.gamingservices.accelbyte.io/mcp/mystudio

スタジオネームスペースは、Admin Portal にログインしてブラウザのアドレスバーで確認できます。登録時に受け取ったウェルカムメールにも記載されています。

ヒント

スタジオネームスペースのみを使用し、URL にゲームネームスペースを追加しないでください。スタジオ管理者もゲーム管理者も同じ URL に接続します。どのゲームにアクセスできるかは、ロールによって決まります。

備考

古いガイドやサポートスレッドでは、Public Cloud を「Shared Cloud」と呼んでいる場合があります。どちらも同じものを指します。

URL をコピーしておきます。次のステップで、<YourMcpUrl> と記載されている箇所に貼り付けます。

ステップ 2: アシスタントにサーバーを追加する​

お使いのアシスタントのタブを選択してください。各タブには、最も手早く設定できる手順を記載しています。

  1. Settings > Connectors を開き、Add custom connector を選択します。
  2. Name に ags-api と入力します。
  3. Remote MCP server URL に URL を貼り付けます。
  4. Add を選択します。

ログインは Claude Desktop が処理するため、ファイルを編集する必要はありません。

Add custom connector が表示されない場合

一部の Team プランと Enterprise プランでは、カスタムコネクターが無効になっています。その場合は、代わりに設定ファイルからサーバーを追加します。この方法には Node.js 18 以降が必要です。ターミナルで npx --version を実行し、インストール済みであることを確認してください。

  1. claude_desktop_config.json を開きます。

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. mcpServers 内に ags-api エントリを追加します。

    {
      "mcpServers": {
        "ags-api": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "<YourMcpUrl>"]
        }
      }
    }

  3. ファイルを保存し、Claude Desktop を完全に終了してから再起動します。

ヒント

設定ファイルにすでに他の MCP サーバーが登録されている場合は、それらと並べて ags-api を追加してください。ファイル全体を置き換えると、他のサーバーの設定が失われます。

ステップ 3: ログインして接続を確認する​

  1. アシスタントに 「現在のユーザー情報を教えて」 と尋ねます。
  2. ブラウザウィンドウで AccelByte のログインページが開きます。AGS アカウントでログインし、同意画面で承認します。
  3. アシスタントに戻ると、ユーザーの詳細情報、ネームスペース、ロール、セッションの有効期限が表示されます。

詳細情報が表示されれば、接続は完了です。アシスタントは以降のリクエストでもこのログインを再利用するため、毎回ログインする必要はありません。

ブラウザが開かない場合やログインに失敗した場合は、トラブルシューティング を参照してください。

ステージ 2: 試す​

これで、アシスタントは 4 つのツールを使用できるようになりました。ツール名を指定して呼び出す必要はありません。普段の言葉で尋ねれば、アシスタントが適切なツールを選択します。

次のプロンプトを順番に試してください。ステップが進むごとに、一歩踏み込んだ操作になります。

ステップ質問の例実行される内容データの変更
1「現在のユーザー情報を教えて」ログイン中のユーザーと、アクセスできる範囲を表示します。いいえ
2「プレイヤーのインベントリを管理する API を探して」説明、サービス、またはメソッドで AGS API カタログを検索します。いいえ
3「アイテムを付与するエンドポイントに必要なパラメーターは？」1 つのエンドポイントの詳細 (パラメーター、リクエストボディ、必要な権限) をすべて読み取ります。いいえ
4「ゲームネームスペースの統計コードを一覧表示して」AGS 環境に読み取りリクエストを送信し、結果を表示します。いいえ
5「ゲームネームスペースに kills という統計コードを作成して」書き込みリクエストを送信します。送信前に、アシスタントが承認を求めます。はい
警告

ステップ 5 のリクエストは、環境内の実際のデータを変更します。アシスタントは、作成、更新、削除のリクエストを送信する前に必ず確認を求めます。特に本番環境のネームスペースでは、承認する前に各リクエストの内容をよく確認してください。

複数のステップにまたがる変更には、代わりに AGS CLI を使用してください。AGS CLI では、何かが実行される前に計画全体が表示されます。詳細は、使用するツールの選び方 を参照してください。

ヒント

ネームスペースは具体的に指定してください。アカウントが複数のゲームにアクセスできる場合は、「mystudio-mygame ネームスペースで」のように対象を明示します。

ステージ 3: さらに活用する​

クエリ結果をチャートにする​

インタラクティブな MCP コンテンツをサポートするアシスタントでは、サーバーがチャート、テーブル、単一の数値メトリクスをアシスタント内に直接描画できます。AGS の分析データと組み合わせれば、「過去 30 日間のデイリーアクティブプレイヤー数を折れ線グラフで表示して」といった質問ができます。

必要な権限やプレイブックを含むセットアップ方法については、AGS AI Analytics の使用を開始する を参照してください。

リクエストから分かる情報を把握する​

このサーバーには、オプトアウトが必要になるような独自のテレメトリはありません。サーバーが AGS に送信するリクエストは、いずれもあなたのログイン情報を使った通常の API 呼び出しです。サーバーが付加するのは、サーバー自身とアシスタントの名前を示す User-Agent ヘッダーだけです。例:

ags-api-mcp-server/2026.1.0 (MCP-Client claude-code/2.1.0)

このヘッダーにより、管理者はアシスタント経由のリクエストと Admin Portal から行われたリクエストを区別できます。分析クエリには、使用したプレイブックとゲームコンテキストのバージョンも含まれますが、それ以外の情報は含まれません。

注記

AGS から返されたデータは AI アシスタントに渡されるため、チャットで共有する他の情報と同様に、アシスタントの提供元によって処理されます。プレイヤーデータを要求する前に、この点に留意してください。他のチャットと同じく、組織の AI ポリシーが適用されます。

サーバーを自分で実行する​

サーバーは AccelByte が運用しているため、自分でホストする必要はありません。それでもチームで独自にサーバーを実行したい場合は、AGS API MCP Server リポジトリのセルフホスティングガイドに従ってください。

トラブルシューティング​

発生している症状に該当する項目を確認してください。

OAuth、DCR、または「registration failed」エラーでログインに失敗する

お使いのアシスタントが、自動クライアント登録にまだ対応していません。アシスタントに代わってログインを処理するブリッジ設定に切り替えてください。ブリッジ設定には Node.js 18 以降が必要です。npx --version を実行し、インストール済みであることを確認してください。

  • Cursor、VS Code、Antigravity: 設定ファイル内の ags-api エントリを次のように置き換えます。

    "ags-api": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<YourMcpUrl>"]
    }

  • Claude Code: claude mcp remove ags-api でサーバーを削除してから、claude mcp add ags-api -- npx -y mcp-remote <YourMcpUrl> を実行します。

  • Gemini CLI: gemini mcp remove ags-api でサーバーを削除してから、gemini mcp add ags-api -- npx -y mcp-remote <YourMcpUrl> を実行します。

変更後は、アシスタントを再起動してください。

最初の質問をしたときにブラウザが開かない
  1. 設定ファイルを保存したことを確認します。
  2. アシスタントを完全に終了してから再起動します。ウィンドウの再読み込みだけでは不十分な場合があります。
  3. もう一度「現在のユーザー情報を教えて」と尋ねます。
以前はログインできたが、「Invalid Request」または「client ID not found」で失敗するようになった

アシスタントが保存している登録情報が、AGS 側ですでに削除されています (未使用のクライアントがクリーンアップされた場合など)。ags-api サーバーの保存済みログイン情報のみを消去してから、再度ログインしてください。

  • Claude Code: /mcp を実行し、ags-api を選択して Clear authentication を選びます。その後、再接続します。
  • Codex: codex mcp logout ags-api を実行してから、codex mcp login ags-api を実行します。
  • ブリッジ設定 (mcp-remote): 次の項目の手順に従います。

サーバーを削除して再追加する必要はありません。

毎回ログインのためにブラウザが開く

ブリッジ設定 (mcp-remote) は、ログイン情報を ~/.mcp-auth/ フォルダーに保存します。このフォルダーの内容が古くなっている場合や、フォルダーに書き込めない場合は、起動するたびにログアウトされた状態になります。

  1. ユーザーアカウントが ~/.mcp-auth/ に書き込めることを確認します。

  2. 書き込める場合は、バックアップとしてフォルダーの名前を変更し、再度ログインします。

    mv ~/.mcp-auth ~/.mcp-auth.bak

  3. それでも解決しない場合は、mv ~/.mcp-auth.bak ~/.mcp-auth でバックアップを復元します。

注記

このフォルダーの名前を変更すると、このサーバーだけでなく、ブリッジ設定を使用するすべての MCP サーバーからログアウトされます。

ログインしているのに、リクエストが 403 エラーで失敗する

お使いの AGS アカウントに、そのリクエストを実行する権限がありません。これはセットアップの問題ではありません。AGS 管理者に、必要なロールの付与を依頼してください。

それでも解決しない場合は、AGS API MCP Server リポジトリで最新の既知の問題を確認するか、AccelByte サポートにお問い合わせください。

に最終更新
On this page