Т-Касса MCP: Документация
Обновлено:
Подключение
npx -y @theyahia/tkassa-mcp (stdio) или HTTP_PORT=3000 npx @theyahia/tkassa-mcp --http (JSON-RPC + /health). Auth: TKASSA_TERMINAL_KEY + TKASSA_PASSWORD — из личного кабинета Т-Кассы (tbank.ru/kassa) → Магазины → Терминалы. Пароль участвует в подписи SHA-256 каждого запроса — сервер считает её сам.
Инструменты
14 инструментов: платежи (init_payment — создать, вернуть PaymentURL; get_payment_state, confirm_payment — в т.ч. частичное подтверждение двухстадийного платежа, cancel_payment, charge_payment — списание по RebillId сохранённой карты), возвраты (refund_payment — полный или частичный), клиенты и карты (add_customer, get_customer, remove_customer, get_card_list, remove_card), СБП (create_sbp_qr — ссылка или PNG-QR, get_sbp_qr_state), чеки 54-ФЗ (send_closing_receipt).
Сценарий для агента
«Создай платёж на 1500 ₽ по заказу order-42 с чеком: подписка Premium, НДС 20%», «зарегистрируй клиента и оформи рекуррентный платёж на 990 ₽», «верни 500 ₽ по платежу 777888999 и проверь его статус».
Важно
Community-проект (theYahia), не официальный продукт Т-Банка. Ключ терминала даёт доступ к реальным деньгам — начните с тестового терминала из личного кабинета, прежде чем подключать боевой.