К содержимому
Дайджест

Airbyte: как проектировать MCP и CLI для агентов

AI Engineer·9 октября 2026·18:20
текст даёт основное понять, как устроено промо
Открыть на YouTube
Доклад инженера Airbyte о том, как спроектировать MCP-сервер и CLI так, чтобы ими могли пользоваться AI-агенты, а не только люди, с примерами и ограничениями.

Что в ролике

Если вы подключаете корпоративные данные к ChatGPT или Claude, Airbyte предлагает тонкие интерфейсы MCP и CLI поверх общего API, а не отдельные реализации платформы. Докладчик показывает, как через MCP не-технический пользователь спрашивает, какие доступны коннекторы, и получает ответ: четыре штуки, а затем просит показать пять платящих клиентов с открытыми тикетами Zendesk — система сама сопоставляет данные из Stripe и Zendesk. Среди уроков — держать число инструментов маленьким: для работы с коннектором оставлены только describe и execute, а остальное раскрывается по мере надобности, чтобы не перегружать контекст. Аутентификацию советуют строить на OAuth, потому что спецификация MCP и основные клиенты заточены под этот флоу, а пользователи ожидают долгоживущих сессий как в мобильном приложении. Механизм elicitation в MCP оказался нерабочим: URL-режим поддерживается не всеми клиентами, например Claude Desktop его не поддерживает, поэтому Airbyte сделал собственный виджет для входа. В CLI главное — принимать и возвращать JSON, держать единый порядок «существительное-глагол» вроде connectors list и поставлять скиллы, чтобы агент вообще узнал о командах. Ещё важно не ждать интерактивного ввода от человека: для агента креды и параметры должны приходить через флаги, переменные окружения или конфиги, иначе агент зависнет. Сравнение таково: MCP удобен для быстрых прототипов и не-технических пользователей, но ограничен, например в Claude лимит 2 килобайта на описания, а CLI раскрывается в длинных задачах и Unix-пайпах, но требует следить за версиями.

Практика

Что получишь
Вы получите набор проверенных на практике правил для MCP и CLI: держать инструменты узкими, полагаться на OAuth, использовать JSON-контракт и скиллы, а также понимание, где клиенты MCP не поддерживают заявленные возможности.
Первый шаг
Начните с узкого MCP или CLI для одного ресурса и сразу добавьте skill-описание с примерами вызовов, чтобы агент мог обнаружить команду без чтения документации.
Цифры
  • —10 раз в день — так часто меняется платформа Airbyte, из-за этого интерфейсы строят поверх общих API
  • —2 инструмента — describe и execute — оставили в MCP для работы с коннектором, чтобы держать контекст компактным
  • —5 платящих клиентов с открытыми тикетами — столько вернул кросс-запрос Zendesk и Stripe в демонстрации
  • —2 килобайта — лимит Claude на описания серверов и инструментов в MCP
Честно
Доклад — это презентация продукта Airbyte: спикер в конце зовёт на стенд компании и на работу. Готового кода и точных команд в ролике нет, часть скриншотов и листингов видна только на экране. Ограничения клиентов MCP (например, лимит 2 килобайта в Claude) актуальны на момент доклада и могут измениться.
Если слова незнакомы — 6 терминов

Связки из этого ролика

6 шт.

Компоненты

9 шт.

Формат: разбор · для практикующих · уверенность разметки 0.85 · источник