# Коннекторы и сервисы

Коннектор — это зарегистрированный внешний сервис, который ассистент может вызвать от вашего имени: маркетплейс, CRM, банк, систему документооборота, мессенджер, аналитическую платформу и так далее. В каталоге **99 коннекторов** в 16 категориях, и каждый вызывается через одни и те же три инструмента: получить каталог, прочитать паспорт сервиса, выполнить вызов.

## Как вызываются коннекторы

Коннекторы **не** выставлены как REST-ресурсы — эндпоинта `POST /connectors/{service}/execute` нет. Достучаться до них можно двумя способами:

- **Через ассистента** — запустите [чат-сессию](/docs/openai-compatible) (опционально под [агентом](/docs/agents)); модель сама выберет нужный коннектор и вызов.
- **Через инструменты коннекторов напрямую** — `list_services`, `describe_service` и `connector_execute`, доступные и как нативные инструменты агента, и через [MCP-сервер](/docs/mcp) (`/mcp`, авторизация по bearer). См. [Вызов коннектора](/docs/connector-flow).

REST-эндпоинты под `/api/v1/connectors/*` отвечают только за управление подключением (метаданные экрана подключения, webhook-URL) — но не за исполнение.

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

Прежде чем коннектор вернёт реальные данные, организация-владелец подключает к нему аккаунт. Учётные данные шифруются при хранении и подставляются на каждый вызов. Каталог охватывает три схемы авторизации — API-ключи, popup OAuth и device-code — см. [Подключение аккаунтов](/docs/connector-auth).

## Каталог

Каждый коннектор ниже адресуется своим `key`. Тот же каталог публикуется в машиночитаемом JSON для индексации и интеграций.

**Машиночитаемый каталог**

Полный каталог — `key`, `name`, `description`, `category` — отдаётся в JSON по адресу [`/connectors.json`](/connectors.json) и генерируется из бэкенд-манифестов коннекторов.

_The full connector catalog (99 services across 16 categories) is published as machine-readable JSON at /connectors.json._

## Динамические и ограниченные коннекторы

Две позиции каталога **динамические** и настраиваются под каждого тенанта, а не поставляются как статические сервисы: `custom_api` (вызов любого REST API, который вы опишете) и `mcp_server` (подключение внешнего MCP-сервера). Их нет в списке выше, потому что у них нет фиксированного набора возможностей.

Несколько сервисов **доступны только администраторам** (например `supadata`) — они есть в каталоге, но ограничены на этапе исполнения.

Большинство коннекторов отдают насыщенный структурированный паспорт возможностей; два мессенджер-коннектора (`telegram`, `max_messenger`) отдают тонкий паспорт — только summary и transport, без перечня рецептов.