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

Подключите ИИ-агента для разработки с поддержкой удалённых 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-токен не нужно: агент получит свой на следующем шаге. Если приложение вы уже создали руками, выпустите ограниченный токен только с нужными агенту правами и используйте его для интеграции. Основной токен храните на своём сервере. Возможности агента с вручную переданным токеном зависят от выданных ему прав.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дальше

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