Dev48
ЯЗЫК
  • О нас
  • Услуги
  • Индустрии
  • Технологии
  • Статьи
  • Контакты
Забронировать звонок
    Главная/Статьи/Chto mozhet delat ii agent v bird cli mcp registratsiya cherez terminal i kontro
Dev48
info@dev48.org+375 29 320-40-96WhatsApp@isky_by

© 2026 · Все права защищены.

Что может делать ИИ-агент в Bird: CLI, MCP, регистрация через терминал и контроль расходов

Источник: Bird•16 ноября 2026 г. в 15:32

Что может делать ИИ-агент в Bird: CLI, MCP, регистрация через терминал и контроль расходов

Что ИИ-агент использует в Bird, со ссылками: CLI Bird, размещенный MCP-сервер, регистрация аккаунта из терминала и контроль того, что он может потратить.

В сентябре мы объявили, что коммуникационная инфраструктура 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.
← Все статьи

О чём эта статья

Ещё в разделе «Телеком и сети»

Все →
Vonage Video API 2.36: логика повторных попыток, наблюдаемость и поддержка iOS 27
Vonage API Platform

Vonage Video API 2.36: логика повторных попыток, наблюдаемость и поддержка iOS 27

Поиск номеров теперь доступен пользователям суборганизаций
Telnyx

Поиск номеров теперь доступен пользователям суборганизаций

От B20 до Брюсселя: сети, масштаб и определенность для конкурентоспособного ИИ
Telefónica

От B20 до Брюсселя: сети, масштаб и определенность для конкурентоспособного ИИ

SES и ITU расширяют инициативу цифрового обучения Partner2Connect на 30 африканских школ
SES

SES и ITU расширяют инициативу цифрового обучения Partner2Connect на 30 африканских школ

Цифровая безопасность: как защитить доверие перед лицом мошенничества и искусственного интеллекта
Telefónica

Цифровая безопасность: как защитить доверие перед лицом мошенничества и искусственного интеллекта

SpaceX впервые в истории поймала верхнюю ступень ракеты StarshipПресса
SpaceX

SpaceX впервые в истории поймала верхнюю ступень ракеты Starship

Ещё от MessageBird

Оглядываясь назад, двигаясь вперед: итоги 2025 года с Bird
MessageBird

Оглядываясь назад, двигаясь вперед: итоги 2025 года с Bird

Конец вспомогательного ИИ: почему автономный маркетинг приходит на смену вторым пилотам
MessageBird

Конец вспомогательного ИИ: почему автономный маркетинг приходит на смену вторым пилотам

Ваши маркетинговые данные не просто разделены по изолированным хранилищам. Они разбиты вдребезги (и вот как это исправить без сноса стека)
MessageBird

Ваши маркетинговые данные не просто разделены по изолированным хранилищам. Они разбиты вдребезги (и вот как это исправить без сноса стека)

Руководство по отправке писем Google: что видят отправители и что делать
MessageBird

Руководство по отправке писем Google: что видят отправители и что делать

Bird привлекает $450 млн и открывает свою инфраструктуру для ИИ-агентов
MessageBird

Bird привлекает $450 млн и открывает свою инфраструктуру для ИИ-агентов