Как подключить ИИ-агента

Подключите ИИ-агента для разработки с поддержкой удалённых MCP-серверов к https://app.tgpaycrypto.com/mcp. Он сможет изучить документацию API, запросить создание мерчант-приложения, настроить вебхуки и помочь с кодом интеграции. Вы подтверждаете создание приложения в боте, а агент получает ограниченный токен — копировать его вручную не нужно. Проверьте и протестируйте готовую интеграцию, прежде чем принимать настоящие платежи.

По этому адресу работает MCP-сервер (Model Context Protocol — стандартный способ подключить сервис к ИИ-агенту). Откройте адрес в браузере: страница сама рассказывает, как подключить сервер.

Как подключить

Выберите вариант под свой инструмент:

Агент с поддержкой удалённых MCP-серверов — отправьте этот промпт:
```
Подключи MCP-сервер tgpay (https://app.tgpaycrypto.com/mcp) и подключи оплату через TgPay Crypto Merchant API.
```
Промпт для подключения также можно скопировать в приложении: Ещё → Merchant API → Подключить ИИ-агента.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai и Claude Desktop — добавьте адрес как пользовательский коннектор по инструкции Claude.
ChatGPT и другие MCP-клиенты — добавьте адрес как пользовательский MCP-сервер, если это разрешено для вашего аккаунта и рабочего пространства. Для ChatGPT используйте актуальную инструкцию.

Чтобы сначала создать интеграцию в тестовой сети, укажите https://testnet.tgpaycrypto.com/mcp. Ссылка для подтверждения откроет @tgpaycrypto_testnet_bot, а документация API будет использовать тестовый базовый адрес.

Заранее заводить API-токен не нужно: агент получит свой на следующем шаге. Если приложение вы уже создали руками, выпустите ограниченный токен только с нужными агенту правами и используйте его для интеграции. Основной токен храните на своём сервере. Какой бы токен ни был у агента, через MCP-сервер он может только принимать платежи (об этом ниже).

Чтобы передать такой токен MCP-серверу, добавьте сервер с заголовком TgPayCrypto-API-Token: <token> (или Authorization: Bearer <token>) в настройках подключения вашего клиента — тогда шаг подтверждения не нужен. Поле для своих заголовков есть не у всех клиентов (у коннекторов claude.ai и ChatGPT его нет, а входа через OAuth у сервера нет) — там используйте подтверждение, описанное ниже. Агент также может передать токен аргументом api_token в отдельном вызове инструмента, если клиент позволяет передать аргумент, которого нет в описании инструмента.

Подтвердите приложение

Попросите агента подключить оплату. Он прочитает документацию и попросит подтверждение.
Агент даёт вам ссылку на t.me. Откройте её — бот покажет, что именно у вас просят, — и нажмите ✅ Создать приложение и выдать токен.
Вернитесь к агенту, чтобы он мог получить токен и продолжить интеграцию.

Приложение и токен агента создаются, когда агент после вашего нажатия в очередной раз проверяет запрос, — обычно через несколько секунд. Запрос действует 10 минут с момента, когда агент его отправил: если агент не успел проверить его за это время, ничего не создаётся, хотя бот уже подтвердил нажатие, и агенту придётся начать заново. Аккаунт должен соответствовать условиям создания приложения; если нужна верификация, агент получит ошибку при этой проверке — пройдите верификацию и попросите агента проверить снова в пределах тех же 10 минут или начать заново.

Подтверждая запрос, вы принимаете условия Merchant API для создаваемого приложения — так же, как при создании приложения вручную в TgPay Crypto.

Ссылку всегда даёт агент, сам бот её не присылает: пока вы её не открыли, бот не знает, о чьём аккаунте идёт речь. Пока вы не нажали кнопку, повторное открытие ссылки показывает тот же запрос; после ✅ Создать приложение и выдать токен, ❌ Отклонить или по истечении 10 минут ссылка перестаёт работать. Если она перестала действовать раньше, чем вы успели нажать кнопку, попросите агента начать заново — до вашего подтверждения ничего не создаётся.

