MODEL CONTEXT PROTOCOL / SAFE DRAFTS
MCP 토큰 발급 · 자동등록
이 페이지 맨 위에서 MCP Bearer 토큰을 발급합니다. 연결 JSON·도구 목록·예시는 아래에서 확인하세요.개발자 계정을 확인하는 중입니다…
필요한 작업 바로 가기
CONNECT / HTTP
MCP 서버 연결
먼저 MCP 토큰을 발급한 뒤, 아래 JSON을 Cursor·Codex·Claude Desktop mcpServers 설정에 붙입니다. dev는 https://dev.koiscore.com/api/mcp, 운영은 https://koiscore.com/api/mcp입니다.
{
"mcpServers": {
"koiscore-publishing": {
"type": "http",
"url": "https://koiscore.com/api/mcp",
"headers": {
"Authorization": "Bearer <KOISCORE_MCP_TOKEN>"
}
}
}
}TOOLS / SCOPE
제공 도구
연결 후 도구 목록에 register_game_draft, update_game_draft, build_sandbox_preview 등이 보입니다. 쓰기 도구는 draft·SKU·릴리즈 이미지를 실제로 변경합니다.
| 도구 | 동작 | 쓰기 |
|---|---|---|
validate_game_registration | 매니페스트 검증 (저장 없음) | 아니오 |
register_game_draft | 게임 초안 등록 | 예 |
get_registered_game | 소유 게임·상품 조회 | 아니오 |
update_game_draft | 메타데이터 수정 | 예 |
list_registered_games | 등록 게임 목록 | 아니오 |
add_game_product | SKU 추가 | 예 |
list_game_products | SKU 목록 | 아니오 |
update_game_product | SKU 수정 | 예 |
remove_game_product | SKU 비활성화 | 예 |
build_sandbox_preview | 샌드박스 미리보기 URL | 아니오 |
build_replay_share_url | 리플레이 공유 URL | 아니오 |
list_replay_games | 리플레이 카탈로그 | 아니오 |
list_release_assets | 릴리즈 에셋 상태 | 아니오 |
update_release_metadata | 스토어 메타데이터 | 예 |
upload_release_asset | 릴리즈 이미지 업로드 | 예 |
GAMES / CRUD
등록 게임·상품 수정 예시
update_game_draft({
"gameId": "example-game",
"runtimeUrl": "https://example-game.koiscore.com/",
"title": {
"ko": "예시 게임",
"en": "Example Game",
"ja": "サンプルゲーム"
},
"genres": ["casual", "puzzle"]
})
add_game_product({
"gameId": "example-game",
"product": {
"sku": "example-game.gem-pack",
"title": { "ko": "젬 팩", "en": "Gem Pack", "ja": "ジェムパック" },
"productType": "soft_currency",
"commerceType": "gem",
"gemPrice": 120,
"grantKey": "koi_gem",
"grantAmount": 500
}
})SANDBOX / PREVIEW
샌드박스 미리보기
build_sandbox_preview는 플레이어 샌드박스 UI와 같은 미리보기를 반환합니다.
RELEASE / EXAMPLE
스토어 데이터·이미지
MCP upload_release_asset와 동일 작업은 콘솔 릴리즈 에셋에서도 할 수 있습니다.
GUARDRAILS / REVIEW
안전 경계
- 등록 게임은 항상
draft로 시작 · 라이브는 운영 검수 후 - 강제 라이브·광고 정산 변경은 MCP 불가
- 토큰은 허용
gameId접두사만 접근