> 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/ko/docs/mcp.md).
# MCP 통합
MCP 서버를 통해 AI 코딩 에이전트를 Edgegap에 연결하고, 게임 서버 배포를 위한 문제 해결 도구 모음을 노출하세요.
MCP 서버는 맞춤형 코딩 AI 에이전트를 위한 편리한 문제 해결 도구 모음을 제공합니다.
## 👉 지원 기능
{% hint style="success" %}
**신규 사용자 - 다음부터 시작하세요** [Unity](/ko/unity.md)**,** [Unreal Engine](/ko/unreal-engine.md)**, 또는** [Godot](/ko/godot.md)**.** 컨테이너 레지스트리에 작동하는 컨테이너화된 게임 서버를 업로드한 후에만 MCP 서버 사용을 권장합니다.
{% endhint %}
다음과 같은 경우에 MCP 서버를 사용하세요:
* **게임 서버를 컨테이너화할 때** - 에이전트가 빌드용 Dockerfile을 작성하거나 기존 Dockerfile이 Edgegap의 요구 사항을 충족하는지 확인한 다음, 이미지를 개인 Edgegap 컨테이너 레지스트리에 푸시합니다.
* **전용 서버 배포** - 애플리케이션과 버전을 만들고, 플레이어와 가까운 위치에 배포한 뒤, 연결 정보를 확인합니다.
* **CI/CD 파이프라인 구축** - 빌드 시스템에서 배포와 종료(teardown)를 테스트합니다.
* **게임 서버 문제 해결** 자신의 코딩 에이전트로: 앱 버전과 배포 상태를 검사하거나, 컨테이너 로그를 읽거나, 실패한 배포를 재현합니다.
* **호스트-클라이언트 게임 실행** - 게임이 한 플레이어를 호스트로 하도록 만들어졌다면 릴레이 세션을 만드세요. 먼저 [전용 서버 또는 릴레이?](https://github.com/edgegap/edgegap-mcp#dedicated-servers-or-relays) 를 먼저 확인하세요.
{% hint style="warning" %}
MCP의 범위 밖 / 지원하지 않음: 서버용 Linux 실행 파일 빌드, 매치메이킹 구성, 서버 브라우저, 로비, 관리형 클러스터, 비공개 플릿, 릴레이, 또는 청구.
{% endhint %}
{% hint style="info" %}
도움이 필요하시면 [디스코드를 통해 문의해 주세요](https://discord.gg/MmJf8fWjnt). 실시간 게임 지원은 저희의 [티켓 시스템](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
### 예시 프롬프트
* *"내 three.js 서버 빌드를 위한 Dockerfile을 작성한 다음, 이를 푸시하고 내 근처에 서버를 배포하세요."*
* *"Edgegap용 Dockerfile을 확인하고 문제를 모두 수정하세요."*
* *"배포에 실패했습니다. 로그를 읽고 이유를 알려주세요."*
* *"내 게임은 호스트-클라이언트 네트워킹을 사용합니다. 두 플레이어를 위한 Edgegap 릴레이를 설정하세요."*
## 🚀 설치
MCP 서버 설치는 매우 간단합니다:
1. MCP 서버를 설치하려면 [#popular-agents](#popular-agents "mention") 또는 다음과 함께 [#custom-integration](#custom-integration "mention").
2. 에이전트가 MCP 서버에서 사용할 API 토큰을 생성하고 연결하세요:
Edgegap API용 비밀 토큰을 생성(및 확인)할 수 있는 위치는 [대시보드 - 사용자 설정 / 토큰](https://app.edgegap.com/user-settings?tab=tokens).
각 API 요청마다 비밀 토큰을 HTTP 헤더로 추가하세요(단어를 포함하여 `토큰`):
`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`
{% hint style="danger" %}
**게임 클라이언트에 Edgegap API 엔드포인트를 통합하지 마세요. API 토큰은 계정에 무제한 액세스를 제공하므로. 다음을 참조하세요** [통합](/ko/docs/api/integration.md) **안전한 클라이언트 대상 API 엔드포인트 및 기능을 위한**
{% endhint %}
{% hint style="success" %}
비밀 토큰이 손상되었거나 유출된 경우, 대시보드에서 삭제한 뒤 다시 생성하세요.
{% endhint %}
### 인기 에이전트
선호하는 에이전틱 IDE에 Edgegap MCP 서버를 설치하세요: 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="" %}
원격 Edgegap MCP 서버를 에이전트의 가상화된 환경에 설치하세요(절대 프로젝트에 설치하지 마세요!):
{% code title="npx 패키지를 사용하는 Node" %}
```json
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```
{% endcode %}
{% code title="uvx 패키지를 사용하는 Python" %}
```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 참조](/ko/docs/api.md) 개별 API 엔드포인트의 가능한 오류 응답에 대해.
{% hint style="info" %}
도움이 필요하시면 [디스코드를 통해 문의해 주세요](https://discord.gg/MmJf8fWjnt). 실시간 게임 지원은 저희의 [티켓 시스템](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}