SingleFax MCP 서버
Cursor·Claude·Codex·ChatGPT·VS Code를 MCP로 SingleFax에 연결하세요. 도우미가 원본 Word·Excel·PDF·이미지를 변환 없이 업로드하고 가격을 계산한 뒤 Checkout을 열거나 보유 페이지를 사용합니다.
Cursor·VS Code는 한 번 클릭으로 설치합니다. Claude·Codex·ChatGPT는 코드를 복사하고 해당 설정을 엽니다. 웹 설치 페이지가 앱을 열지 않으면 Cursor 딥링크하세요.
https://singlefax.com/mcp
채팅 앱
Cursor·Claude·Codex·ChatGPT는 MCP + OAuth를 사용합니다. 남은 구독 페이지가 없다면 사람이 결제를 확인합니다.
자율 결제
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로 등록되어 있습니다.
- 위의 Cursor에 추가를 누르거나
~/.cursor/mcp.json에 저장하세요. - SingleFax OAuth 동의 화면을 승인하세요.
- 에이전트에게 팩스 전송을 요청하세요. 일반 문서는
create_upload를 호출해 업로드 링크를 제공한 뒤uploadToken로create_fax_draft을 호출합니다. 원본을 보내고 먼저 PDF로 변환하지 마세요.
{
"mcpServers": {
"singlefax": {
"url": "https://singlefax.com/mcp"
}
}
}Cursor에서는 Stripe Shared Payment Token을 발급할 수 없습니다. create_fax_draft의 Checkout 링크를 우선 이용하세요. Cursor 터미널에서 MPP로 결제하려면 아래 MPP 안내를 보세요. Cursor MCP 문서.
Claude Code
- 명령 실행 후 세션에서
/mcp로 OAuth를 완료하세요.
claude mcp add --transport http singlefax https://singlefax.com/mcpClaude.ai·데스크톱
- 사용자 지정 → 커넥터를 여세요.
- 이름이
singlefax이고 URL이 https://singlefax.com/mcp인 사용자 지정 커넥터를 추가하세요. - 연결 후 채팅에서 커넥터를 활성화하세요.
무료 Claude.ai 계정은 사용자 지정 커넥터 1개로 제한됩니다. Claude는 설치 딥링크가 없어 버튼이 CLI 명령을 복사하고 커넥터 화면을 엽니다. Claude Code MCP 문서.
- 터미널에 명령을 붙여 넣으세요. CLI·IDE 확장·ChatGPT 데스크톱은
~/.codex/config.toml를 공유합니다. - 추가 단계에서 OAuth가 시작되지 않았다면
codex mcp login singlefax로 시작하세요. - Codex 세션에서
/mcp를 실행하여 도구를 확인하세요.
codex mcp add singlefax --url https://singlefax.com/mcp
codex mcp login singlefax[mcp_servers.singlefax]
url = "https://singlefax.com/mcp"- 설정 → 보안 및 로그인에서 개발자 모드를 켜세요.
- 커넥터·플러그인에서 사용자 지정 커넥터를 만드세요.
- 이름:
SingleFax. MCP URL: https://singlefax.com/mcp. 인증: OAuth. - 채팅에서 개발자 모드와 SingleFax 커넥터를 활성화한 후 팩스를 요청하세요.
https://singlefax.com/mcpChatGPT 사용자 지정 MCP는 Instant Checkout이 아닌 개발자 모드용입니다. 에이전트가 SingleFax Checkout URL을 반환하면 이용자가 결제합니다. ChatGPT 커넥터 문서.
- VS Code에 추가 또는 명령 팔레트 →
MCP: Add Server을 선택하세요. - 또는 작업공간의
.vscode/mcp.json나 사용자 MCP 설정에 저장하세요.
{
"servers": {
"singlefax": {
"type": "http",
"url": "https://singlefax.com/mcp"
}
}
}요청 예시
서버를 연결한 뒤에는 이와 같은 지시만으로 충분합니다. 일반 문서의 경우 에이전트가 create_upload를 호출하고 원본 파일을 올릴 수 있는 uploadPageUrl를 제공한 다음, uploadToken을 사용하여 create_fax_draft를 호출해야 합니다. 채팅 앱은 일반 파일을 base64로 담아 도구를 호출할 수 없습니다. Word, Excel, 이미지 파일을 미리 PDF로 변환하지 마세요. 전송 전에 SingleFax가 변환합니다. 가격을 계산한 뒤 Checkout을 열거나 보유 페이지를 사용하여 전송합니다.
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 요구를 결제합니다.
npx skills add stripe/link-cli로 스킬을 설치하거나 MCPnpx @stripe/link-cli --mcp를 추가하세요.- 로그인 후 기계 엔드포인트에서 결제하세요. 유효한 E.164, 원본의 실제 base64를 사용하며
+1555자리표시자나 미리 변환한 PDF를 쓰지 마세요. 원본이 PDF인 경우는 예외입니다. mpp pay를/mcp에 연결하지 마세요. Link CLI에는 HTTP 402와WWW-Authenticate를 반환하는 URL이 필요합니다.
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입니다. 이 페이지와 같은 정보입니다.