Разделы страницы
RU

MCP-сервер для ИИ-агентов

Агент принимает, отправляет и обменивает криптовалюту через SnapEX Pay. Подключение — один адрес; аккаунт агент открывает сам, без капчи и без участия человека.

Подключение

Адрес сервера (Streamable HTTP):

https://pay.snapex.pro/mcp

Ключ для начала не нужен: агент вызывает create_account и продолжает с новым ключом в той же сессии. Настройки для популярных клиентов:

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp

Cursor — ~/.cursor/mcp.json

{
    "mcpServers": {
        "snapex-pay": {
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}

VS Code — .vscode/mcp.json

{
    "servers": {
        "snapex-pay": {
            "type": "http",
            "url": "https://pay.snapex.pro/mcp"
        }
    }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
    "mcpServers": {
        "snapex-pay": {
            "serverUrl": "https://pay.snapex.pro/mcp"
        }
    }
}

Claude Desktop — claude_desktop_config.json

{
    "mcpServers": {
        "snapex-pay": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://pay.snapex.pro/mcp"
            ]
        }
    }
}

Коннекторы claude.ai и ChatGPT

Добавьте свой коннектор с адресом сервера. Эти клиенты не умеют передавать заголовки, поэтому после create_account возьмите из ответа mcp_personal_url и укажите его адресом коннектора — так в каждом новом чате будет тот же аккаунт. Храните этот адрес как пароль.

Если ключ уже есть

Добавьте заголовок Authorization: Bearer smk_… — ключ мерчанта из кабинета (Мерчант → Разработчикам) или из ответа create_account.

{
    "mcpServers": {
        "snapex-pay": {
            "url": "https://pay.snapex.pro/mcp",
            "headers": {
                "Authorization": "Bearer smk_…"
            }
        }
    }
}

Как с ним работает агент

  1. Подключите адрес — ключ не нужен.
  2. Агент вызывает create_account: без капчи и без почты. Он получает ключ со всеми правами, и сессия продолжается с ним.
  3. Принять оплату: create_invoice → плательщик открывает pay_url → get_invoice показывает paid. Платежи зачисляются на баланс в USDT.
  4. Выплатить: preview_payout показывает сумму и комиссию, create_payout отправляет — в любой монете из list_assets.

Инструменты

Одни и те же инструменты в удалённом сервере и в локальном пакете. Каждый ответ — JSON; ошибка подсказывает, что делать дальше.

Аккаунт

create_account, get_account

Монеты, курсы и комиссии (без ключа)

list_assets, get_fiat_rates, get_fees, list_static_address_networks

Баланс и история

get_balances, list_transactions

Приём: счета, платежи, постоянные адреса

create_invoice, get_invoice, list_invoices, get_invoice_payment_methods, select_invoice_payment_method, preview_payment, create_payment, get_payment, list_payments, create_static_address, list_static_addresses, list_static_address_deposits

Отправка: выплаты

preview_payout, create_payout, get_payout, list_payouts

Обмен: конвертации

preview_conversion, create_conversion, get_conversion, list_conversions

Вебхуки

list_webhooks, create_webhook, update_webhook, rotate_webhook_secret

Безопасность

  • Ключ и сгенерированный пароль показываются один раз — в ответе create_account. По логину и паролю человек может войти в кабинет.
  • Агент распоряжается только деньгами своего аккаунта. Новый аккаунт начинает с нуля; деньги приходят от оплат его счетов и адресов.
  • Отправка — в два шага: preview_payout показывает сумму и комиссию, create_payout отправляет с собственным idempotency_key агента — повтор никогда не платит дважды.
  • Тестовый режим: счёт с environment test проходит весь путь без реальных денег.
  • Лимиты: несколько новых аккаунтов в час с одного IP; выплаты — 5 в минуту и 30 в час на ключ.
  • Что можно и что нельзя продавать: Правила

Без MCP

То же самое работает через REST API: аккаунт — одним запросом, дальше Merchant API с ключом.

curl -X POST https://pay.snapex.pro/api/v1/merchant/signup -H 'Content-Type: application/json' -d '{"agent":"my-agent"}'

Документация API · llms.txt · mcp.json