AI 에이전트 연결하기

AI 코딩 에이전트에게 주소 하나(https://app.tgpaycrypto.com/mcp)만 주면 결제 연동을 대신 만들어 줘요. API 문서를 읽고, 가맹점 앱을 만들고, webhook을 붙이고, 코드까지 써요. 새 앱은 봇에서 버튼 하나로 한 번만 승인하면 돼요. 터미널도 필요 없고, API 토큰을 손으로 복사할 일도 없어요.

이 주소는 MCP 서버예요(Model Context Protocol — 서비스를 AI 에이전트에 연결하는 표준이에요). 브라우저로 열면 설정 방법을 스스로 알려 줘요.

연결하기

쓰는 도구에 맞는 줄을 골라 주세요.

• 에이전트 채팅 어디서나 — 이 프롬프트를 그대로 붙여 넣어요.

  Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.

  앱에서는 더보기 → Merchant API → AI 에이전트 연결에 복사하기 좋게 놓여 있어요.
• Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
• claude.ai와 Claude Desktop — 설정 → 커넥터 → 커스텀 커넥터 추가에서 이 URL을 붙여 넣어요.
• ChatGPT와 다른 MCP 클라이언트 — 같은 URL로 커스텀 커넥터를 추가해요.

API 토큰을 미리 만들어 둘 필요는 없어요. 다음 단계에서 에이전트가 자기 토큰을 받아요. 앱을 이미 직접 만들어 뒀다면 그 토큰을 에이전트에게 주고 연동부터 시작하면 돼요.

앱 승인하기

1. 에이전트에게 결제를 붙여 달라고 하세요. 문서를 읽고 승인을 요청해요.
2. 에이전트가 t.me 링크를 줘요. 열면 봇이 무엇을 요청하는지 보여 줘요. ✅ 앱 만들고 토큰 발급을 누르세요.
3. 에이전트로 돌아가세요. 몇 초 안에 토큰을 받아서 나머지 연동을 스스로 끝내요.

링크는 언제나 내 에이전트에서 와요. 봇이 먼저 보내는 일은 없어요. 링크를 열기 전까지는 봇도 그 에이전트가 누구 계정을 묻는지 몰라요. 링크는 한 번만 쓸 수 있어요. 누르기 전에 링크가 만료되면 에이전트에게 처음부터 다시 해 달라고 하세요. 승인하기 전에는 아무것도 만들어지지 않아요.

❌ 거절을 눌러도 마찬가지로 아무것도 만들어지지 않고, 그 요청은 거기서 끝나요. 마음이 바뀌면 에이전트에게 새로 요청하게 하면 돼요.

⚠️ 내가 시작한 요청만 승인하세요

연결 요청은 내 계정에 앱을 만들겠다는 요청이에요. 방금 내 에이전트에게 결제를 붙여 달라고 했을 때만 승인하세요. 채팅이나 전달된 메시지, 모르는 사람의 “고객센터”처럼 다른 경로로 링크가 왔다면 거절하세요.

피해 범위는 설계로 묶여 있어요. 에이전트의 토큰은 돈을 받을 수는 있어도 내보내지는 못해요(아래 참고). 그래도 내가 부탁하지 않은 앱이 내 계정에 있을 이유는 없어요.

에이전트가 할 수 있는 일과 못 하는 일

에이전트가 받는 토큰은 권한 제한 토큰이에요.

• 할 수 있는 일 — 청구서와 구독 요금제 만들기, 잔액과 시세, 통계 읽기, webhook 주소 지정하기.
• 못 하는 일 — 송금, 송금 링크 만들기, 환불. 앱 잔액에서 돈이 나가는 일은 전부 전체 권한 토큰이 있어야 하고, 그 토큰은 앱 안에 그대로 있어요.

이렇게 나눈 건 일부러예요. 에이전트 토큰은 설정 파일과 모델 컨텍스트에 남는데, 그쪽은 내 서버보다 무르니까요. 하나 새어 나가도 webhook 주소가 엉뚱해지는 정도지, 잔액이 털리지는 않아요. 에이전트에게 토큰이 발급될 때마다, 그리고 앱의 webhook 주소가 바뀔 때마다 봇이 알려 드려요.

에이전트의 토큰을 보거나 없애려면 더보기 → Merchant API를 열고 그 앱의 권한 제한 토큰을 보세요. 폐기를 누르면 그 자리에서 못 쓰게 돼요. 앱과 잔액, 결제 내역은 그대로 남아요.

webhook 서명에는 기본 토큰이 필요해요

에이전트가 webhook 주소를 내 서버로 맞춰 줄 수는 있어도, 거기 도착한 걸 검증해 줄 수는 없어요. 전송은 앱의 기본 토큰으로 서명되는데, 그 토큰은 에이전트가 볼 수 없거든요. 얌전한 에이전트라면 검증 코드를 써 두고 TGPAY_WEBHOOK_TOKEN 같은 자리를 남겨 둘 거예요.

채워 넣으려면 더보기 → Merchant API를 열고 에이전트가 만든 앱을 찾아 토큰 새로 발급을 누른 다음 보이는 값을 복사하세요. 한 번만 보여 줘요. 서버의 환경 변수에 넣고, 에이전트 설정이나 저장소에는 넣지 마세요. 새로 발급해도 에이전트의 권한 제한 토큰은 그대로라서 연동은 계속 돌아가요.

새로 발급하는 순간 서명이 새 토큰으로 바뀌어요. 그러니 첫 결제를 받은 뒤가 아니라, 서비스를 열기 전에 미리 해 두세요.

다음 글

• 개발자로 시작하기 — 직접 만드는 방법과, 만들어 둔 앱을 관리하는 방법이에요.
• API 레퍼런스: webhook — 페이로드 모양, 재시도, 서명 확인이에요.
• Merchant API 레퍼런스 — 에이전트가 못 부르는 것까지, 모든 메서드예요.