이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

MCP 엔드포인트

모든 AI 클라이언트를 위한 하나의 URL

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를 추가하세요. 데스크톱 앱도 프로젝트를 설정할 때 같은 작업을 합니다.

# 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 · Unity · 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을 작성합니다. 자세한 내용은 인증 가이드에서 확인하세요.

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

CI 또는 브라우저를 열 수 없는 클라이언트의 경우 액세스 토큰 페이지에서 개인 액세스 토큰을 만들어 베어러 토큰으로 전송하세요.

요청 예시

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

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": {}
  }'
AuthorizationBearer YOUR_PERSONAL_ACCESS_TOKEN개인 액세스 토큰 또는 프로젝트 키이며, OAuth 클라이언트는 자체 토큰을 전송합니다
Acceptapplication/json, text/event-stream두 타입 모두: 응답이 스트리밍될 수 있습니다
Content-Typeapplication/jsonJSON-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
Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
↗ Claude Desktop 열기
엔드포인트가 활성 상태입니다. /api/status에서 엔드포인트의 현재 상태를 확인할 수 있습니다.