FinCobra MCP — Claude, Cursor, Codex용 암호화폐 Checkout

Model Context Protocol(MCP) 서버로, FinCobra 암호화폐 Checkout 및 결제를 위한 것입니다. 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 웹 앱에서 사용하는 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

인증

로그인된 브라우저(DevTools → Application → Cookies)에서 Watchlist session 쿠키를 복사하세요. 키와 세션 토큰은 채팅이 아닌 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