FinCobra MCP — криптовалютный checkout для Claude, Cursor и Codex

Model Context Protocol (MCP) — сервер для криптовалютного checkout и платежей 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: список источников только для чтения и ручная разбивка чистой стоимости

Это не платёжная платформа и не API для записи в Watchlist.

Инструменты (v0)

Checkout

Инструмента list_invoices нет. API-ключи Checkout не могут выводить список инвойсов.

Суммы инвойсов указаны в USD. Расчётные активы берутся из платёжных методов панели управления:

Watchlist (только для чтения)

У Watchlist нет публичного API-ключа. Аутентификация — это cookie session Identity, используемая веб-приложением Watchlist.

Банки, наличные и недвижимость — это ручные записи продукта, а не живые банковские потоки или потоки данных о правах собственности. Актуальные балансы криптовалют в USD вычисляются в интерфейсе Watchlist и отсутствуют в list 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

Процесс общается по MCP через stdio. Не выводите журналы приложения в stdout.

Смоук-тест

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

Модульные тесты имитируют API и не требуют учётных данных:

npm test

Аутентификация

Скопируйте cookie session Watchlist из браузера, в котором выполнен вход (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