Skip to Content
ПесочницаРазовые платежиMCP-сервер

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

Песочница отдаёт MCP-сервер (Model Context Protocol) — его можно подключить в VS Code, Claude Code, Cursor или Claude Desktop, после чего ИИ-агент сам читает эту документацию и делает вызовы песочницы: считает подпись, создаёт контракты и инвойсы, подтверждает PIN, смотрит статус, делает возврат.

ПараметрЗначение
URLhttps://pay-sandbox.digitalspb.com/mcp
ТранспортStreamable HTTP (type: "http")
Авторизацияне требуется

Установка

В VS Code — файл .vscode/mcp.json в проекте либо конфиг профиля (палитра команд → MCP: Open User Configuration). В Claude Code — команда claude mcp add, в Cursor и Claude Desktop — тот же remote HTTP-сервер в своём файле конфигурации.

VS Code — .vscode/mcp.json
{
  "servers": {
    "callisto-sandbox": {
      "type": "http",
      "url": "https://pay-sandbox.digitalspb.com/mcp"
    }
  }
}
Claude Code — CLI
claude mcp add --transport http \
  callisto-sandbox \
  https://pay-sandbox.digitalspb.com/mcp
Cursor / Claude Desktop
{
  "mcpServers": {
    "callisto-sandbox": {
      "type": "http",
      "url": "https://pay-sandbox.digitalspb.com/mcp"
    }
  }
}

Доступы

Настраивать ничего не нужно: если креды не переданы, инструменты работают от предустановленной тестовой учётной записи песочницы. Свои sandbox-доступы можно передать аргументами login, secret и project_id — за ними обращайтесь к администраторам sandbox.

Только sandbox-креды. Аргументы инструментов видит ваш ИИ-клиент и модель, поэтому боевые логин и секрет передавать в MCP нельзя.

Инструменты

ИнструментЧто делает
list_doc_sections, get_docsразделы документации песочницы в markdown (разовые платежи и подписки, RU/EN)
sign_requestподпись запроса: XML, JSON v3 или Subscription Service
check_billingпроверка поддержки биллинга для номера
create_contract, authorize_contract, cancel_contractконтракт абонента: создание, подтверждение PIN, отмена
create_invoiceинвойс: мобильный биллинг, карта, СБП, песочные ручки test_info
get_invoice, authorize_invoiceстатус инвойса и подтверждение PIN
cancel_invoice, refund_invoiceотмена и возврат
callback_lastпоследние коллбеки по вашим кредам — приёмник поднимать не нужно

Каждый инструмент вызовов принимает protocol — "json" (REST Payment API v3) или "xml" (Merchant XML API v2.9).

Что возвращают инструменты

Не сырой ответ шлюза, а разобранный: summary — короткое резюме, next_step — что делать дальше, data с расшифровкой статуса и кодов результата, error с человеческой подсказкой при отказе, raw — исходный ответ для отладки. Поэтому агент не угадывает смысл ResultCode и не теряет invoice_id существующего инвойса из ответа 409.

Коллбеки без туннеля

callback_last показывает события, которые песочница отправила по вашим кредам, вместе со статусом доставки и числом попыток. Имя события — то, что ушло партнёру: по умолчанию payment.updated, refund.updated, contract.authorized, contract.closed, receipt.issued, content.delivered, а у проекта с флагом legacy — payment.completed, payment.failed, refund.completed, contract.*. Какой конверт ушёл, видно по полю envelope (см. «Коллбеки»). Журнал читается на стороне песочницы, поэтому ни своего HTTPS-адреса, ни ngrok не требуется — проверить, что интеграция замкнулась, можно не выходя из IDE. Журнал отдаётся только по своему партнёру, поэтому login и secret проверяются.

Эндпоинт публичный, поэтому ограничен по IP: 60 запросов в минуту (всплеск до 20) и не больше 4 одновременных соединений. Для нагрузочных сценариев обращайтесь к администраторам sandbox.

Проверка подключения — спросите агента
Создай инвойс на 99 рублей для номера
79600000000 через песочницу Callisto
и покажи статус после тарификации
Готовый клиентResultCode