AutoTransPay 는 원격 MCP(Model Context Protocol) 서버를 제공합니다. Claude Code, Cursor, Claude Desktop 같은 AI 에이전트에 연결하면, 에이전트가 문서를 읽고 API 를 직접 호출하며 여러분의 프로젝트에 맞는 연동 코드를 작성합니다.
바로 시작하기
아래 글을 복사해 AI 에이전트(Claude Code, Cursor, Claude 앱 등)에게 그대로 붙여 넣으세요. atp_test_… 자리에는 테스트 API 키를 넣습니다 — 콘솔 → 개발자 → AI 에이전트 연결 (MCP) 에서 [새 테스트 키로 채우기] 를 누르면 키가 들어간 글이 바로 나옵니다.
AutoTransPay MCP 서버에 연결해줘: https://www.autotranspay.com/api/mcp (Streamable HTTP, 헤더 Authorization: Bearer atp_test_…)
먼저 get_account 로 입금 계좌 등록과 입금 알림 연결 상태를 확인하고, 안 됐으면 내가 콘솔에서 할 일을 먼저 알려줘.
AutoTransPay 연동해줘. 주문 생성 시 입금 대기 주문을 등록하고, 웹훅으로 결제 완료 처리해. 서명 검증 포함, 샌드박스로 끝까지 테스트해줘.
연결 방법과 API 는 https://www.autotranspay.com/docs/mcp 를 읽어.에이전트가 MCP 서버를 연결하고, 프로젝트의 프레임워크를 파악해 주문 등록·웹훅 수신·서명 검증 코드를 만든 뒤, 웹훅 엔드포인트 등록과 ping, 샌드박스 입금으로 끝까지 테스트합니다. 클라이언트에 직접 설정하려면 아래 설정을 보세요.
연결 정보
| 항목 | 값 |
|---|---|
| URL | https://www.autotranspay.com/api/mcp |
| 전송 방식 | Streamable HTTP |
| 인증 | Authorization: Bearer atp_test_… (API 키, X-API-Key 헤더도 허용) |
MCP 서버는 API 키의 권한과 모드를 그대로 따릅니다. 테스트 키는 Free 요금제를 포함해 누구나 연결할 수 있고, 테스트 데이터만 보고 만질 수 있습니다. 운영 키로 연결(조회 전용)은 유료 요금제에서 됩니다. 단, get_account 의 연동 진행 상태(setup_steps)는 콘솔 개요와 같이 두 모드를 함께 판정하므로 운영 키·운영 웹훅이 있는지와 켜져 있는지는 보입니다(주소·키 값은 보이지 않음).
설정
에이전트에게 글을 붙여 넣는 대신 클라이언트에 직접 설정할 때 씁니다. 콘솔의 AI 에이전트 연결 (MCP) → 클라이언트에 직접 설정하기에서 키가 들어간 설정을 복사할 수 있습니다.
claude mcp add --transport http autotranspay https://www.autotranspay.com/api/mcp --header "Authorization: Bearer atp_test_xxx"{
"mcpServers": {
"autotranspay": {
"url": "https://www.autotranspay.com/api/mcp",
"headers": {
"Authorization": "Bearer atp_test_xxx"
}
}
}
}{
"inputs": [
{
"type": "promptString",
"id": "autotranspay-key",
"description": "AutoTransPay API 키",
"password": true
}
],
"servers": {
"autotranspay": {
"type": "http",
"url": "https://www.autotranspay.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:autotranspay-key}"
}
}
}
}{
"mcpServers": {
"autotranspay": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.autotranspay.com/api/mcp",
"--header",
"Authorization:${AUTOTRANSPAY_AUTH}"
],
"env": {
"AUTOTRANSPAY_AUTH": "Bearer atp_test_xxx"
}
}
}
}- Claude Code — 프로젝트 폴더에서 실행한 뒤 Claude Code 에서 /mcp 로 연결 상태를 확인하세요. 팀이 함께 쓰는 .mcp.json 에 넣을 때는 키 대신 "Authorization": "Bearer ${AUTOTRANSPAY_API_KEY}" 처럼 환경 변수를 쓰세요.
- Cursor — 전역 설정(~/.cursor/mcp.json)에 넣는 것을 권장합니다. 프로젝트의 .cursor/mcp.json 에 넣는다면 키가 저장소에 올라가지 않게 .gitignore 에 추가하세요.
- VS Code — .vscode/mcp.json 에 넣으세요. 키는 처음 연결할 때 VS Code 가 입력창으로 묻고 따로 보관하므로, 이 파일은 저장소에 올려도 됩니다. (VS Code 가 물으면 붙여 넣을 API 키:
atp_test_xxx) - Claude 앱 — 1) Claude(웹 또는 데스크톱 앱) → 맞춤 설정(Customize) → 커넥터(Connectors) → 커스텀 커넥터 추가(Add custom connector) 2) 아래 URL 을 넣고, 인증은 No sign-in 을 고릅니다. 3) Request headers 에서 authorization 을 고르고 아래 값을 넣은 뒤 추가합니다. Request headers 는 Claude 의 베타 기능이라 계정에 따라 보이지 않을 수 있습니다. 보이지 않으면 "Claude Desktop 설정 파일" 방식을 쓰세요. (URL:
https://www.autotranspay.com/api/mcp· authorization 값:Bearer atp_test_xxx) - Claude Desktop 설정 파일 — Claude Desktop → 설정 → 개발자 → 설정 편집(claude_desktop_config.json)에 넣고 앱을 다시 시작하세요. Node.js 가 설치돼 있어야 합니다(npx 로 mcp-remote 를 실행해 원격 서버에 연결). 헤더 값을 env 로 넘기는 것은 Windows 에서 인자 속 공백이 깨지는 문제를 피하기 위해서입니다.
- 기타 클라이언트 — 원격(HTTP) MCP 서버와 요청 헤더를 지원하면 같은 URL·헤더로 연결됩니다.
도구
| 도구 | 설명 | 운영 키 |
|---|---|---|
generate_integration |
프로젝트 프레임워크에 맞는 AutoTransPay 연동 코드 전체(주문 등록 클라이언트, 서명 검증 웹훅 핸들러, 멱등 처리(일부 프레임워크는 TODO), 환경변수, 적용 단계, 테스트 절차)를 생성합니다. 결과의 files 를 프로젝트에 쓰고 TODO 를 채우세요. | 허용 |
get_account |
조직·모드·계좌·수집기·웹훅 엔드포인트 설정 상태와 연동 3단계 진행 상태(setup_steps), 다음 할 일(next_steps), 결제 위젯 상태(widget), 공용 수신번호 셀프 연결 상태(shared_number_setup)를 요약합니다. | 허용 |
create_order |
테스트 모드 입금 대기 주문을 등록합니다. 같은 order_number·같은 내용 재등록은 멱등. 결제 위젯이 켜져 있으면 구매자 입금 안내 링크(widget_url)가 함께 나옵니다. widget.return_url 로 위젯 완료 버튼 주소(허용 도메인 안)를 정할 수 있습니다. | 거부 (live_read_only) |
get_order |
주문번호(또는 id)로 주문 상태를 조회합니다(결제 위젯이 켜져 있으면 widget_url 포함). | 허용 |
list_orders |
최근 주문 목록 | 허용 |
cancel_order |
테스트 주문을 취소합니다(이후 입금이 매칭되지 않음). | 거부 (live_read_only) |
list_deposits |
확인 필요(review)·미매칭(unmatched) 입금과 후보 주문 | 허용 |
match_deposit |
테스트 모드 확인 필요 입금을 특정 주문으로 확정합니다(가맹점 웹훅 발송). | 거부 (live_read_only) |
ignore_deposit |
테스트 모드 입금을 주문과 무관한 입금으로 처리합니다. | 거부 (live_read_only) |
simulate_deposit |
테스트 모드 전용 가짜 입금. order_number(그 주문대로 입금) | amount+depositor_name | text(실제 은행 문자 원문) 중 하나. 매칭·웹훅이 실제와 동일하게 동작합니다. | 거부 (livemode_not_allowed — 테스트 키 전용) |
parse_bank_message |
은행 입금 알림 문자를 해석해 금액·입금자·은행·시각을 보여줍니다(저장 안 함). | 허용 |
configure_webhook |
테스트 모드 웹훅 엔드포인트를 등록하고 서명 키(whsec_)를 반환합니다. 반환된 secret 을 AUTOTRANSPAY_WEBHOOK_SECRET 에 저장하세요(다시 볼 수 없음 — 콘솔에서만 재확인). 로컬 개발 서버는 터널(ngrok·cloudflared) 없이 http://localhost(또는 127.0.0.1) 주소 그대로 등록하세요 — 오토페이는 그 주소로 보내지 않으니 get_webhook_request 로 받은 서명 요청을 직접 보내 시험합니다. 운영 웹훅은 콘솔에서 등록합니다. |
거부 (live_read_only) |
send_test_webhook |
서명된 ping 이벤트를 보내 수신 서버의 응답·서명 검증을 점검합니다. endpoint_id 를 생략하면 테스트 모드의 모든 엔드포인트. 로컬 주소 엔드포인트는 보내지 않고 서명된 request 를 돌려줍니다(직접 보내 시험). 테스트 키 전용 — 운영 웹훅 점검은 콘솔 [테스트 전송]으로 하세요. | 거부 (live_read_only) |
get_webhook_request |
터널 없이 로컬 서버에서 웹훅을 시험할 때: 오토페이가 보낼 요청과 똑같이 서명한 요청(url·headers·body)을 돌려줍니다. request 를 그대로 POST 하세요 — body 는 서명 대상이라 한 글자도 바꾸면 안 됩니다. order_number(그 주문의 최신 이벤트, 예: simulate_deposit 뒤 deposit.matched)나 event_id 를 주면 그 이벤트, 없으면 ping. endpoint_id 를 생략하면 가장 최근에 등록한 테스트 엔드포인트. | 거부 (livemode_not_allowed — 테스트 키 전용) |
get_docs |
주제별 문서 본문(마크다운, 표 포함): index, concepts, matching, collectors, webhooks, widget, mcp, api, banks, security, changelog | 허용 |
연동 코드 생성 (generate_integration)
| framework | 생성 파일 | 멱등 처리 |
|---|---|---|
nextjs-app |
lib/autotranspay/client.ts, lib/autotranspay/verify.ts, lib/autotranspay/handlers.ts, app/api/webhooks/autotranspay/route.ts |
핸들러에 포함 (처리 기록 저장만 TODO) |
nextjs-pages |
lib/autotranspay/client.ts, lib/autotranspay/verify.ts, lib/autotranspay/handlers.ts, pages/api/webhooks/autotranspay.ts (bodyParser off) |
핸들러에 포함 (처리 기록 저장만 TODO) |
express |
src/autotranspay/client.ts, src/autotranspay/verify.ts, src/autotranspay/handlers.ts, src/autotranspay/webhook.ts (express.raw) |
핸들러에 포함 (처리 기록 저장만 TODO) |
fastapi |
autotranspay/client.py, autotranspay/webhook.py |
event.id 로 직접 구현 (TODO) |
spring-boot |
src/main/java/com/example/autotranspay/AutoTransPayWebhookController.java |
event.id 로 직접 구현 (TODO) |
laravel |
app/Http/Controllers/AutoTransPayWebhookController.php |
event.id 로 직접 구현 (TODO) |
generic |
AUTOTRANSPAY_INTEGRATION.md |
event.id 로 직접 구현 (TODO) |
결과에는 파일 외에 환경변수 목록·적용 단계·테스트 절차가 함께 들어 있습니다. 생성된 웹훅 핸들러는 서명 검증(원문 기준·5분 허용, 실패하면 400)과 취소 주문 409 응답을 포함합니다. event.id 멱등 처리는 표의 멱등 처리 열처럼 프레임워크마다 다릅니다 — TODO 로 남은 프레임워크는 에이전트가 프로젝트 DB 에 맞게 채워야 합니다. webhook_path 로 수신 경로를 바꿀 수 있습니다(기본 /api/webhooks/autotranspay).
프롬프트
MCP 프롬프트 integrate 를 지원하는 클라이언트에서는 슬래시 명령처럼 불러 한 번에 연동을 시작할 수 있습니다.
예시 프롬프트
AutoTransPay 연동해줘. 주문 생성 시 입금 대기 주문을 등록하고,
웹훅으로 결제 완료 처리해. 서명 검증 포함, 샌드박스로 끝까지 테스트해줘.AutoTransPay 계정 설정 상태 확인해줘. 웹훅이 등록돼 있는지, 테스트 전송이 성공하는지 봐줘.확인 필요 입금 목록 보여줘. 홍길동 50,000원 입금이 어느 주문 후보와 맞는지 정리해줘.이 문자 어떻게 해석되는지 봐줘:
[Web발신]
농협 입금122,500원
09/28 23:14 301-****-2640-41 홍길동 잔액5,428원보안 권장사항
- 테스트 키로 연결하세요. 연동 개발에는 테스트 키로 충분하고, 에이전트가 실수해도 실제 주문·입금에 영향이 없습니다.
- 운영 키로 연결하면 MCP 는 조회 전용입니다. 주문·입금·웹훅 상태를 바꾸는 도구는 서버가 거부합니다(아래 표). 도구 결과에는 입금자명·주문 메모처럼 외부인이 정한 글자가 섞일 수 있어, 에이전트가 그 글에 속아 실제 돈이 걸린 상태를 바꾸는 일(프롬프트 주입)을 원천 차단하기 위해서입니다. 운영 주문 등록은 가맹점 서버(API)나 콘솔 [주문], 확정·웹훅 등록은 콘솔에서 하세요.
- 운영 웹훅의 연결 점검(
ping)은 콘솔 → 개발자 → 웹훅 [테스트 전송]으로 합니다. MCP 의send_test_webhook은 테스트 키 전용입니다.
| 도구 | 운영 키(atp_live_)로 연결했을 때 |
|---|---|
create_order |
거부 (live_read_only) |
cancel_order |
거부 (live_read_only) |
match_deposit |
거부 (live_read_only) |
ignore_deposit |
거부 (live_read_only) |
simulate_deposit |
거부 (livemode_not_allowed — 테스트 키 전용) |
configure_webhook |
거부 (live_read_only) |
send_test_webhook |
거부 (live_read_only) |
get_webhook_request |
거부 (livemode_not_allowed — 테스트 키 전용) |
- MCP 설정 파일에 들어간 키는 저장소에 커밋하지 마세요. 가능하면 클라이언트의 환경 변수 치환 기능을 쓰세요.
- 에이전트가 등록한 웹훅 엔드포인트는 콘솔에서 언제든 확인·삭제할 수 있으며, 모든 수동 확정은 감사 로그에
mcp:<키 ID>로 남습니다.