FinCobra MCP — Claude、Cursor、Codex 向け暗号通貨チェックアウト

Model Context Protocol (MCP) サーバー。FinCobra の暗号通貨チェックアウトと支払いを処理します。BTC、USDT、USDC のホスト型請求書を作成できます（決済資産はダッシュボードの支払い方法から取得され、金額は USD です）。Claude Code、Cursor、Codex で動作します。Watchlist へのアクセスは読み取り専用です。まだ npm には公開されていません — GitHub からインストールしてください。

ドキュメント: FinCobra Checkout MCP

fincobra-mcp 0.1.0 は まだ npm に公開されていません。公開されるまでは GitHub からインストールしてください:

npx -y github:dexstandard/fincobra-mcp

npx -y github:dexstandard/fincobra-mcp#v0.1.0 でソースリリースを固定します。Node.js 20+ が必要です。

• Checkout: ホスト型支払い請求書を作成し、そのステータスを読み取ります

• Watchlist: 読み取り専用のソース一覧と手動の純資産の内訳

これは決済プラットフォームではなく、Watchlist の書き込み API でもありません。

ツール (v0)

Checkout

list_invoices ツールはありません。Checkout API キーでは請求書を一覧表示できません。

請求書の金額は USD です。決済資産はダッシュボードの支払い方法から取得されます:

Watchlist (読み取り専用)

Watchlist には公開 API キーがありません。認証は Watchlist Web アプリで使用される Identity の session クッキーです。

銀行、現金、不動産は手動のプロダクトエントリであり、ライブの銀行フィードや不動産登記フィードではありません。ライブの暗号通貨 USD 残高は Watchlist UI で計算され、一覧 API には含まれません。サーバーが cryptoUsd の合計を独自に算出することはありません。

Watchlist ツールはウォレットの追加、銀行の編集、請求の変更、税金のエクスポートを行いません。

Related MCP server: Infini Payment MCP Server

環境変数

Checkout、Watchlist、またはその両方を設定します。未設定のサーフェスのツールは設定エラーを返します。

開発用オリジン: https://dev.fincobra.com と https://watch.dev.fincobra.com。

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（ユーザー）に追加します:

{
  "mcpServers": {
    "fincobra": {
      "command": "npx",
      "args": ["-y", "github:dexstandard/fincobra-mcp"],
      "env": {
        "FINCOBRA_CHECKOUT_API_KEY": "fc_live_...",
        "FINCOBRA_CHECKOUT_BASE_URL": "https://fincobra.com",
        "FINCOBRA_WATCHLIST_SESSION_TOKEN": "<session-cookie-value>",
        "FINCOBRA_WATCHLIST_BASE_URL": "https://watch.fincobra.com"
      }
    }
  }
}

Claude Code

claude mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

または、同じ mcpServers オブジェクトを .mcp.json / ~/.claude.json に追加します。

Codex

codex mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

または ~/.codex/config.toml に:

[mcp_servers.fincobra]
command = "npx"
args = ["-y", "github:dexstandard/fincobra-mcp"]

[mcp_servers.fincobra.env]
FINCOBRA_CHECKOUT_API_KEY = "fc_live_..."
FINCOBRA_WATCHLIST_SESSION_TOKEN = "<session-cookie-value>"

ローカルで実行

npm install
FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm start

プロセスは stdio 経由で MCP 通信を行います。アプリケーションログを stdout に書き込まないでください。

スモークテスト

FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm run smoke

ユニットテストは API をモックし、認証情報は不要です:

npm test

認証

サインイン済みブラウザから Watchlist の session クッキーをコピーします（DevTools → Application → Cookies）。キーとセッショントークンはチャットではなく MCP サーバーの環境変数に保持してください。

API

Checkout:

• POST /api/checkout/invoices

• GET /api/checkout/invoices/:id

• 認証: X-Api-Key

Watchlist:

• GET /api/watchlist/wallets

• GET /api/watchlist/exchanges

• GET /api/watchlist/manual-assets

• GET /api/watchlist/fx-rates

• 認証: Cookie: session=...

支払い者を paymentUrl に誘導します。confirmed と paid_out_of_band は支払い済みとして扱います。payment_detected は、未確認の暗号通貨支払いを受け入れない限り、保留中として扱います。

ライセンス

MIT