# MCP 엔드포인트 — AI Game Developer

ai-game.dev를 통해 모든 MCP 클라이언트를 Unity, Unreal Engine, Godot에 연결하세요. Claude, Cursor, Copilot, Gemini 등에 필요한 엔드포인트 URL, OAuth 로그인, 프로젝트 키, 토큰과 설정을 제공합니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/mcp-endpoint-info).

MCP 엔드포인트

MCP 호환 AI 클라이언트를 `https://ai-game.dev/mcp`로 지정하면 현재 열어 둔 게임 엔진(Unity, Unreal Engine, Godot)에 연결됩니다. 클라이언트가 연결될 때 도구, 프롬프트, 리소스가 협상되므로 복사할 스키마가 없습니다.

엔드포인트 URL

`https://ai-game.dev/mcp`

전송 방식

Streamable HTTP

로그인

OAuth 2.1 인증 프로젝트 키 액세스 토큰

프로토콜

MCP · JSON-RPC 2.0

## 가장 빠른 방법: setup-mcp가 설정을 작성하게 하세요

모든 엔진 CLI는 클라이언트에 맞는 설정 파일을 작성합니다. 프로젝트에 고정된 URL과 프로젝트 키를 넣으므로 클라이언트가 로그인 없이 즉시 연결됩니다. 대신 브라우저로 로그인하는 URL만 담은 설정을 원하면 `--oauth`를 추가하세요. 데스크톱 앱도 프로젝트를 설정할 때 같은 작업을 합니다.

```bash
# Unity — writes the pinned URL + a project key for Claude Code
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Unreal Engine (the project path is a flag)
unreal-mcp-cli setup-mcp cursor --path ./MyUnrealProject

# Godot, URL-only config that signs in over OAuth
godot-cli setup-mcp gemini ./MyGodotProject --oauth
```

클라이언트별 정확한 명령이 포함된 설치 가이드: [Unreal Engine](https://ai-game.dev/ko/engines/unreal) · [Unity](https://ai-game.dev/ko/engines/unity) · [Godot](https://ai-game.dev/ko/engines/godot)

## 로그인

### OAuth 2.1 — 브라우저 로그인, 붙여넣을 필요 없음

MCP 권한 부여를 지원하는 클라이언트는 첫 연결 시 브라우저를 통해 로그인하고(PKCE 및 동적 클라이언트 등록을 사용하는 권한 부여 코드), 자체 토큰을 보관합니다. 설정에는 URL만 들어갑니다. 엔진 CLI의 `login` 명령은 대신 기기 코드 흐름을 사용합니다. 브라우저에서 승인할 코드를 출력합니다.

### 프로젝트 키 — setup-mcp가 작성하는 것

프로젝트 키(`agd_pk_…`)는 하나의 프로젝트에 속하며, 고정된 URL과 함께 베어러 토큰으로 전송됩니다. `setup-mcp`가 이를 생성해 클라이언트 설정에 기록하므로 클라이언트는 브라우저 로그인 없이 작동합니다. 계정에서 프로젝트를 제거하면 해당 키는 더 이상 작동하지 않습니다.

### `/mcp` 또는 `/mcp/p/<pin>`

`https://ai-game.dev/mcp`은 기본 엔드포인트로, 서버가 연결된 편집기 중 하나로 라우팅합니다. `https://ai-game.dev/mcp/p/<pin>`는 하나의 프로젝트에 고정되어 여러 편집기가 열려 있어도 항상 해당 프로젝트의 편집기에 연결됩니다. `setup-mcp`가 고정 URL을 작성합니다. 자세한 내용은 [인증 가이드](https://ai-game.dev/docs/auth)에서 확인하세요.

### 개인 액세스 토큰 — CI 및 스크립트용

CI 또는 브라우저를 열 수 없는 클라이언트의 경우 [액세스 토큰 페이지](https://ai-game.dev/app/api-keys)에서 개인 액세스 토큰을 만들어 베어러 토큰으로 전송하세요.

## 요청 예시

모든 요청은 Streamable HTTP를 통한 JSON-RPC 2.0 메시지입니다. 크거나 점진적인 응답은 Server-Sent Events로 스트리밍되므로 `Accept`에 두 콘텐츠 타입을 모두 전송하세요. 다음 `curl`은 액세스 토큰으로 연결된 편집기의 도구를 나열합니다:

```bash
curl -N -X POST "https://ai-game.dev/mcp" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
```

`Authorization` `Bearer YOUR_PERSONAL_ACCESS_TOKEN` 개인 액세스 토큰 또는 프로젝트 키이며, OAuth 클라이언트는 자체 토큰을 전송합니다

`Accept` `application/json, text/event-stream` 두 타입 모두: 응답이 스트리밍될 수 있습니다

`Content-Type` `application/json` JSON-RPC 본문

`method` `"initialize" | "tools/list" | "tools/call" | …` 표준 MCP 메서드

## 클라이언트용 설정

클라이언트를 선택하고 설정을 복사하세요. 첫 번째 탭은 OAuth로 로그인하며, 액세스 토큰 탭은 CI용입니다. MCP를 지원하는 클라이언트라면 모두 작동합니다. 여기에 14개 클라이언트가 나열되어 있습니다.

아래의 모든 URL은 기본 https://ai-game.dev/mcp입니다. 클라이언트를 하나의 프로젝트에 고정하려면 https://ai-game.dev/mcp/p/<pin>를 사용하세요. setup-mcp가 고정 URL을 대신 작성합니다.

14

```text
Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
```

[↗ Claude Desktop 열기](https://claude.ai/download)

**엔드포인트가 활성 상태입니다.** [/api/status](https://ai-game.dev/api/status)에서 엔드포인트의 현재 상태를 확인할 수 있습니다.

---

Source (HTML): https://ai-game.dev/ko/mcp-endpoint-info

Machine-translated (ko) from the English page: https://ai-game.dev/mcp-endpoint-info