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

Что в ролике
Если вы подключаете корпоративные данные к 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 терминов
- MCPстандарт подключения внешних сервисов и инструментов к ассистентам вроде ChatGPT и Claude
- CLIинтерфейс командной строки, где команды вводятся текстом
- скиллыфайлы-инструкции, которые описывают агенту, какие команды доступны и как их вызывать
- OAuthспособ дать сервису доступ к данным без передачи пароля, через подтверждение на сайте сервиса
- контекстобъём информации, который агент держит в запросе и который влияет на точность и стоимость вызова
- elicitationзапрос дополнительных данных у пользователя через интерфейс клиента, например ссылки для входа
Связки из этого ролика
6 шт.- MCP
- CLI
- OAuth
- OpenAPI
- JSON
- Unix
Компоненты
9 шт.Формат: разбор · для практикующих · уверенность разметки 0.85 · источник