# MCP(Model Context Protocol) 연동 가이드 > 본 가이드는 STOVE 개발자 센터 연동 시 **Cursor 환경에서 MCP 설정을 통해 글로벌 서버에 연결하는 방법**을 안내합니다. > MCP는 글로벌 모델 컨텍스트 공유를 위한 표준 인터페이스로, 개발사는 STOVE SDK 툴킷 및 API 사용이 필요합니다. {.is-info}

## 1. MCP 연동 개요 --- 스토브 개발자 센터는 CP사의 **빠르고 정확한 연동**을 지원하기 위해 **MCP(Model Context Protocol)** 기반의 **대규모 언어 모델(LLM)** 연동형 AI 개발 도구를 제공하고 있습니다. 이를 통해 연동 과정에서 코드 작성, 가이드 탐색, 설정 구성 등을 보다 효율적으로 진행할 수 있습니다. 본 가이드는 이러한 MCP 기반 LLM 도구를 실제 연동 과정에서 어떻게 활용하는지를 안내합니다.

## 2. 연동 흐름 --- > 본 문서는 Cursor 환경을 기반으로 작성된 가이드이며, 기타 LLM 도구의 연동 방법은 해당 도구의 공식 문서를 참고해주시기 바랍니다. {.is-warning} ① Cursor 환경 진입 ② MCP 글로벌 서버 등록 ③ mcp.json 설정 ④ 연결 상태 확인 ⑤ 연동 완료

## 3. 사전 준비 사항 --- | 항목 | 내용 | |------|------| | 개발 환경 | Cursor 설치된 PC | | 필요 정보 | MCP 서버 주소 (스토브는 ACL 제한을 두지 않으며, 접근하는 환경의 ACL 정책만 확인하면 됩니다)
- https://api.onstove.com/developer-center-mcp |

## 4. Cursor 설치 --- - 공식 사이트에서 [Cursor](https://www.cursor.so/) 다운로드 후 설치 - 웹 브라우저에서 아래의 MCP 자동설정 URL을 입력 하면 Cursor에 STOVE 개발자 센터 MCP가 바로 연결됩니다. `cursor://anysphere.cursor-deeplink/mcp/install?name=StoveDevCenter&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcGkub25zdG92ZS5jb20vZGV2ZWxvcGVyLWNlbnRlci1tY3AifQ%3D%3D `

## 5. MCP 설정 절차 --- ### ① Cursor 설정 진입 - `File > Preferences > Cursor Settings` 메뉴 진입 - MCP 설정 탭을 선택 ![설정](https://static-resource.onstove.com/live/application_no/STATIC/developer-center/Mobile_attach/img_mcp_img01.png)

### ② Global MCP 서버 추가 - `MCP > Add new global MCP server` 클릭 - 아래 정보를 입력 - 서버 주소 : `https://api.onstove.com/developer-center-mcp` ![서버추가](https://static-resource.onstove.com/live/application_no/STATIC/developer-center/Mobile_attach/img_mcp_img02_live.png)

### ③ mcp.json 수정 - 설정 파일 경로 예시 : `~/.cursor/config/mcp.json` - 예시 설정 : ```json { "mcpServers": { "StoveDevCenter": { "url": "https://api.onstove.com/developer-center-mcp" } } } ``` > `https://api.onstove.com/developer-center-mcp`로 접근이 안되시면, 기술담당자에게 문의주세요. {.is-success} ![mcpjson](https://static-resource.onstove.com/live/application_no/STATIC/developer-center/Mobile_attach/img_mcp_img03_live.png)

### ④ 연결 상태 확인 - MCP 연결 상태창에서 **초록불 표시** 확인 - 초록불은 정상 연결을 의미함 > 노란색/빨간색 표시 시, 설정을 다시 확인하거나 방화벽 정책을 점검 {.is-success} ![연결](https://static-resource.onstove.com/live/application_no/STATIC/developer-center/Mobile_attach/img_mcp_img04_live.png)

## 6. 테스트 및 검증 --- - MCP API 호출 테스트로 정상 응답 여부 확인 - 개발자 센터 샘플 프로젝트(MCP 기반) 연동 권장 > 개발사는 mcp.json 설정 이후 MCP 서버와 연결하고, 필요한 연동 작업을 처리할 수 있습니다. > 자세한 내용은 [공식 가이드](https://docs.cursor.com/context/model-context-protocol)를 참조하세요. {.is-warning}

## 7. 연동 시나리오 --- ### 개발 흐름 - ① 개발자가 Cursor를 열고 연동하고자 하는 API 문서 또는 코드 예제를 엽니다. - ② MCP 서버가 연결된 상태에서 필요한 질문을 LLM에게 입력합니다. - 예 : `"스토브 모바일 결제 연동 API에서 상품 조회하는 api 를 알려줘"` - 예 : `"스토브 웹 인증 서비스를 연동하는 코드를 작성해줘"` - 예 : `"Stove PCSDK3에서 연동하는 기본 방법을 알려줘. 언리얼 기반 게임을 만들고 있어."` - 예 : `"Stove PCSDK를 Unity에 초기화까지 연동하였어. 과몰입방지 기능설정을 하고 싶은데 예제코드로 설명해줘. Unity에서 초기화관련 Manager 코드가 구현되어있다는 전제에서 작성해줘."` - 예 : `"스토브 푸시 알림 연동 방법을 알려줘 use StoveDevCenter"` - StoveDevCenter MCP의 사용을 명확하게 하려면 "**use StoveDevCenter**"를 질문에 추가해주세요. - ③ MCP는 해당 문서나 예제에서 관련 정보를 추출하여 답변합니다.

## 8. FAQ --- ### Q. MCP 연결이 안되는 경우? - MCP 주소가 정확한지 확인 - 방화벽/네트워크 설정 확인 - `mcp.json` 문법 오류 확인
### Q. Cursor에서 LLM 응답이 비정확해요. - MCP 연결 상태 확인 - LLM에게 더 구체적인 질문을 던지세요. * 예 : `"스토브 모바일 결제 연동 API에서 상품 조회하는 api 를 알려줘"`

## 9. 기타 AI 도구 가이드 --- - [Cursor 공식 가이드](https://docs.cursor.com/context/model-context-protocol) - [VS Code 공식 가이드](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) - [Windsurf 공식 가이드](https://docs.windsurf.com/windsurf/mcp) - [Claude Desktop 공식 가이드](https://modelcontextprotocol.io/quickstart/user) * Claude Desktop과 STOVE 개발자 센터 MCP 연결을 위해, npm mcp-remote 설치와 claude_desktop_config.json 설정 해주세요. * npm mcp-remote 설치 방법 ```json npm install -g mcp-remote ``` * Claude Desktop MCP 설정 방법 설정 파일 경로 예시 : `C:\Users\사용자\AppData\Roaming\Claude\claude_desktop_config.json` ```json { "mcpServers": { "StoveDevCenter": { "command": "npx", "args": ["mcp-remote", "http://api.onstove.com/developer-center-mcp", "--allow-http"] } } } ``` - [Visual Studio 2022](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)