Если нажмёте ❌ Отклонить, тоже ничего не создастся, и запрос на этом закрыт. Передумаете — агент запросит подключение заново.

⚠️ Подтверждайте только то, о чём попросили сами

Запрос на подключение — это просьба создать приложение на вашем аккаунте. Подтверждайте её, только если вы сами только что попросили своего агента подключить оплату. Если ссылка пришла как-то иначе — в переписке, пересланным сообщением, от незнакомой «поддержки», — отклоняйте.

Через MCP-сервер ни один токен — включая выданный через это подтверждение — не позволяет делать переводы, создавать чеки и возвращать платежи (об этом ниже). Приложению, о котором вы не просили, на вашем аккаунте делать нечего.

Что агент может, а что нет

Через описанное выше подтверждение агент получает ограниченный токен:

Может — выставлять и удалять счета, заводить и архивировать планы подписок, отменять подписку подписчика, читать баланс, курсы и статистику, менять Webhook URL и название приложения.
Не может — делать переводы, выпускать чеки и оформлять возвраты: прав payouts, checks и refunds у него нет.

У самого MCP-сервера есть и второй барьер: его инструменты для вывода денег — transfer, transferBatch, createCheck и refundInvoice — сейчас выключены. Агент их не видит, а вызов отклоняется, какой бы токен у агента ни был, даже основной с полным доступом. Поэтому ни утёкший токен агента, ни вредоносная инструкция, спрятанная в тексте, который читает агент (например, в комментарии плательщика), не выведут деньги из приложения через MCP.

Переводы, чеки и возвраты по-прежнему доступны напрямую через API: вызывайте /pay/api из кода своего сервера с токеном, у которого есть соответствующие права payouts, checks или refunds. Выплаты также можно делать в приложении: откройте Ещё → Merchant API, выберите приложение, затем Выплаты.

Храните этот токен в секрете: его права всё ещё позволяют менять счета, планы подписок, подписки, Webhook URL и название приложения. Бот присылает сообщение каждый раз, когда агенту выдан токен и когда у приложения меняется Webhook URL.

Посмотреть права токена агента или отозвать его можно в разделе Ещё → Merchant API: найдите приложение, откройте раздел Доступ и токены, затем блок Токены с ограниченным доступом — кнопка Отозвать отключает токен мгновенно. Само приложение, его баланс и история платежей сохраняются. Само значение токена повторно не показывается. Если у токена задан срок действия, по его окончании токен перестанет работать.

Подпись вебхуков — на основном токене

Указать Webhook URL агент может, а проверить то, что на него приходит, — нет: вебхуки подписываются основным токеном приложения, а его агент никогда не видит. Попросите агента написать код проверки и оставить вам заглушку вроде TGPAY_WEBHOOK_TOKEN, чтобы вы вписали значение сами.

Откуда его взять: откройте Ещё → Merchant API, найдите созданное агентом приложение, откройте Доступ и токены, нажмите Обновить токен, подтвердите PIN-кодом или Face ID и сразу скопируйте новый токен — второй раз его не покажут. Приложение, созданное через агента, может принадлежать аккаунту без PIN-кода: для обновления он нужен, поэтому сначала задайте его в разделе Защита и дождитесь, пока он начнёт действовать. Положите значение в переменные окружения своего сервера, но не в конфиг агента и не в репозиторий. Ограниченный токен агента обновление не затрагивает, так что интеграция продолжает работать.

Подпись переключается на новый токен в момент обновления, поэтому обновляйте токен до запуска, а не после первого настоящего платежа.

Дальше

Как начать работу с API — как создать приложение вручную и управлять им после создания.
Справочник API: вебхуки — состав данных, повторы и проверка подписи.
Справочник Merchant API — все методы, включая те, что агенту недоступны.