페이플 MCP를 연결하면 MCP를 지원하는 AI 코딩 도구가 페이플 개발자센터 문서를 직접 찾아 읽고, 그 문서를 근거로 결제 연동 코드를 작성합니다.
페이플 MCP는 무엇입니까
MCP(Model Context Protocol)는 AI 도구가 바깥의 자료나 기능에 연결되는 표준 방식입니다. 페이플 MCP는 AI 코딩 도구와 페이플 개발자센터 문서를 이어 주는 연결 통로입니다.
페이플 MCP 연결 구조 3단계: 1 AI 코딩 도구(개발자가 질문합니다), 2 페이플 MCP(맞는 문서를 찾습니다), 3 개발자센터 문서(근거로 답합니다)
이번 달 개발자센터를 새로 단장하면서 AI가 읽기 좋은 문서 목차(llms.txt)와 문서별 Markdown 복사 기능을 넣었습니다. 그때는 개발자가 문서를 골라 AI에게 붙여 넣어야 했습니다. 페이플 MCP를 연결하면 이 과정이 필요 없습니다. 개발자가 질문하면 AI가 스스로 맞는 문서를 찾아 읽고, 그 문서를 근거로 답과 코드를 만듭니다.
할 수 있는 일 4가지
AI 코딩 도구에 연결된 페이플 MCP 예시 화면: 문서 목차 보기, 근거 문서 찾기, 문서 원문 읽기, 예시 코드 받기 4가지 도구
1.
문서 목차 보기: 국내 카드·계좌 결제, 정기(빌링) 결제, 링크결제, 해외 카드 결제, 정산지급대행, 대사, 응답 코드 등 개발자센터 문서 22개의 목록과 요약을 봅니다.
2.
근거 문서 찾기: 질문에 맞는 문서의 제목과 주소를 찾습니다.
3.
문서 원문 읽기: 요청·응답 파라미터 표, 응답 코드, 예시가 담긴 문서 원문을 그대로 읽습니다. 필요한 부분만 골라 읽을 수도 있습니다.
4.
예시 코드 받기: 요청·응답 JSON과 결제창 호출 스크립트 같은 예시 코드만 따로 받습니다.
이렇게 물어보면 됩니다
AI 코딩 도구 예시 화면: 우리 서비스에 카드 정기결제를 붙여 줘 라는 질문에 국내 카드 정기(빌링) 결제 문서를 기준으로 결제창으로 카드를 등록해 빌링키를 받고 서버에서 빌링키로 승인을 요청한다고 답하고, 근거 문서 두 개를 함께 보여 줌
평소 쓰는 말로 물어보면 됩니다. 예를 들면 다음과 같습니다.
•
"우리 서비스에 카드 정기결제를 붙여 줘"
•
"결제창 색상을 우리 브랜드 색으로 바꾸는 방법 알려 줘"
•
"결제 결과로 받은 응답 코드가 무슨 뜻인지 찾아 줘"
•
"외국인 고객 해외카드 결제를 연동하려면 어떤 문서를 봐야 해?"
AI는 먼저 질문에 맞는 문서를 찾고, 그 문서를 읽은 뒤 답합니다. 답에는 근거가 된 문서가 함께 나오므로, 개발자가 원문을 바로 열어 확인할 수 있습니다.
문서에 있는 것만 씁니다
페이플 MCP가 AI에게 함께 주는 원칙 3가지: 문서 하나 기준(국내·해외·정산지급대행 키와 응답 코드를 섞지 않음), 없는 값은 확인(문서에 없는 파라미터는 만들지 않고 확인을 요청), 키는 서버에서만(custKey는 서버에서만, 금액은 서버에서 다시 확인)
결제 연동에서는 그럴듯해 보이는 코드보다 문서와 정확히 맞는 코드가 중요합니다. 페이플 MCP는 연결될 때 AI에게 다음 원칙을 함께 전달합니다.
•
문서 하나 기준: 국내, 해외, 정산지급대행은 키와 응답 코드가 다릅니다. 고른 문서 하나를 기준으로 구현하고 서로 섞지 않습니다.
•
없는 값은 확인: 문서에 없는 파라미터나 값을 만들어 넣지 않고, 확인이 필요하다고 알려 줍니다.
•
키는 서버에서만: custKey처럼 밖으로 드러나면 안 되는 키는 서버에서만 쓰고, 테스트 키와 운영 키를 나눕니다. 결제 금액은 서버에서 다시 확인합니다.
AI가 만든 코드도 먼저 테스트 환경에서 확인해 주세요. 개발자센터의 테스트 정보로 계약 전에도 연동을 미리 해 볼 수 있습니다.
자주 묻는 질문
Q. 개발자센터의 llms.txt와는 무엇이 다른가요?
llms.txt는 AI가 읽기 좋게 정리한 문서 목차입니다. 개발자가 필요한 문서를 골라 AI에게 건네야 합니다. 페이플 MCP를 연결하면 AI가 목차에서 맞는 문서를 직접 찾아 원문까지 읽습니다.
Q. 개발자센터의 AI 어시스턴트 지니봇과는 무엇이 다른가요?
지니봇은 개발자센터 화면 안에서 묻고 답하는 도우미입니다. 페이플 MCP는 개발자가 코드를 쓰는 AI 코딩 도구 안에서 페이플 문서를 쓸 수 있게 해 줍니다. 코드를 쓰던 자리에서 바로 문서를 찾고 코드에 반영할 수 있습니다.
Q. 페이플 MCP가 결제 데이터나 키를 다루나요?
아닙니다. 페이플 MCP는 공개된 개발자센터 문서를 찾아 읽는 역할만 합니다. 결제를 요청하거나 거래 내역을 조회하지 않습니다.
Q. AI가 만든 코드를 바로 운영에 써도 되나요?
시작하기
MCP를 지원하는 AI 코딩 도구에 아래 주소를 MCP 서버로 추가하면 됩니다. 따로 가입하거나 키를 받지 않아도 바로 연결됩니다.
https://mcp.payple.kr/mcp
Plain Text
복사
Claude 앱(웹·데스크톱)에 등록하기
Claude 앱에 페이플 연결하기 예시 화면: Add custom connector 창에 이름 페이플, Remote MCP server URL https://mcp.payple.kr/mcp, No sign-in을 넣고 Add를 누르면 Connectors 목록에 페이플이 연결됨으로 표시되고 도구 4가지를 쓸 수 있음
1.
왼쪽 아래 메뉴에서 Customize > Connectors를 엽니다.
2.
Add custom connector를 누릅니다.
3.
4.
Add를 누르면 연결이 끝납니다. 이제 대화에서 페이플 결제 연동을 물어보면 Claude가 페이플 문서를 찾아 답합니다.
Team·Enterprise 요금제는 조직 관리자가 Organization settings > Connectors에서 한 번 추가하면 구성원 모두 쓸 수 있습니다.
Claude Code에서는 터미널에 다음 한 줄을 입력합니다.
claude mcp add --transport http payple https://mcp.payple.kr/mcp
Bash
복사
Cursor처럼 설정 파일(mcp.json)로 연결하는 도구는 다음과 같이 적습니다. 도구마다 메뉴 이름은 다르지만, MCP 서버 주소에 위 주소를 넣는 것은 같습니다.
{
"mcpServers": {
"payple": { "url": "https://mcp.payple.kr/mcp" }
}
}
JSON
복사