AI 도구 활용하기

포트원 MCP (Model Context Protocol) 서버

포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. (GitHub 저장소 바로가기)

포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여, AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.

1. MCP 서버 등록하기

포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.

Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.

{
  // ...

  "mcpServers": {
    // ...

    "portone-mcp-server": {
      "command": "uvx",
      "args": ["portone-mcp-server@latest"]
    }
  }
}

설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.

2. MCP 서버 활용하기

사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.

개발 관련 프롬프트 예시

• "포트원 V2로 카카오페이 결제창 호출을 구현해줘"
• "포트원 문서 읽고 V1 페이팔 결제창 호출하는 코드 작성해줘"
• "포트원 V2 Python 서버 SDK 사용해서 결제건 조회하는 스크립트 작성해줘"
• "Kotlin으로 포트원 V2 웹훅 검증하는 코드 작성해줘"
• "Java로 포트원 서버 SDK 사용해서 포트원 V2 결제 연동하는 법 알려줘"
• "포트원 파트너정산 자동화 서비스에 파트너 등록하는 코드를 타입스크립트로 구현해줘"

전반적인 질의 예시

• "포트원 문서 읽고 V2와 V1의 차이점을 설명해줘"
• "포트원 V2가 지원하는 PG사 목록 보여줘"
• "포트원 API의 하위호환성 정책 설명해줘"
• "포트원 파트너정산 자동화 서비스가 제공하는 기능들을 요약해줘"

llms.txt 표준 지원

포트원 개발자센터 웹사이트는 llms.txt 표준을 준수하며, LLM이 문서 정보를 쉽게 조회할 수 있도록 지원하고 있습니다.

• llms.txt: LLM을 위한 가이드 및 문서 목차를 포함합니다.
• llms-full.txt: llms.txt에 더해 모든 문서 내용을 추가로 포함합니다.
• llms-small.txt: llms.txt에 더해 모든 문서의 메타 정보만 추가로 포함합니다.

llms.txt, llms-small.txt를 사용하는 AI 어시스턴트의 프롬프트에 포함하거나, llms-full.txt를 파일로 업로드해 질의하는 방식으로도 활용이 가능합니다.

LLM 전용 개발자센터 문서 디렉터리

포트원 개발자센터 내 문서들을 마크다운 형식으로 담고 있는 LLM 전용 문서 디렉터리를 제공합니다.

해당 디렉터리는 포트원 MCP 서버와 같은 포트원 관련 도구를 만드는 데 사용될 수 있으며,

Cursor, Windsurf, Claude Code와 같이 코드베이스 맥락을 자동으로 분석하는 AI 도구를 사용하는 경우 해당 디렉터리를 해당 도구로 열어 질의하는 방식으로도 활용하실 수 있습니다.

이 경우 위 AI 도구들이 제공하는 임베딩 기반 색인과 RAG (Retrieval Augmented Generation) 검색이 자동적으로 적용되어 일부 질의에 대해 보다 원활하게 원하는 결과를 얻으실 수 있습니다.