Ags Extend Sdk Mcp Server

AGS Extend SDK MCP サーバー

AI アシスタント（VS Code Copilot、Cursor、Claude、Gemini、Antigravity）に AccelByte Extend SDK を追加のコンテキストとして提供する Model Context Protocol（MCP）サーバーです。SDK に関する質問に回答し、正しい Extend SDK コードを生成できるようになります。

できること

• Extend SDK のシンボル（関数とモデル）を名前、タグ、説明で検索します（あいまい検索）。
• 特定のシンボルについて、パラメーター、フィールド、インポート、例、戻り値の型、必要な権限を説明します。
• create-extend-app プロンプトを使って、テンプレートリポジトリから新しい Extend アプリをひな形作成します。

SDK リファレンスは C#、Go、Java、Python の 4 言語に対応しています。接続ごとに URL パスから言語を選択します（言語を選択するを参照）。

AccelByte が Extend SDK MCP サーバーをホストするため、ローカルに何かをインストールしたり、実行したりする必要はありません。使用する言語に対応したホスト済み MCP URL を AI アシスタントに設定するだけです。サインインは不要です。このサーバーは読み取り専用の SDK リファレンスデータのみを公開します。自分で実行しますか？ローカルでの実行とセルフホストを参照してください。

---

クイックインストール

これを AI コーディングアシスタントに貼り付けてください。インストールガイドを取得し、いくつか質問したうえで、すべてを設定します。

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

VS Code Copilot、Cursor、Claude Code、Antigravity、Gemini CLIで動作します。

Claude Desktop をお使いの場合： 最も簡単な方法は、Settings → Connectors → Add custom connector（名前：extend-sdk、URL：使用する MCP URL）です。AI インストーラーは必要ありません。以下のClaude Desktopを参照してください。

上記のクイックインストールプロンプトを使う場合は、先に Code タブに切り替えてください（Chat と Cowork では設定ファイルを編集できません）。

自分で設定しますか？以下の手動インストールを参照してください。

---

手動インストール

Step 1: 言語を選択して URL を取得する

MCP URL は、ホスト済みサーバーのベース URL の末尾に /extend-mcp/{language} を付けたものです。

https://<mcp-server-host>/extend-mcp/{language}

言語	URL パス
C#	/extend-mcp/csharp
Go	/extend-mcp/go
Java	/extend-mcp/java
Python	/extend-mcp/python

• <mcp-server-host> は組織のデプロイ先のホストです。不明な場合は、AccelByte 管理者に確認してください。
• 1 つのホスト済みインスタンスですべての言語に対応します。後で言語を切り替えるには、末尾のパス部分を変更するだけです（例：/extend-mcp/python → /extend-mcp/go）。不明な言語を指定すると、HTTP 400 が返されます。
• 言語を指定しないベースパス（/extend-mcp）では、サーバーに設定されたデフォルトの言語が使用されます。

ホスト済みインスタンスがありませんか？ Docker を使ってサーバーを自分で実行できます。ローカルでの実行とセルフホストを参照してください。

Step 2: クライアントを設定する

サーバーは Streamable HTTP トランスポートを使用します。HTTP トランスポートに対応したクライアントは、URL に直接接続します。stdio トランスポートにしか対応していないクライアントでは、ブリッジとして mcp-remote を使用します。

mcp-remote が必要ですか？ npx 経由で実行するため、npx が利用可能な Node.js 18 以降が必要です。npx --version で確認してください。グローバルインストールは不要です。

以下で <URL> と記載されている箇所には、Step 1 で取得した URL を指定してください。

Visual Studio Code (Copilot)

ワークスペース内の .vscode/mcp.json（またはユーザーの settings.json）：

