SingleFaxのMCPサーバー
Cursor、Claude、Codex、ChatGPT、VS CodeをMCPでSingleFaxへ接続できます。アシスタントが元のファイル(Word、Excel、PDF、画像。事前変換不要)をアップロードして見積もりを提示し、決済画面を開くかページ枠で送信します。
CursorとVS Codeは1クリックでインストールできます。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利用するクライアントに設定
Streamable HTTP:https://singlefax.com/mcp。インストール後にクライアントがOAuthを実行するので、SingleFaxアカウントでログインしてください。Smitheryの一覧にも@singlefax/faxとして掲載しています。
- 上のCursorに追加を選ぶか、
~/.cursor/mcp.jsonに保存。 - SingleFaxのOAuth同意画面で承認してください。
- エージェントにFAX送信を依頼してください。通常の文書では
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・Desktop
- カスタマイズ → コネクターを開く。
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。 - FAXを依頼する前に、チャットで開発者モードとSingleFaxコネクターを有効にしてください。
https://singlefax.com/mcpChatGPTのカスタムMCPは開発者モード用で、Instant Checkoutではありません。エージェントはお客様が支払うSingleFaxの決済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変換せず、送信前に当社で変換します。見積もり後、決済画面を開くかページ枠で送信します。
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で送信します。クレジット・ページ枠があれば送信待ちにし、それ以外は決済URLを返します。base64はごく小さいファイルに限ります。元のWord、Excel、PDF、画像を送り、先にPDF変換しないでください。create_inbound_number, 専用FAX番号を取得します。既定は30日間($4.99)。決済URLと確保した番号を返します。支払い後にlist_numbersを呼び出してください。list_numbers, このアカウントの利用中のFAX番号を一覧表示create_checkout, クレジットなどの商品SKU。FAX番号には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 402MPPによる自律的な支払い
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チャレンジに支払います。
- スキルをインストール:
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
独自バックエンドでは権限範囲を絞ったキーを作成し、クレジットを前払いします。決済画面への転送はありません。curl、Node、Python、Go、PHPのコピー可能なサンプルは開発者ページをご覧ください。
よくあるご質問
エージェント向けドキュメント
クローラー・コーディングエージェント向けのMarkdown。このページと同じ内容です。