Claude 또는 Cursor를 Cinevva에 연결하기(MCP 서버)
Cinevva는 Claude, Claude Code, Cursor 또는 모든 MCP 클라이언트가 게임을 제작할 수 있게 해주는 호스팅 MCP 서버를 제공합니다. 이미 사용 중인 AI가 두뇌 역할을 맡아 브라우저 탭 없이도 Cinevva 서버에 있는 게임 파일을 직접 읽고 편집합니다. Cinevva 크리에이터에서도 게임을 열면 세션이 라이브 상태가 됩니다. 그러면 AI가 CC0 라이브러리에서 에셋을 가져오고, 3D 모델을 리깅하고 애니메이션을 적용하며, 스크린샷을 찍고, 실행 중인 게임을 테스트하도록 입력을 시뮬레이션하고, 모든 변경 사항이 화면에 실시간으로 반영되는 동안 미리보기를 새로고침할 수 있습니다.
필요한 것
Cinevva 계정(무료 계정도 사용할 수 있으며, 3D 리깅에는 잔액의 크레딧이 사용됨)과 OAuth를 사용하는 원격 서버를 지원하는 MCP 클라이언트가 필요합니다. 서버 URL은 다음과 같습니다.
https://api.cinevva.com/create/mcp서버는 Streamable HTTP를 사용하며 OAuth 2.0으로 인증합니다. 연결하면 클라이언트가 브라우저에서 Cinevva 로그인 페이지를 엽니다. 한 번 승인하면 클라이언트의 연결이 유지됩니다.
어디서나 편집할 수 있습니다. 라이브로 전환해 확인하고 테스트하세요.
파일 편집에는 연결 외에 아무것도 필요하지 않습니다. 파일 도구는 Cinevva 서버에 있는 게임의 원본을 읽고 쓰므로, Cinevva 탭이 어디에도 열려 있지 않아도 어시스턴트가 버그를 수정하거나 기능을 추가할 수 있습니다. 원하는 게임의 이름을 지정하거나 AI가 게임 목록에서 선택하게 한 다음 요청하면 됩니다.
라이브 전환은 필수가 아니라 기능을 확장하는 방법입니다. cinevva.com/create에서 게임을 열고 미리보기가 로드될 때까지 기다린 다음, 크리에이터 도구 모음에서 외부 에이전트를 클릭하세요. 플러그 아이콘으로 표시되며 작은 화면에서는 "더 보기" 메뉴에도 있습니다. 연결되면 패널이 "에이전트 라이브"로 전환됩니다. 라이브 세션은 AI가 실행 중인 게임을 보고 조작할 수 있게 해줍니다. 스크린샷, 콘솔 로그, 입력 시뮬레이션, 에셋 가져오기, 3D 리깅을 사용할 수 있습니다. 또한 편집이 이 탭을 통해 이루어졌든 헤드리스 방식으로 이루어졌든, 모든 변경 사항이 적용되는 즉시 화면에 표시됩니다. "라이브 세션 중지"를 클릭할 때까지 이후 방문에서도 라이브 연결이 유지됩니다.
list_live_sessions 도구는 연결된 항목을 보여주며, 열려 있는 게임이 정확히 하나라면 해당 게임이 자동으로 선택됩니다.
Claude(claude.ai 및 데스크톱)에서 설정하기
- 설정을 열고 커넥터로 이동한 다음 "사용자 지정 커넥터 추가"를 선택합니다.
- 이름을 Cinevva로 지정하고 URL에
https://api.cinevva.com/create/mcp를 붙여넣습니다. 불필요한 문자가 포함되지 않았는지 확인하세요. URL은 반드시/create/mcp로 끝나야 합니다. - 추가를 클릭한 다음 연결을 클릭합니다. 인증 페이지가 열리면 Cinevva 계정으로 로그인하세요. 게임 탭에 로그인된 계정과 동일한 계정을 사용해야 합니다.
- Claude에게 "내 Cinevva 게임 파일 목록을 보여줘"와 같이 요청해 연결을 확인합니다. 라이브 테스트를 하려면 다른 탭에서 cinevva.com/create의 게임을 열고 도구 모음에서 외부 에이전트를 클릭하세요.
Claude Code에서 설정하기
claude mcp add --transport http cinevva https://api.cinevva.com/create/mcpClaude Code는 처음 사용할 때 OAuth 로그인 절차를 안내합니다. 이후에는 게임 파일을 읽거나 변경하도록 요청하면 됩니다. 브라우저 탭을 열지 않아도 터미널에서 바로 사용할 수 있습니다.
Cursor에서 설정하기
프로젝트별로 사용하려면 .cursor/mcp.json에, 전역으로 사용하려면 ~/.cursor/mcp.json에 다음 내용을 추가하세요.
{
"mcpServers": {
"cinevva": {
"url": "https://api.cinevva.com/create/mcp"
}
}
}Cursor가 서버를 감지하고 브라우저에서 OAuth 인증 절차를 실행한 다음 MCP 설정에 도구 목록을 표시합니다.
도구의 기능
| 그룹 | 도구 | 라이브 세션이 필요한가요? |
|---|---|---|
| 게임 읽기 | list_game_files, read_files, search_game_file | 아니요. 보유한 모든 게임의 서버 사본을 읽습니다 |
| 게임 편집 | edit_files, write_files, delete_files, rename_files | 아니요. 편집 내용은 서버에 적용되고 열려 있는 탭으로 실시간 전송됩니다 |
| 미리보기 | game_ready | 라이브 탭의 미리보기를 새로고침하며, 그렇지 않으면 헤드리스 상태로 저장합니다 |
| 게임 확인 | read_console_logs, take_screenshot | 예 |
| 테스트 | execute_js, simulate_input, get_task_status | 예 |
| 에셋 | search_assets, list_asset_packs, import_asset, search_fonts | 예. 약 7,000개의 CC0 소품, 오디오, HDRI를 제공합니다 |
| 3D 리깅 | rig_model, apply_animation | 예. 크레딧이 사용됩니다 |
| 문서 | list_library_docs, search_library_docs, read_library_docs, list_animations | 예 |
리깅에는 앱 내 Game Creator와 동일한 양의 크레딧이 사용됩니다. 그 외의 모든 기능은 무료입니다. 앱 내 크리에이터는 AI로 이미지, 음악, 음향 효과, 스카이박스도 생성할 수 있습니다. 이러한 도구는 Cinevva 앱 자체에서 제공되며 MCP 커넥터에는 포함되지 않습니다.
문제 해결
설정 중 "제공된 URL에서 MCP 서버를 찾을 수 없습니다"라는 메시지가 표시된다면 대개 URL에 오타가 있거나 끝에 불필요한 문자가 추가된 것입니다. URL은 정확히 https://api.cinevva.com/create/mcp여야 합니다.
"라이브 세션 없음" 메시지는 런타임 도구(스크린샷, 콘솔, 입력, 에셋, 리깅)에서만 표시됩니다. 해당 게임이 라이브 연결을 켠 상태로 브라우저 탭에 열려 있지 않다는 뜻입니다. 게임을 열고 도구 모음에서 외부 에이전트를 클릭한 다음 다시 시도하세요. 파일 도구에는 라이브 세션이 필요하지 않습니다. 세션이 없어도 gameId를 사용해 보유한 모든 게임에서 작동하며, gameId를 전달하지 않으면 게임 목록을 표시합니다.
새로 연결한 후 도구가 멈춘다면 게임 탭을 새로고침해 다시 연결한 다음 list_live_sessions를 호출하세요.
질문이나 문제가 있으면 [email protected]으로 문의하세요.