SMS-коды для ИИ-агентов: коды подтверждения через MCP

Подключите агента

Вход — OAuth 2.1 с динамической регистрацией клиента: укажите клиенту URL, откроется окно браузера, вы подтверждаете вход кодом, отправленным на электронную почту (или на телефон вашего аккаунта), и нажимаете Разрешить. Никаких client ID и секретов вставлять не нужно.

claude mcp add --transport http busysms https://busysms.net/mcp

codex mcp add busysms --url https://busysms.net/mcp

[mcp_servers.busysms]
url = "https://busysms.net/mcp"

В приложении Claude откройте Customize → Connectors → + Add → Add custom connector, назовите коннектор BusySMS и вставьте https://busysms.net/mcp. Другие MCP-клиенты, включая Grok, добавляют его как удалённый HTTP-сервер с тем же URL. Клиент, который не умеет OAuth, может вместо этого передать API-ключ bsk_live_ как Bearer-токен.

Типичный сценарий работы агента

1. 1

   Запуск входа

   Агент заполняет форму входа или обращается к сервису, и сервис отправляет код на ваш номер.

2. 2

   Ожидание кода

   Агент сразу вызывает wait_for_code и передаёт phone или sender, если у вас несколько номеров.

3. 3

   Использование кода

   Агент вводит код и продолжает работу. Если ничего не пришло, он ничего не получает и может повторить попытку или спросить вас, вместо того чтобы гадать.

С любым подключённым агентом сработает вот такой простой промпт:

Sign in to staging.example.com as +44 7700 900123.
When the site asks for the SMS code, call BusySMS wait_for_code
with phone 447700900123, enter the code, and tell me when you are in.

Несколько номеров, общие номера и что делать, если коды не приходят

Если в аккаунте больше одного номера или есть номер, которым с вами поделился коллега, «следующий код» становится неоднозначным. Передайте phone с номером получателя, чтобы не получить код от другого входа на другой номер, или sender с частью имени отправителя. Общие номера работают как ваши: после принятия приглашения инструменты для кодов включают и их новые коды.

Если коды не приходят вообще, попросите агента запустить diagnose_my_gateway: он сравнит, что подключено, подтверждено и в сети, и подскажет следующий шаг. test_my_gateway идёт дальше и проверяет весь путь от начала до конца. Пусть агент сначала спросит вас: он отправляет на ваш номер настоящее SMS.

Безопасность, встроенная в инструменты

• Только ваши телефоны. Каждый инструмент ограничен вашим аккаунтом и номерами, которыми с вами поделились. Агент не может читать чужие сообщения.
• Никаких секретов в диалоге. create_api_key создаёт REST-ключ, но никогда его не возвращает: вы получаете одноразовую ссылку, действующую 15 минут, и открываете её сами. В тексте SMS могут оказаться инструкции, написанные посторонним, поэтому долгоживущий ключ никогда не должен попадать в контекст агента.
• Изменения — только в сессии со входом. Инструменты, которые что-то меняют, например проверка шлюза, общий доступ к номеру или отзыв ключа, по API-ключу недоступны вовсе.
• Сообщения только себе. У send_sms_to_me и send_email_to_me нет аргумента получателя: они могут отправить сообщение только на номер и адрес вашего собственного аккаунта.

Что нужно агенту с вашей стороны

• Телефон с SIM: Android с приложением BusySMS или iPhone с автоматизацией в «Командах».
• Номер, подтверждённый в BusySMS.
• Действующий пробный период или подписка. Без них инструменты для чтения кодов возвращают ошибку оплаты, а list_devices продолжает работать, чтобы агент мог объяснить вам причину.

Ещё нет аккаунта?

Публичные инструменты отвечают на вопросы о продукте без входа (цены, шаги настройки, требования к устройствам, устранение неполадок), так что ассистент может точно рассказать, что умеет BusySMS, ещё до регистрации. Для чтения кодов нужен аккаунт: $5 за подтверждённый номер в месяц после бесплатного пробного периода на 7 дней.

Вопросы и ответы

Частые вопросы