> 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](/ru/unity.md)**,** [Unreal Engine](/ru/unreal-engine.md)**, или** [Godot](/ru/godot.md)**.** Использовать MCP-сервер рекомендуется только после того, как у вас есть рабочий контейнеризованный игровой сервер, загруженный в реестр контейнеров.
{% endhint %}
Используйте наш MCP-сервер, когда:
* **Контейнеризация игрового сервера** — ваш агент пишет Dockerfile для вашей сборки (или проверяет уже имеющийся) на соответствие требованиям Edgegap, а затем отправляет образ в ваш приватный реестр контейнеров Edgegap.
* **Развёртывание выделенного сервера** — создайте приложение и версию, разверните их ближе к вашим игрокам и получите данные для подключения.
* **Построение CI/CD-пайплайна** — тестируйте свои развёртывания и их завершение из системы сборки.
* **Устранение неполадок игрового сервера** с вашим собственным агентом для программирования: проверка версий приложения и статуса развёртывания, чтение журналов контейнера или воспроизведение неудачного развёртывания.
* **Запуск игры по схеме host-client** — создайте сеанс relay, если ваша игра построена так, что один игрок является хостом. См. [Выделенные серверы или relay?](https://github.com/edgegap/edgegap-mcp#dedicated-servers-or-relays) сначала.
{% hint style="warning" %}
Вне области применения / не поддерживается MCP: сборка серверного исполняемого файла для Linux; настройка матчмейкинга; браузер серверов; лобби; управляемые кластеры; частные флотилии; реле; или биллинг.
{% endhint %}
{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
### Примеры запросов
* *"Напиши Dockerfile для моей серверной сборки three.js, затем отправь его и разверни сервер поблизости от меня."*
* *"Проверь мой Dockerfile на соответствие требованиям Edgegap и исправь любые проблемы."*
* *"Моё развёртывание не удалось. Прочитай журналы и скажи мне почему."*
* *"В моей игре используется сеть host-client. Настрой relay Edgegap для двух игроков."*
## 🚀 Установка
Установка MCP-сервера очень проста:
1. Установите MCP-сервер для [#popular-agents](#popular-agents "mention") или с [#custom-integration](#custom-integration "mention").
2. Сгенерируйте и прикрепите API-токен для вашего агента, чтобы он мог использовать наш MCP-сервер:
Создавайте (и просматривайте) свои секретные токены для Edgegap API в [Панель управления — Настройки пользователя / Токены](https://app.edgegap.com/user-settings?tab=tokens).
Добавляйте свой секретный токен к каждому API-запросу в виде HTTP-заголовка (включайте слово `token`):
`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`
{% hint style="danger" %}
**Не интегрируйте конечные точки Edgegap API в игровой клиент, так как ваш API-токен предоставляет неограниченный доступ к вашему аккаунту. См.** [Интеграция](/ru/docs/api/integraciya.md) **для безопасных клиентских API-эндпоинтов и функций.**
{% endhint %}
{% hint style="success" %}
Если ваши секретные токены будут скомпрометированы или утекут, удалите их и создайте заново в панели управления.
{% endhint %}
### Популярные агенты
Установите MCP-сервер Edgegap в предпочитаемой вами агентной IDE: CursorVS Code
#### Claude Code
```bash
claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp \
-H "Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62" --scope user
```
#### ChatGPT Codex
```bash
codex mcp add edgegap --url https://mcp.edgegap.dev/mcp
```
#### mcp.json
Большинство агентных IDE также поддерживают интеграцию через вставку JSON-конфигурации:
{% code title="mcp.json" %}
```json
{
"mcpServers": {
"Edgegap": {
"type": "http",
"url": "https://mcp.edgegap.dev/mcp",
"headers": {
"Authorization": "token xxxxxxxx-e458-4592-b607-c2c28afd8b62"
}
}
}
}
```
{% endcode %}
### Пользовательская интеграция
Официальный репозиторий — единый источник истины для пользовательской интеграции нашего MCP-сервера:
{% embed url="" %}
Установите удалённый MCP-сервер Edgegap в виртуализированную среду вашего агента (никогда — в ваш проект!):
{% code title="node с использованием пакета npx" %}
```json
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```
{% endcode %}
{% code title="python с использованием пакета uvx" %}
```json
{
"command": "uvx",
"args": ["mcp-proxy", "--transport", "streamablehttp", "https://mcp.edgegap.dev/mcp"]
}
```
{% endcode %}
## 🚨 Устранение неполадок
Ознакомьтесь с распространёнными кодами ошибок и узнайте, как разблокировать свою интеграцию.
### 401: не авторизован
Скорее всего, ваша интеграция MCP неправильно передаёт заголовок Authorization.
### 403: доступ запрещён
Скорее всего, ваша интеграция MCP использует шаблонный токен или удалённый токен. Пожалуйста, убедитесь, что значение токена, используемое вашей интеграцией, в точности совпадает с токеном, отображаемым в панели управления.
### 424: не удалось загрузить образ
Edgegap не смог загрузить ваш контейнерный образ. Проверьте репозиторий, имя образа и тег, а также был ли тег отправлен (попросите вашего агента вывести список тегов реестра). Для образов в реестре Edgegap имя образа должно включать ваш проект, например `my-project/my-game-server`.
### Учётные данные реестра недоступны
Если ваш агент не может получить учётные данные реестра, [запросите их в панели управления в разделе **Реестр контейнеров**](https://app.edgegap.com/registry-management/repositories/list), или отправьте в другой реестр, из которого Edgegap может выполнить загрузку (Docker Hub, GitHub, AWS ECR, GCP, GitLab). См. [Внешние реестры](https://docs.edgegap.com/docs/tools-and-integrations/docker/external-registries).
### Сервер запускается локально, но не на Edgegap
Попросите вашего агента проверить конфигурацию сервера или сгенерировать новый Dockerfile. Наиболее частые причины — образ, собранный на Apple Silicon без `docker build --platform linux/amd64`, сервер, слушающий на другом порту, чем тот, который экспонирует версия, или транспорт UDP, настроенный как TCP.
### Другие ошибки API
Пожалуйста, ознакомьтесь с нашими [Справочник API](/ru/docs/api.md) возможными ответами об ошибках для отдельных конечных точек API.
{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}