OK Agent

토스페이먼츠 MCP 서버 — 결제 조회·환불·정산 AI 연동

토스페이먼츠 코어 API를 MCP로 연결해, AI 에이전트가 결제 조회, 거래 내역 대사, 정산 조회, 결제 취소(환불)를 할 수 있게 해 주는 무료 오픈소스 서버입니다. 돈이 움직이는 취소는 사람 승인을 거치도록 설계했습니다.

@appmonster/mcp-toss-payments무료 · MIT 오픈소스GitHub →

무엇을 할 수 있나

도구하는 일
toss_get_payment결제 단건 조회(paymentKey/orderId)
toss_list_transactions기간별 거래 내역
toss_list_settlements정산 내역
toss_cancel_payment결제 취소·부분 환불결재 필요

설치 (1분)

Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.

Claude Desktop · Cursor · Windsurf

MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.

{
  "mcpServers": {
    "toss-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-toss-payments"
      ],
      "env": {
        "TOSS_SECRET_KEY": "…"
      }
    }
  }
}

Claude Code

claude mcp add toss-payments -e TOSS_SECRET_KEY=… -- npx -y @appmonster/mcp-toss-payments

필요한 키와 발급처

필수
TOSS_SECRET_KEY — 시크릿 키(test_sk_… 또는 live_sk_…)
선택
OKAGENT_API_KEY — 선택(라이브 키면 강력 권장): 취소 전 카카오톡 승인

발급: 토스페이먼츠 개발자센터. 개발자센터 → API 키 메뉴에서 시크릿 키를 확인합니다. 먼저 test_sk_ 키로 시험해 보세요.

이렇게 시켜 보세요

쓰기 작업은 사람이 결재합니다

결제 취소·부분 환불은(는) 되돌리기 어려운 작업이라 바로 실행되지 않습니다. 기본으로는 바뀔 내용을 먼저 보여주고 대화창에서 확인을 받습니다. 설정에 OKAGENT_API_KEY를 넣으면 승인 요청이 휴대폰 카카오톡으로 와서, 자리를 비워도 탭 한 번으로 승인하거나 거부할 수 있고 기록도 남습니다.

카카오로 무료 시작OK Agent 알아보기월 200건 무료 · 카드 등록 없음

자주 묻는 질문

AI가 환불을 잘못하면요?

취소·환불 도구는 바로 실행되지 않습니다. 금액과 사유를 먼저 보여주고 확인을 받으며, OK Agent 키를 넣으면 휴대폰 카카오톡에서 승인해야만 취소됩니다. 라이브 키인데 승인 설정이 없으면 서버가 시작할 때 경고합니다.

테스트 키로 먼저 해볼 수 있나요?

네. test_sk_ 키를 넣으면 실제 돈이 움직이지 않는 테스트 환경에서 동작합니다.

비용은요?

서버는 무료 오픈소스입니다. OK Agent 승인은 월 200건까지 무료입니다.

함께 쓰면 좋은 서버