В сентябре мы объявили, что коммуникационная инфраструктура Bird открыта для ИИ-агентов. Этот пост — версия того анонса для разработчиков. В нем перечислены команды, которые выполняет агент, к чему он подключается, как получает аккаунт и какие ограничения вы можете на него наложить, с указанием страницы документации для каждого пункта.
CLI
Агент, который может выполнять команды оболочки, такой как Claude Code, терминал Cursor или CI-задание, должен начинать с CLI: он использует гораздо меньше токенов для каждой операции, чем MCP. MCP-сервер, описанный далее, предназначен для хостов, которые вызывают инструменты и не могут запустить оболочку, а также для событий MCP.
bird — это единый бинарный файл, созданный для управления агентом. Вывод осуществляется в формате JSON в stdout, ошибки направляются в stderr, а код выхода несет категорию сбоя, поэтому агент может ветвить логику на основе результата без разбора текста.
Три флага выполняют большую часть работы для агента. --example выводит корректное тело запроса, --dry-run показывает запрос без его отправки, а --idempotency-key делает повторную попытку безопасной при потере ответа. «CLI для агентов» описывает контракт, а справочник CLI перечисляет каждую команду.
Размещенный MCP-сервер
Некоторые хосты вызывают инструменты и не могут запустить оболочку, например Claude Desktop, ChatGPT или мобильное приложение. Для них MCP-сервер Bird работает по адресу https://mcp.bird.com. Передайте этот URL MCP-клиенту и войдите через браузер, и клиент получит токен, который действует от вашего имени. Экран согласия показывает разрешения, которые запрашивает клиент, и вы можете убрать те, которые агенту не нужны. Вы ничего не устанавливаете и не копируете API-ключ. Поддерживаемые клиенты включают Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT и Muse, а Bird указан в каталоге коннекторов Claude.
Сервер предоставляет API Bird в виде инструментов, поэтому подключенный агент может отправлять сообщения по каналам, которые использует Bird, настраивать эти каналы и проверять ваше рабочее пространство. Клиент с ограничением на количество инструментов может подключиться к https://mcp.bird.com/dynamic, где перечислены два инструмента: search находит операцию, а execute вызывает ее. С помощью событий MCP клиент
MCP-сервер содержит шаги для каждого клиента. После установки CLI команда bird mcp запускает локальный сервер через stdio. Он добавляет инструменты регистрации и загрузки из локальных файлов, но не обслуживает события MCP.
Регистрация из терминала
Агент, у которого нет аккаунта, может создать его из терминала без сеанса браузера и посещения панели управления. Ему нужен доступ к почтовому ящику, так как код для входа приходит по электронной почте:
bird auth create-org создает организацию и ее рабочее пространство, а также сохраняет учетные данные, которые CLI и локальный MCP-сервер используют в дальнейшем. --region выбирает, где будут находиться аккаунт и его данные: us1 или eu1. Те же три шага работают с curl для агента, у которого нет CLI. Размещенный MCP-сервер не предлагает регистрацию, так как клиенту нужны учетные данные, прежде чем он сможет подключиться к нему.
Эти первые учетные данные обладают широкими правами. Они содержат разрешения, которые владелец новой организации может делегировать, включая биллинг организации, и регистрация не показывает экран согласия для их ограничения. Прежде чем агент начнет работать без присмотра, создайте для него API-ключ с ограниченной областью действия. Самостоятельная регистрация проходит через оба пути.
Контроль того, что может делать агент
Агент, который отправляет сообщения через Bird, хранит учетные данные и тратит ваш баланс. «Контроль агентов» документирует на одной странице, что его ограничивает. Вот четыре параметра, которые нужно настроить перед тем, как агент начнет работать без присмотра. Белый список получателей и дневной лимит расходов применяются к SMS. У электронной почты и WhatsApp их нет, поэтому области действия ключа и кошелек — это то, что ограничивает агента там. На той же странице рассматриваются безопасные повторные попытки: отправьте заголовок Idempotency-Key или используйте --idempotency-key в CLI, и повторный запрос будет принят только один раз.
API-ключи с ограниченной областью действия. API-ключ принадлежит одному рабочему пространству и содержит области действия, которые вы ему даете, каждая из которых является продуктовой областью на уровне чтения или записи. Ключ, который отправляет SMS и больше ничего не делает, имеет sms:write, и запрос вне его областей действия возвращает 403. Ключ не может выпустить другой ключ и не может получить доступ к биллингу.
Вход в систему должен иметь api_keys:write и области действия, которые будет нести ключ. Учетные данные после регистрации через терминал уже содержат их, поэтому после bird auth create-org вы запускаете вторую команду отдельно. Не входите в систему снова: новый вход заменяет учетные данные регистрации. Запустите это в оболочке, где BIRD_API_KEY не установлен, потому что CLI использует этот ключ в приоритете перед входом, а ключ не может выпускать ключи.
Затем дайте агенту ключ и ничего более широкого. Установите BIRD_API_KEY в окружении агента или отправьте ключ как токен носителя (bearer token) из вашего кода. Вход в систему остается сохраненным на машине, где он был выполнен, и агент там без BIRD_API_KEY использует его. Запустите агента в другом месте или удалите вход с помощью bird auth logout.
Запрет по умолчанию для направлений SMS. Рабочее пространство отправляет SMS в страны из белого списка направлений. Белый список начинается пустым, и Bird добавляет страну вашей организации, когда она установлена. Отправка через SMS API в любую другую страну отклоняется с ошибкой 422 SMSDestinationNotEnabled до того, как будет определен отправитель, поэтому агенту, нацеленному на неожиданную страну, будет отказано. Коды подтверждения не используют этот список. У Verify есть свой собственный список, где каждая страна включена по умолчанию, а у Voice есть свои собственные настройки.
Дневные лимиты расходов. Каждая страна назначения SMS может иметь дневной лимит расходов в валюте вашего кошелька. Как только дневные расходы на эту страну достигают лимита, Bird отказывает в новых сообщениях до полуночи по UTC. Лимит не является точным: расходы учитываются, когда сообщение тарифицируется, поэтому уже принятые сообщения могут превысить дневной итог. Коды подтверждения, отправленные по SMS, учитываются в лимите. Эта команда включает Нидерланды с лимитом 25 евро в день в рабочем пространстве, чей кошелек в евро:
Изменение белого списка или лимита требует области действия sms_management на уровне записи. Дайте отправляющему агенту sms, сохраните sms_management для учетных данных, которые настраивают рабочее пространство, и агент не сможет повысить свои собственные лимиты.
Предоплатный кошелек. Отправки с оплатой по мере использования списываются с предоплатного кошелька вашей организации. Отправка SMS, которую баланс не может покрыть, отклоняется с ошибкой 402. Некоторые списания происходят после того, как отправка принята (электронная почта в платном тарифном плане Email и сборы, взимаемые при доставке), а автоматическое пополнение пополняет кошелек с сохраненной карты, поэтому ознакомьтесь с правилами кошелька, прежде чем рассматривать баланс как жесткий лимит. Операции биллинга требуют разрешения на биллинг организации, которое API-ключ не может иметь. Дайте агенту без присмотра ключ с ограниченной областью действия, и добавление средств останется за людьми, которые владеют бюджетом.
Что делать дальше
- Дайте агенту собственный номер телефона и почтовый ящик: адрес inbox.ai и выделенный номер, которые могут как отправлять, так и принимать сообщения. Перед первым номером человек пополняет кошелек, а владелец организации завершает проверку личности. В руководстве указано, какие шаги заказа требуют участия человека.
- Bird для европейских клиентов: нидерландское юридическое лицо, с которым вы заключаете договор, регион eu1 и Соглашение об обработке данных.
- Отправка кодов SMS для Supabase Auth с помощью Bird: коды входа по телефону для проекта Supabase, отправленные через SMS API Bird.
- Настройте своего агента кодирования: вставьте одну подсказку, и ваш агент установит CLI и навыки Bird.











