Интеграция MCP

Серверы MCP предоставляют удобный набор инструментов для устранения неполадок ваших пользовательских ИИ-агентов для программирования.

👉 Поддерживаемые возможности

Новые пользователи — начните с Unity, Unreal Engine, или Godot. Использовать MCP-сервер рекомендуется только после того, как у вас есть рабочий контейнеризованный игровой сервер, загруженный в реестр контейнеров.

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

• Контейнеризация игрового сервера — ваш агент пишет Dockerfile для вашей сборки (или проверяет уже имеющийся) на соответствие требованиям Edgegap, а затем отправляет образ в ваш приватный реестр контейнеров Edgegap.

• Развёртывание выделенного сервера — создайте приложение и версию, разверните их ближе к вашим игрокам и получите данные для подключения.

• Построение CI/CD-пайплайна — тестируйте свои развёртывания и их завершение из системы сборки.

• Устранение неполадок игрового сервера с вашим собственным агентом для программирования: проверка версий приложения и статуса развёртывания, чтение журналов контейнера или воспроизведение неудачного развёртывания.

• Запуск игры по схеме host-client — создайте сеанс relay, если ваша игра построена так, что один игрок является хостом. См. Выделенные серверы или relay? сначала.

Вне области применения / не поддерживается MCP: сборка серверного исполняемого файла для Linux; настройка матчмейкинга; браузер серверов; лобби; управляемые кластеры; частные флотилии; реле; или биллинг.

Если вам нужна помощь, свяжитесь с нами через Discord. Для поддержки по играм в реальном времени см. нашу систему тикетов.

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

• "Напиши Dockerfile для моей серверной сборки three.js, затем отправь его и разверни сервер поблизости от меня."

• "Проверь мой Dockerfile на соответствие требованиям Edgegap и исправь любые проблемы."

• "Моё развёртывание не удалось. Прочитай журналы и скажи мне почему."

• "В моей игре используется сеть host-client. Настрой relay Edgegap для двух игроков."

🚀 Установка

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

1. Установите MCP-сервер для Интеграция MCP или с Интеграция MCP.

2. Сгенерируйте и прикрепите API-токен для вашего агента, чтобы он мог использовать наш MCP-сервер:

Создавайте (и просматривайте) свои секретные токены для Edgegap API в Панель управления — Настройки пользователя / Токены.

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

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

Не интегрируйте конечные точки Edgegap API в игровой клиент, так как ваш API-токен предоставляет неограниченный доступ к вашему аккаунту. См. Интеграция для безопасных клиентских API-эндпоинтов и функций.

Если ваши секретные токены будут скомпрометированы или утекут, удалите их и создайте заново в панели управления.

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

Установите MCP-сервер Edgegap в предпочитаемой вами агентной IDE: CursorVS Code

Claude Code

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

ChatGPT Codex

codex mcp add edgegap --url https://mcp.edgegap.dev/mcp

mcp.json

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

mcp.json

{
    "mcpServers": {
        "Edgegap": {
            "type": "http",
            "url": "https://mcp.edgegap.dev/mcp",
            "headers": {
                "Authorization": "token xxxxxxxx-e458-4592-b607-c2c28afd8b62"
            }
        }
    }
}

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

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

GitHub - edgegap/edgegap-mcp: Edgegap MCP server for LLM agentsGitHub

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

node с использованием пакета npx

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

python с использованием пакета uvx

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

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

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

401: не авторизован

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

403: доступ запрещён

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

424: не удалось загрузить образ

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

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

Если ваш агент не может получить учётные данные реестра, запросите их в панели управления в разделе Реестр контейнеров, или отправьте в другой реестр, из которого Edgegap может выполнить загрузку (Docker Hub, GitHub, AWS ECR, GCP, GitLab). См. Внешние реестры.

Сервер запускается локально, но не на Edgegap

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

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

Пожалуйста, ознакомьтесь с нашими Справочник API возможными ответами об ошибках для отдельных конечных точек API.

Если вам нужна помощь, свяжитесь с нами через Discord. Для поддержки по играм в реальном времени см. нашу систему тикетов.