{
  "servers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

クライアントから HTTP サーバーに接続できない場合は、次の設定に切り替えてください：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

VS Code MCP ドキュメントを参照してください。

Cursor

ワークスペース内の .cursor/mcp.json（またはユーザー設定）：

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

クライアントから HTTP サーバーに接続できない場合は、次の設定に切り替えてください：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

Cursor MCP ドキュメントを参照してください。

Claude Code

claude mcp add --transport http extend-sdk <URL>

フォールバック（stdio のみの環境）：claude mcp add extend-sdk -- npx -y mcp-remote <URL>。

Claude Code MCP ドキュメントを参照してください。

Antigravity

プロジェクトのルートにある mcp_config.json：

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

クライアントが HTTP サーバーに接続できない場合は、次の設定に切り替えてください：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

Antigravity MCP ドキュメントを参照してください。

Gemini CLI

gemini mcp add --transport http extend-sdk <URL>

フォールバック（stdio のみの環境）：gemini mcp add extend-sdk -- npx -y mcp-remote <URL>。

Gemini CLI MCP ドキュメントを参照してください。

Claude Desktop

オプション A — カスタムコネクター（推奨）

1. Settings → Connectors → Add custom connector（「Customize」エリア内）を開きます。
2. Name に extend-sdk、Remote MCP server URL にステップ 1 で取得した <URL> を入力します。
3. 保存します。

「Add custom connector」が見つかりませんか？ Team および Enterprise プランでは、ワークスペースポリシーによってカスタムコネクターが無効になっている場合があります。このオプションが表示されないか、グレー表示されている場合は、オプション B を使用してください。

オプション B — mcp-remote 設定ファイル（フォールバック）

claude_desktop_config.json を編集します：

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

{
  "mcpServers": {
    "extend-sdk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<URL>"]
    }
  }
}

保存後、Claude Desktop を再起動します。

---

ツールの使用

接続すると、アシスタントからこれらのツールを利用できます。アシスタントとのチャットで、以下のプロンプト例を試してください。ツールの実行を求められたら、許可してください。

search-symbols

ファジーマッチングを使って、名前、タグ、説明から Extend SDK のシンボルを検索します。概要のページ分けされたリストを返します。

「user に関連するシンボルを検索して」 · 「inventory のシンボルを見つけて」

describe-symbols

ID で指定したシンボルの詳細（フィールド、パラメーター、インポート、使用例、戻り値の型、必要な権限）を取得します。

「AdminCreateUser@iam と User@iam のシンボルについて説明して」

create-extend-app

Extend アプリのテンプレートリポジトリをクローンして開くプロンプトテンプレートです（利用可能な場合は Dev Container 内で開きます）。これにより、動作するサンプルを基に作業を開始できます。

create-extend-app プロンプトを呼び出し、シナリオ／テンプレート／言語の補完に従ってください。

ヒント

この MCP サーバーを使ってコーディングする場合は、空のプロジェクトから始めるのではなく、Extend SDK のスタートガイド用サンプルまたは Extend アプリのテンプレートを基にしてください。また、より良い結果を得るために、関連するソースファイルをコンテキストとして追加してください。

---

自分で実行する

サーバーをローカルで実行（stdio）するか、HTTP サーバーを自分でホストしますか？Docker の使用方法、環境変数、HTTP エンドポイント、スモークテスト、ソースからの開発、イメージのリリースについては、**ローカル実行とセルフホスト**を参照してください。

---

トラブルシューティング

ツールの呼び出しに失敗する／サーバーが 400 を返す

URL パス内の言語を確認してください。csharp、go、java、python のいずれかである必要があります（例：/extend-mcp/go）。不明な言語の場合、HTTP 400 が返されます。

クライアントが HTTP URL に接続できない

stdio トランスポートのみをサポートするクライアントもあります。ステップ 2に記載されている mcp-remote ブリッジ設定に切り替えてください。Node.js 18 以降と、利用可能な npx が必要です（npx --version）。

「Connection refused」またはホストに到達できない

<mcp-server-host> と完全な URL が正しいこと（AccelByte の管理者に確認してください）、およびネットワークから接続できることを確認してください。

---

ドキュメント

• インストールガイド — クイックインストールプロンプトに続く手順です。単独でも読めます
• ローカル実行とセルフホスト — Docker、環境変数、HTTP エンドポイント、開発、イメージのリリース
• Postman コレクション — search-symbols と describe-symbols のインポートおよび Newman によるスモークテストの手順

貢献

このリポジトリは現状のまま公開されています。バグの報告や質問がある場合は、issue を作成してください。