> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ru/docs/integraciya-mcp.md).

# Интеграция MCP

Подключите AI-агенты для кодирования к Edgegap через наш MCP-сервер: инструменты для контейнеризации, развертывания, матчмейкинга и устранения неполадок игровых серверов, а также проверенные рабочие процессы для каждого движка и сетевого кода.

Наш сервер MCP предоставляет вашему кастомному ИИ-агенту для кодинга инструменты, необходимые для начала работы с кастомными сборками игровых серверов, и помогает проверять каждый шаг интеграции с помощью нашей проверенной тестовой среды.

## 👉 Поддерживаемые функции

{% hint style="success" %}
**Новые пользователи — начните с** [Unity](https://docs.edgegap.com/ru/unity.md)**,** [Unreal Engine](https://docs.edgegap.com/ru/unreal-engine.md)**, или** [Godot](https://docs.edgegap.com/ru/godot.md)**.** Использовать сервер MCP рекомендуется только после того, как у вас уже есть рабочий контейнеризованный игровой сервер, загруженный в контейнерный реестр.
{% endhint %}

Используйте наш сервер MCP, когда:

* **Контейнеризация вашего игрового сервера** - ваш агент пишет Dockerfile для вашей сборки (или проверяет уже имеющийся) на соответствие лучшим практикам, загружает образ в наш частный контейнерный реестр и удаляет неиспользуемые старые теги образов, чтобы освободить место в реестре.
* **Развертывание выделенного сервера** - создавать и обновлять версии приложения, просматривать доступные локации, развёртывать ближе к вашим игрокам и получать IP-адрес сервера с портами для тестирования подключения клиента.
* **Построение CI/CD-пайплайна** - тестировать ваши развёртывания и завершение работы из системы сборки.
* **Устранение проблемы с игровым сервером** - изучать версии приложения и статус развёртывания, читать логи контейнера и использование CPU/памяти, либо воспроизводить неудачное развёртывание.
* **Запуск игр с моделью клиент-хост и peer-to-peer** - создавать relay-сессии, обеспечивающие NAT punchthrough, и избегать блокировки соединения. См. [Модели оркестрации](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#orchestration) перед принятием решения.

{% hint style="warning" %}
Не входит в сферу действия / не поддерживается MCP: сборка Linux-исполняемого файла сервера; создание, запуск или остановка матчмейкера (загрузите сгенерированную конфигурацию в панели управления); серверный браузер; лобби; управляемые кластеры; частные флоты; или биллинг.
{% endhint %}

{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Навыки

Список и получение навыков агента, включая полностью протестированные рабочие процессы, шаблоны кода и защиту от известных подводных камней для движков, игровых бэкендов и netcode:

* Unity, включая Mirror, Netcode for GameObjects, FishNet, PurrNet, Photon Fusion 1 и 2.
* Unreal Engine — включая голосовой чат EOS.
* Godot — ENET и netfox.
* Colyseus, Nakama, PlayFab, Three.js и Manus AI.

Ваш агент загружает навык, соответствующий вашему проекту, прежде чем действовать, и `edgegap_update_skills`  поддерживает установленные локально копии в актуальном состоянии. [Отдельные навыки также доступны на GitHub.](https://github.com/edgegap/llm-agent-skills)

### Ограничения

Ваш API-токен может делать что угодно в вашей организации, поэтому сервер MCP ограничивает, что агент может с ним делать:

* **Сухой прогон** - любой инструмент, который что-то изменяет, может сначала показать точный запрос и ничего не отправлять.
* **Без токена в контейнерах** - развёртывания и версии отклоняются, если ваш API-токен присутствует в переменной окружения, теге или URL вебхука.
* **Без переноса тегов образов** - `latest`  и пустые теги отклоняются, потому что Edgegap кэширует образы по тегу.
* **Ограничение на число развёртываний и автоостановка** - каждое развёртывание помечается `edgegap-mcp`  чтобы его можно было найти и остановить, сообщает, когда Edgegap остановит его, и зацикленный агент не может запустить больше нескольких одновременно.
* **По одному за раз** - остановка развёртываний и удаление тегов из реестра требуют одного точного ID; пакетного удаления нет.

### Примеры запросов

* *"Напиши Dockerfile для моей сборки сервера three.js, затем запушь его и разверни сервер рядом со мной."*
* *"Проверь мой Dockerfile для Edgegap и исправь любые проблемы."*
* *"Моё развёртывание не удалось. Прочитай логи и скажи, почему."*
* *"Сколько CPU и памяти использовал мой последний матч? Подбери размер версии под это."*
* *"В моей игре используется host-client networking. Настрой relay Edgegap для двух игроков."*

## 🚀 Установка

Установка MCP-сервера очень проста:

1. Установите MCP-сервер для [Интеграция MCP](https://docs.edgegap.com/ru/docs/integraciya-mcp.md#popular-agents) или с помощью [Интеграция MCP](https://docs.edgegap.com/ru/docs/integraciya-mcp.md#custom-integration).
2. Сгенерируйте и прикрепите API-токен, который ваш агент будет использовать с нашим сервером MCP:

Создайте секретные токены для API Edgegap в разделе [Панель управления — Настройки пользователя / Токены](https://app.edgegap.com/user-settings?tab=tokens).

Добавляйте секретный токен к каждому API-запросу в HTTP-заголовке (включая слово `token`):

`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`

{% hint style="danger" %}
**Не интегрируйте конечные точки API Edgegap в игровой клиент: ваш API-токен предоставляет неограниченный доступ к вашей учетной записи. См.** [Интеграция](https://docs.edgegap.com/ru/docs/api/integraciya.md) **для безопасных конечных точек API и функций, предназначенных для клиентских приложений.**
{% endhint %}

{% hint style="success" %}
Если ваши секретные токены будут скомпрометированы или утекут, удалите их и создайте новые в панели управления.
{% endhint %}

### Популярные агенты

Установите Edgegap MCP server в предпочитаемой вами агентной IDE: <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=Edgegap&#x26;config=eyJ1cmwiOiJodHRwczovL21jcC5lZGdlZ2FwLmRldi9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiIifX0%3D" class="button secondary" data-icon="cursor">Cursor</a><a href="vscode:mcp/install?%7B%22name%22%3A%22Edgegap%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.edgegap.dev%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22%22%7D%7D" class="button secondary" data-icon="vscode">VS Code</a>

Затем добавьте ваш токен в заголовок `Authorization` .

#### Claude Code

{% code collapsedlinecount="10" %}

```bash
claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp \
  -H "Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62" --scope user
```

{% endcode %}

#### ChatGPT Codex

Codex читает токен из переменной окружения. Добавьте это в `~/.codex/config.toml`, затем установите `EDGEGAP_API_TOKEN` в значение вашего токена в окружении, из которого запускается Codex:

{% code title="config.toml" collapsedlinecount="10" %}

```toml
[mcp_servers.edgegap]
url = "https://mcp.edgegap.dev/mcp"
bearer_token_env_var = "EDGEGAP_API_TOKEN"
```

{% endcode %}

#### Claude Desktop

Скачать [edgegap-mcp.mcpb](https://github.com/edgegap/llm-mcp-server/releases/latest/download/edgegap-mcp.mcpb) и откройте его. Claude Desktop устанавливает MCP-сервер как расширение и запрашивает ваш API-токен, который хранит в защищённом хранилище вашей операционной системы.

{% hint style="info" %}
Пользовательские коннекторы в claude.ai и Claude Desktop пока не могут отправлять заголовок `Authorization` поэтому они подключаются к `mcp.edgegap.dev` но каждый вызов инструмента завершается ошибкой. В Claude Desktop вместо этого используйте расширение в один клик выше.
{% endhint %}

#### mcp.json

Большинство агентных IDE также поддерживают интеграцию через вставку JSON-конфигурации:

{% code title="mcp.json" collapsedlinecount="10" %}

```json
{
    "mcpServers": {
        "Edgegap": {
            "type": "http",
            "url": "https://mcp.edgegap.dev/mcp",
            "headers": {
                "Authorization": "EDGEGAP_API_TOKEN"
            }
        }
    }
}
```

{% endcode %}

### Пользовательская интеграция

Официальный репозиторий — единственный источник истины для пользовательской интеграции нашего MCP-сервера:

{% embed url="<https://github.com/edgegap/llm-mcp-server>" %}

Чтобы хранить ваш API-токен на своей машине, запустите MCP-сервер локально с Node 18+. Не указывайте токен, и ваш агент запросит его при первом использовании:

{% code title="локальный сервер с использованием npx" collapsedlinecount="10" %}

```json
{
  "command": "npx",
  "args": ["-y", "@edgegap/mcp"],
  "env": { "EDGEGAP_API_TOKEN": "xxxxxxxx-e458-4592-b607-c2c28afd8b62" }
}
```

{% endcode %}

Локальный сервер также можно дополнительно ограничить, например, только инструментами только для чтения или списком приложений. См. [репозиторий](https://github.com/edgegap/llm-mcp-server#local-server) для настроек.

Или подключитесь к удалённому MCP-серверу Edgegap из виртуализированной среды вашего агента (никогда не в вашем проекте!):

{% code title="node с использованием пакета npx" collapsedlinecount="10" %}

```json
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```

{% endcode %}

{% code title="python с использованием пакета uvx" collapsedlinecount="10" %}

```json
{
  "command": "uvx",
  "args": ["mcp-proxy", "--transport", "streamablehttp", "https://mcp.edgegap.dev/mcp"]
}
```

{% endcode %}

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

Изучите распространённые коды ошибок и узнайте, как разблокировать интеграцию.

### 401 Unauthorized

Скорее всего, ваша интеграция MCP неправильно включает заголовок Authorization.

### Вызов инструмента не удался

В вашем клиенте отсутствует токен Edgegap. Это происходит с пользовательскими коннекторами claude.ai и Claude Desktop, которые не могут отправлять `Authorization` заголовок. См. [Claude Desktop](https://docs.edgegap.com/ru/docs/integraciya-mcp.md#claude-desktop) для альтернативы.

{% hint style="warning" %}
Это известное ограничение, которое будет устранено в ближайшее время, следите за обновлениями!
{% endhint %}

### 403 Forbidden

Скорее всего, ваша интеграция MCP использует шаблонный токен или удалённый токен. Пожалуйста, убедитесь, что значение токена, используемое вашей интеграцией, в точности совпадает с токеном, отображаемым в панели управления. Для инструментов relay код 403 означает, что ваша организация не имеет доступа к relay.

### 424 Не удалось загрузить образ

Пожалуйста, проверьте ваш репозиторий, имя образа и тег, а также был ли тег отправлен (попросите вашего агента вывести список тегов реестра). Для образов в реестре Edgegap имя образа должно включать ваш проект, например `my-project/my-game-server`.

### Учётные данные реестра недоступны

Получение учётных данных требует специального токена быстрого запуска. [Создайте его в панели управления в разделе **Контейнерный реестр**](https://app.edgegap.com/registry-management/repositories/list), или запушьте в другой реестр (например, Docker Hub, GitHub, AWS ECR, GCP, GitLab).

См. [Внешние реестры](https://docs.edgegap.com/docs/tools-and-integrations/docker/external-registries) для полностью поддерживаемых альтернатив Edgegap Container Registry.

### Запускается локально, но не на Edgegap

Попросите вашего агента проверить конфигурацию сервера или сгенерировать новый Dockerfile. Наиболее частые причины — образ, собранный на Apple Silicon без `docker build --platform linux/amd64`, сервер, прослушивающий другой порт, чем тот, который открыт в версии, или UDP-транспорт, настроенный как TCP.

### Другие ошибки API

Пожалуйста, ознакомьтесь с нашей [Справочник API](https://docs.edgegap.com/ru/docs/api.md) возможные ответы об ошибках для отдельных API-эндпоинтов.

{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
