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

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

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

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

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

Любой чат с агентом — отправьте этот промпт:
```
Подключи MCP-сервер tgpay (https://app.tgpaycrypto.com/mcp) и прикрути оплату через TgPay Merchant API.
```
Он уже готов к копированию в приложении: Ещё → Merchant API → Подключить ИИ-агента.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp

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

claude.ai и Claude Desktop — «Настройки» → «Коннекторы» → «Добавить пользовательский коннектор» → вставьте адрес.
ChatGPT и другие MCP-клиенты — добавьте пользовательский коннектор с тем же адресом.

Заранее заводить API-токен не нужно: агент получит свой на следующем шаге. Если приложение вы уже создали руками, отдайте агенту его токен и переходите сразу к интеграции.

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

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

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

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

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

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

Возможный ущерб ограничен самой схемой: токен агента может принимать деньги, но не выводить их (об этом ниже). И всё же приложению, о котором вы не просили, на вашем аккаунте делать нечего.

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

Агент получает ограниченный токен:

Может — выставлять счета и заводить планы подписок, читать баланс, курсы и статистику, задавать Webhook URL.
Не может — делать переводы, выпускать чеки и оформлять возвраты. Всё, что выводит средства с баланса приложения, требует основного токена с полным доступом — он остаётся у вас в Mini App.

Разделение сделано намеренно: токены агентов лежат в конфигах и в контексте модели, а это защищено слабее, чем ваш сервер. Если такой токен утечёт, худшее, что вам грозит, — подменённый Webhook URL, но не потеря баланса. Бот присылает сообщение каждый раз, когда агенту выдан токен и когда у приложения меняется Webhook URL.

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

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

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

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

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

Дальше

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