需要先把檔案轉 PDF 嗎？

不需要。傳送原始 Word、Excel、PowerPoint、RTF、純文字、圖片或 PDF。我們會在傳送前轉 PDF，請勿自行先轉。

可以從 Grok 或 ChatGPT 傳大型檔案嗎？

聊天 MCP 無法以 base64 承載一般文件，數十 KB 就可能卡住。助理會呼叫 create_upload，提供免登入上傳連結；您上傳原檔後，使用 uploadToken 傳送。程式可不加 Authorization 標頭，以 HTTP PUT 將原始位元組傳至 uploadUrl。

我的代理該用哪個管道？

聊天應用程式（Cursor、Claude、Codex、ChatGPT）應使用 MCP，工具會提供 Checkout 連結或使用訂閱頁數額度。有能力產生 Stripe Shared Payment Token 或支付 Tempo USDC 的自主程式，應用 MPP 呼叫 REST 機器端點。後端工作應使用 API 金鑰及預付餘額，見 /developers。

Cursor 可以自行用 Stripe MPP 付款嗎？

不行，Cursor 沒有 Stripe 錢包。請使用 MCP + Checkout，或安裝 Stripe Link CLI（npx skills add stripe/link-cli）後，對 REST 機器 URL 執行 link-cli mpp pay；也可從 Tempo Wallet、Privy、AgentCash 或 Kite Passport 支付 Tempo USDC.e 挑戰。

可以用加密貨幣或 Tempo 付款嗎？

可以，在機器傳真管道。POST /api/v1/machine/faxes 回傳 HTTP 402，同時提供 Tempo USDC.e 及 Stripe SPT。Tempo Wallet、Privy、AgentCash、Kite Passport 可付款。網站 Checkout 仍為信用卡、Apple Pay、Google Pay 或 Link，不是 Bitcoin。

MCP 使用 OAuth，因此需要；當用戶端開啟同意畫面時登入或建立帳號。MPP 機器傳送不需 API 金鑰。REST 與 CLI 預付餘額需控制台 API 金鑰（見 /developers）。

這是 HIPAA 服務嗎？

不行。勿透過 MCP、MPP 或公開 API 傳送 PHI。適用機構應使用網站 HIPAA Secure 模式及電子 BAA。

MCP · Stripe MPP

SingleFax MCP 伺服器

透過 MCP 將 Cursor、Claude、Codex、ChatGPT 或 VS Code 連接 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

依用戶端安裝

Streamable HTTP 位於 https://singlefax.com/mcp。安裝後用戶端執行 OAuth，請登入 SingleFax 帳戶。也收錄於 Smithery 目錄，名稱為 @singlefax/fax。

點擊上方 新增至 Cursor，或將設定存入 ~/.cursor/mcp.json。
同意 SingleFax OAuth 授權畫面。
請代理傳送傳真。一般文件會呼叫 create_upload 提供上傳連結，再以 uploadToken 呼叫 create_fax_draft。請傳原始檔，不要先轉 PDF。

~/.cursor/mcp.json

{
  "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。

terminal

claude mcp add --transport http singlefax https://singlefax.com/mcp

Claude.ai／Desktop

開啟 Customize → Connectors。
新增名為 singlefax 的自訂連接器，網址為 https://singlefax.com/mcp。
連線後，在聊天中啟用連接器。

免費 Claude.ai 帳號限一個自訂連接器。Claude 沒有安裝深層連結，按鈕會複製 CLI 指令並開啟 Connectors。Claude Code MCP 文件。

將指令貼入終端機（CLI、IDE 擴充功能及 ChatGPT 桌面版共用 ~/.codex/config.toml）。
若新增步驟尚未執行 OAuth，codex mcp login singlefax 會啟動。
在 Codex 工作階段執行 /mcp，確認工具可用。

terminal

codex mcp add singlefax --url https://singlefax.com/mcp
codex mcp login singlefax

~/.codex/config.toml

[mcp_servers.singlefax]
url = "https://singlefax.com/mcp"

Codex MCP 文件.

啟用 開發人員模式（設定 → 安全性與登入）。
開啟 Connectors／Plugins，建立自訂連接器。
名稱：SingleFax。MCP URL：https://singlefax.com/mcp。驗證：OAuth。
聊天中先啟用開發人員模式與 SingleFax 連接器，再要求傳真。

MCP server URL

https://singlefax.com/mcp

ChatGPT 自訂 MCP 用於開發人員模式，不是 Instant Checkout。代理仍會回傳 SingleFax Checkout URL 供您付款。ChatGPT 連接器文件。

點選 新增至 VS Code，或開啟命令選擇區 → MCP: Add Server。
也可存入工作區 .vscode/mcp.json 或使用者 MCP 設定。

.vscode/mcp.json

{
  "servers": {
    "singlefax": {
      "type": "http",
      "url": "https://singlefax.com/mcp"
    }
  }
}

VS Code MCP 文件.

可以這樣說

伺服器連線後，使用類似提示即可。一般文件應由代理呼叫 create_upload，提供 uploadPageUrl 讓您放入原始檔案，再使用 uploadToken 呼叫 create_fax_draft。聊天應用程式不能在工具呼叫中以 base64 攜帶一般檔案。Word、Excel、圖片無須先轉 PDF，我們會在傳送前轉換。系統先報價，再開啟 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 或圖片，不要先轉 PDF。

create_inbound_number, 取得專屬號碼，預設 30 天（$4.99）。回傳 Checkout URL 與保留號碼。付款後呼叫 list_numbers。

list_numbers, 列出本帳戶有效傳真號碼

create_checkout, 額度或其他目錄 SKU；傳真號碼請優先用 create_inbound_number

create_upload, 大型檔案：回傳 uploadPageUrl（使用者拖放，免登入）及 uploadUrl（PUT 原始位元組，不加 Authorization）。以 uploadToken 輪詢儲存狀態

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 付款後重試。這是 POST https://singlefax.com/api/v1/machine/faxes，不是聊天 MCP 工具。

Cursor、Claude Code、Codex 可在終端機對該 URL 執行 call，但未提供錢包就無法產生 SPT。Stripe 卡片方式使用 Link CLI（美國 Link 帳戶），每筆支出須在 Link 應用程式核准。Tempo Wallet、Privy、AgentCash、Kite Passport 則支付相同 URL 的 Tempo 挑戰。

MPP 與 Instant Checkout 比較 Stripe MPP 使用 Link CLI 付款共用付款權杖 link-cli 程式庫 Tempo CLI mpp.dev 規格 SingleFax mpp.md

安裝技能：npx skills add stripe/link-cli，或加入 MCP npx @stripe/link-cli --mcp。
登入後支付機器端點（有效 E.164、原檔真正的 base64 文件內容，不能用 +1555 佔位符；除非來源已是 PDF，否則不要先轉 PDF）。
不要將 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 範例。

開發者文件建立 API 金鑰 SingleFax CLI OpenAPI 3 規格 Agent Auth 授權核准流程

常見問題

供代理讀取的文件

爬蟲與程式代理適用的純 Markdown，內容事實與本頁相同。

llms.txt agents.md developers.md mpp.md auth.md openapi.json versioning.md MCP 規格