AI 연동 (MCP)

📘 공통 가이드

AI 연동 (MCP)

메이크샵 개발자센터는 MCP(Model Context Protocol)를 지원합니다.
Claude와 같은 AI 도구에 MCP 서버를 연결하면 API 문서와 가이드를 자연어로 검색하고 질문할 수 있습니다.

MCP란?

MCP(Model Context Protocol)는 AI 모델이 외부 데이터 소스나 도구에 접근할 수 있게 해주는 표준 프로토콜입니다. 개발자센터 MCP 서버를 AI 도구에 연결하면 별도로 문서를 찾아보지 않아도 AI에게 직접 API 스펙이나 가이드 내용을 질문할 수 있습니다.

🔍

API 검색

키워드로 원하는 API를 빠르게 찾고 상세 스펙을 확인합니다.

📖

가이드 조회

개발 가이드 문서를 자연어로 질문하여 필요한 내용을 바로 얻습니다.

⚡

빠른 개발

AI가 API 스펙을 바탕으로 연동 코드 작성을 도와줍니다.

---

연결 정보

항목	내용
프로토콜	Streamable HTTP (MCP)
엔드포인트	https://developer.makeshop.co.kr/mcp
인증	없음 (공개 접근)

---

Claude Desktop 설정

Claude Desktop에서 MCP 서버를 사용하려면 claude_desktop_config.json 파일에 서버 정보를 추가해야 합니다.

ℹ️

설정 파일 위치

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

설정 방법

1

설정 파일 열기

위 경로의 claude_desktop_config.json 파일을 텍스트 에디터로 엽니다. 파일이 없으면 새로 생성합니다.

2

서버 설정 추가

아래 내용을 mcpServers 항목에 추가합니다.

{
  "mcpServers": {
    "makeshop-api-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developer.makeshop.co.kr/mcp"
      ]
    }
  }
}

3

Claude Desktop 재시작

파일을 저장하고 Claude Desktop을 재시작합니다. 이후 대화창에서 MCP 도구가 활성화됩니다.

ℹ️

mcp-remote란?

mcp-remote는 Claude Desktop이 원격 MCP 서버에 연결할 수 있도록 도와주는 프록시 도구입니다. Node.js가 설치되어 있으면 별도 설치 없이 npx로 바로 사용할 수 있습니다.

---

Claude Code (CLI) 설정

Claude Code CLI에서는 claude mcp add 명령어로 MCP 서버를 바로 추가할 수 있습니다. Node.js 없이 직접 HTTP 연결을 지원합니다.

설정 방법

1

MCP 서버 추가

터미널에서 아래 명령어를 실행합니다.

claude mcp add --transport http makeshop-api-docs https://developer.makeshop.co.kr/mcp

전체 프로젝트에서 사용하려면 -s user 옵션을 추가합니다.

claude mcp add --transport http -s user makeshop-api-docs https://developer.makeshop.co.kr/mcp

2

추가 확인

아래 명령어로 MCP 서버가 정상적으로 등록되었는지 확인합니다.

claude mcp list

---

활용 예시

MCP 서버가 연결된 Claude에게 아래와 같이 질문할 수 있습니다.

API 연동 관련 질문

액세스 토큰은 어떻게 발급하나요?

주문 목록 조회 API의 파라미터를 알려줘.

상품 등록 API 연동 코드를 Python으로 작성해줘.

환불 관련 API 찾아줘.

가이드 관련 질문

파트너 등록 절차를 설명해줘.

앱 심사 기준이 뭐야?

환불 처리 흐름을 알려줘.

⚠️

AI 답변 검증 권장

AI의 답변은 MCP 서버에서 제공하는 문서를 기반으로 하지만, 중요한 연동 코드는 반드시 공식 API 문서와 대조하여 검증하시기 바랍니다.

---

지원 및 문의

MCP 연동 관련 문의는 파트너센터 [1:1문의] 를 통해 문의해 주세요.