AGS Extend SDK MCP Server

AGS Extend SDK MCP Server

Сервер Model Context Protocol (MCP), который предоставляет AI-ассистентам (VS Code Copilot, Cursor, Claude, Gemini, Antigravity) AccelByte Extend SDK в качестве дополнительного контекста — чтобы они могли отвечать на вопросы о SDK и генерировать корректный код Extend SDK.

Что он делает

• Поиск символов Extend SDK (функций и моделей) по имени, тегам или описанию (нечеткое совпадение)
• Описание конкретных символов — параметры, поля, импорты, примеры, типы возвращаемых значений, необходимые разрешения
• Создание заготовки нового приложения Extend из репозитория-шаблона с помощью промпта create-extend-app

Он предоставляет справочную информацию по SDK для четырех языков — C#, Go, Java и Python. Вы выбираете язык для каждого подключения через путь URL (см. Выберите язык).

AccelByte размещает Extend SDK MCP Server для вас — вам не нужно ничего устанавливать или запускать локально. Просто укажите вашему AI-ассистенту размещенный MCP URL для вашего языка. Вход не требуется: сервер предоставляет только справочные данные 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 не могут редактировать ваш файл конфигурации).

Предпочитаете сделать это самостоятельно? См. Ручная установка ниже.

---

Ручная установка

Шаг 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, если не уверены.
• Один размещенный экземпляр обслуживает все языки. Чтобы позже переключить язык, просто измените конечный сегмент пути (например, /extend-mcp/python → /extend-mcp/go). Запрос неизвестного языка возвращает HTTP 400.
• Базовый путь (/extend-mcp) без указания языка обслуживает язык по умолчанию, настроенный на сервере.

Нет размещенного экземпляра? Вы можете запустить сервер самостоятельно с помощью Docker — см. Локальный запуск и самостоятельное размещение.

Шаг 2: Настройте ваш клиент

Сервер использует транспорт Streamable HTTP. Клиенты, поддерживающие транспорт HTTP, подключаются к URL напрямую. Клиенты, поддерживающие только транспорт stdio, используют mcp-remote в качестве моста.

Нужен mcp-remote? Он работает через npx, поэтому вам нужен Node.js 18+ с доступным npx — проверьте с помощью npx --version. Глобальная установка не требуется.

Подставьте ваш URL из Шага 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: ваш <URL> из Шага 1.
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 по имени, тегам или описанию с нечетким совпадением. Возвращает постраничный список сводок.

"Поиск символов, связанных с пользователем" · "Найти символы для инвентаря"

describe-symbols

Получение полной информации о конкретных символах по ID — поля, параметры, импорты, примеры использования, тип возвращаемого значения и необходимые разрешения.

"Опиши символы AdminCreateUser@iam и User@iam"

create-extend-app

Шаблон промпта, который клонирует репозиторий-шаблон приложения Extend и открывает его (в Dev Container, если доступно), чтобы вы могли начать с рабочего примера.

Вызовите промпт create-extend-app и следуйте подсказкам для сценария / шаблона / языка.

[!TIP] При кодировании с этим MCP-сервером начинайте с примера начала работы с Extend SDK или шаблона приложения Extend, а не с пустого проекта, и добавляйте соответствующие исходные файлы в качестве контекста для лучших результатов.

---

Самостоятельный запуск

Предпочитаете запускать сервер локально (stdio) или размещать HTTP-сервер самостоятельно? См. Локальный запуск и самостоятельное размещение для использования Docker, переменных окружения, конечных точек HTTP, дымовых тестов, разработки из исходного кода и публикации образа.

---

Устранение неполадок

Вызовы инструментов завершаются ошибкой / сервер возвращает 400

Проверьте язык в вашем пути URL. Это должен быть один из: csharp, go, java или python (например, /extend-mcp/go). Неизвестный язык возвращает HTTP 400.

Клиент не может подключиться к HTTP URL

Некоторые клиенты поддерживают только транспорт stdio. Переключите такой клиент на конфигурацию моста mcp-remote, показанную в Шаге 2. Для этого требуется Node.js 18+ с доступным npx (npx --version).

"Connection refused" или хост недоступен

Убедитесь, что <mcp-server-host> и полный URL верны (спросите вашего администратора AccelByte), и что ваша сеть может до него добраться.

---

Документация

• Руководство по установке — используется промптом быстрой установки; читается отдельно
• Локальный запуск и самостоятельное размещение — Docker, переменные окружения, конечные точки HTTP, разработка и публикация образа
• Коллекция Postman — инструкции по импорту и дымовому тестированию Newman для search-symbols и describe-symbols

Участие в разработке

Этот репозиторий публикуется как есть. Для сообщений об ошибках и вопросов, пожалуйста, создайте issue.