MCP · Stripe MPP

SingleFax MCP 서버

Cursor·Claude·Codex·ChatGPT·VS Code를 MCP로 SingleFax에 연결하세요. 도우미가 원본 Word·Excel·PDF·이미지를 변환 없이 업로드하고 가격을 계산한 뒤 Checkout을 열거나 보유 페이지를 사용합니다.

Cursor에 추가VS Code에 추가

Cursor·VS Code는 한 번 클릭으로 설치합니다. Claude·Codex·ChatGPT는 코드를 복사하고 해당 설정을 엽니다. 웹 설치 페이지가 앱을 열지 않으면 Cursor 딥링크하세요.

https://singlefax.com/mcp

채팅 앱

Cursor·Claude·Codex·ChatGPT는 MCP + OAuth를 사용합니다. 남은 구독 페이지가 없다면 사람이 결제를 확인합니다.

스크립트 및 백엔드

API 키·선불 크레딧을 사용하며 결제 리디렉션이 없습니다. 자체 워커에 적합합니다.

API·CLI·언어별 예제

자율 결제

Stripe MPP(HTTP 402). 카드는 Link CLI, Tempo Wallet·Privy·AgentCash·Kite는 Tempo USDC를 사용합니다.

기계 URL·Link CLI·Tempo

클라이언트별 설치

https://singlefax.com/mcp의 Streamable HTTP입니다. 설치 후 클라이언트가 OAuth를 실행하면 SingleFax 계정으로 로그인하세요. Smithery 카탈로그에도 @singlefax/fax로 등록되어 있습니다.

요청 예시

서버를 연결한 뒤에는 이와 같은 지시만으로 충분합니다. 일반 문서의 경우 에이전트가 create_upload를 호출하고 원본 파일을 올릴 수 있는 uploadPageUrl를 제공한 다음, uploadToken을 사용하여 create_fax_draft를 호출해야 합니다. 채팅 앱은 일반 파일을 base64로 담아 도구를 호출할 수 없습니다. Word, Excel, 이미지 파일을 미리 PDF로 변환하지 마세요. 전송 전에 SingleFax가 변환합니다. 가격을 계산한 뒤 Checkout을 열거나 보유 페이지를 사용하여 전송합니다.

example prompt
Send this document as a fax to +1-415-555-2671 using SingleFax.
list_skus, 가격 포함 카탈로그. HIPAA·EIN·IRS는 웹 전용이며 URL 포함
quote_fax, 개별 전송 가격. to를 전달하고 실제 페이지 계산에는 pages 또는 base64를 선택 제공
create_fax_draft, create_upload 후 to와 uploadToken으로 전송합니다. 크레딧·페이지를 사용하거나 Checkout URL을 반환합니다. base64는 아주 작은 파일만 사용하세요. Word·Excel·PDF·이미지 원본을 보내고 먼저 변환하지 마세요.
create_inbound_number, 전용 팩스 번호를 받습니다. 기본은 30일($4.99)이며 Checkout URL과 예약 번호를 반환합니다. 결제 후 list_numbers를 호출하세요.
list_numbers, 이 계정의 활성 팩스 번호 목록
create_checkout, 크레딧·기타 카탈로그 SKU. 팩스 번호는 create_inbound_number 권장
create_upload, 큰 파일: 비로그인 직접 업로드용 uploadPageUrl과 Authorization 없는 원시 PUT용 uploadUrl을 반환합니다. uploadToken으로 stored 상태를 확인하세요.
get_fax_status, 본인 주문의 전송 상태 조회
get_credits, 선불 크레딧 잔액 조회
create_machine_fax, MPP 결제 요구 JSON. Link CLI(SPT) 또는 Tempo 지갑. 실제 결제는 REST 402 경로 사용

MPP 자율 결제

Machine Payment Protocol은 구매자 측 프로토콜입니다. 서버가 HTTP 402를 반환하면 에이전트가 Stripe Shared Payment Token 또는 Tempo USDC 결제를 첨부하고 재시도합니다. 이는 채팅 MCP 도구가 아닌 POST https://singlefax.com/api/v1/machine/faxes입니다.

Cursor·Claude Code·Codex는 터미널에서 해당 URL을 call할 수 있지만 지갑을 제공하지 않으면 SPT를 만들 수 없습니다. Stripe 카드 경로는 미국 Link 계정의 Link CLI입니다. Link 앱에서 지출마다 승인하세요. Tempo Wallet·Privy·AgentCash·Kite Passport는 같은 URL의 Tempo 요구를 결제합니다.

  1. npx skills add stripe/link-cli로 스킬을 설치하거나 MCP npx @stripe/link-cli --mcp를 추가하세요.
  2. 로그인 후 기계 엔드포인트에서 결제하세요. 유효한 E.164, 원본의 실제 base64를 사용하며 +1555 자리표시자나 미리 변환한 PDF를 쓰지 마세요. 원본이 PDF인 경우는 예외입니다.
  3. mpp pay를 /mcp에 연결하지 마세요. Link CLI에는 HTTP 402와 WWW-Authenticate를 반환하는 URL이 필요합니다.
link-cli mpp pay
npx @stripe/link-cli auth login

npx @stripe/link-cli mpp pay https://singlefax.com/api/v1/machine/faxes \
  -X POST \
  -d '{"to":"+14155552671","base64":"<document-bytes>","request_id":"mpp-1"}' \
  --context "Send a fax via SingleFax after the user asked this agent to pay for the send."

전체 결제 요구 형식·검증·상태·환불: mpp.md. 최소 SPT $0.50, Tempo USDC $0.01, SingleFax 소매 최저 요금 $0.99입니다.

REST API + CLI

자체 백엔드는 범위 제한 키와 선불 크레딧을 사용하며 Checkout 리디렉션은 없습니다. curl·Node·Python·Go·PHP 예제는 개발자 페이지에 있습니다.

자주 묻는 질문

에이전트가 읽을 수 있는 문서

크롤러·코딩 에이전트용 일반 Markdown입니다. 이 페이지와 같은 정보입니다.