MCP (Model Context Protocol)
MCP는 AI 도구가 KICC 개발자 센터의 문서를 실시간으로 조회하여, 최신 API 명세와 가이드를 기반으로 답변하게 만드는 표준 프로토콜입니다.
주요 기능
MCP 서버를 연결하면 AI는 다음과 같은 능력을 갖게 됩니다.
- API 명세 실시간 조회: "결제 승인 API URL과 파라미터 알려줘" 등의 질문에 정확한 문서를 찾아 답변합니다.
- 샘플 코드 탐색: 최신 개발 가이드를 참조하여 언어별(Node.js, Java 등) 연동 코드를 생성합니다.
- 오류 해결 가이드: 에러 코드(예: 9999) 발생 시, 문서에 명시된 올바른 처리 방법(망취소 등)을 제시합니다.
도구별 설정 (Configuration)
사용하시는 AI 에디터에 맞춰 설정 파일을 추가해 주세요. 설정 후에는 반드시 에디터를 재시작해야 적용됩니다.
- Cursor
- Windsurf
- VSCode
- Claude Desktop
Cursor는 홈 디렉토리의 mcp.json 파일을 사용합니다.
~/.cursor/mcp.json
{
"mcpServers": {
"easypay": {
"command": "npx",
"args": ["-y", "@kicc/easypay-mcp"]
}
}
}
Windsurf는 아래 경로에 설정 파일을 생성해야 합니다.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"easypay": {
"command": "npx",
"args": ["-y", "@kicc/easypay-mcp"]
}
}
}
VSCode는 프로젝트 또는 워크스페이스 설정 폴더를 사용합니다.
.vscode/mcp.json
{
"servers": {
"easypay": {
"command": "npx",
"args": ["-y", "@kicc/easypay-mcp"]
}
}
}
Claude Desktop은 설정 메뉴(Settings > Developer > Edit Config)를 통해 수정합니다.
claude_desktop_config.json
{
"mcpServers": {
"easypay": {
"command": "npx",
"args": ["-y", "@kicc/easypay-mcp"]
}
}
}
연결 확인
설정을 마치고 프로그램을 완전히 종료 후 재시작하세요. 채팅창 입력 부분에 플러그 아이콘이나 MCP 연결됨 표시가 나타나면 정상적으로 연동된 것입니다.