헥토파이낸셜 - MCP 서버 연동 가이드

헥토파이낸셜 MCP Beta

헥토파이낸셜의 연동 문서를 쉽고 빠르게 검색·조회할 수 있는 MCP 서버입니다.

📖 MCP란?

Model Context Protocol의 줄임말로, "AI를 위한 USB-C 포트"라고 불리며, LLM이 외부 데이터와 도구에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜입니다.

이 MCP 서버는 헥토파이낸셜의 연동 문서를 검색하고, 개발자들이 필요한 정보를 빠르게 찾을 수 있도록 도와줍니다. 전자결제(PG), 내통장결제, 간편현금결제, 화이트라벨 서비스 관련 문서를 제공합니다.

도구	설명
`search_docs`	키워드 및 카테고리를 통해 헥토파이낸셜 연동 문서를 검색합니다. 카테고리(PG, 내통장결제, 간편현금결제, 화이트라벨)를 명시하면 검색 정확성이 향상됩니다.
`list_docs`	전체 연동 문서 목록을 조회합니다. 카테고리별(PG, 내통장결제, 간편현금결제, 화이트라벨) 필터링을 제공합니다.
`get_docs`	문서 ID 또는 파일명으로 특정 문서의 전체 내용을 조회합니다.

아래와 같은 MCP 클라이언트를 통해 쉽게 서버를 연동할 수 있습니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

🔗 원클릭 설정: Cursor에서 바로 설정하기

또는 프로젝트 루트에 .cursor/mcp.json 파일을 생성:

{
  "mcpServers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}

~/.claude_desktop_config.json 파일에 추가:

{
  "mcpServers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}

🔗 원클릭 설정: VS Code에서 바로 설정하기

또는 VS Code 설정에서 MCP 서버를 수동으로 추가할 수 있습니다.

다른 MCP 클라이언트에서도 다음과 같은 설정을 사용할 수 있습니다:

{
  "mcpServers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}

MCP 클라이언트(Cursor, Claude Desktop 등)에서 다음과 같은 질문들을 시도해보세요

HectoFinancial MCP 시연 영상

⌨️헥토파이낸셜 신용카드 결제 연동 방법 알려줘

⌨️내통장결제 API 호출 어떻게 해?

⌨️간편현금결제 휴대폰 인증 구현법 찾아줘

⌨️화이트라벨 서비스 사용법 알려줘

⌨️PG에서 결제 승인 후 noti 처리는 어떻게 해?

⌨️내통장결제 API 호출 어떻게 해?

⌨️내통장결제에서 테스트 환경 URL과 상용 환경 URL 차이점은?

⌨️PG에서 결제 취소 API 사용법은?

This project is licensed under the MIT License.