Основные понятия.
Аккаунты, инструменты и рабочие пространства.
Рабочее пространство
Объединяет подключения, настройки и доступ участников. Перед действием проверьте, в каком пространстве вы работаете.
Коннектор и подключение
Коннектор описывает возможности сервиса. Подключение — авторизованный аккаунт в вашем рабочем пространстве. Это разные вещи.
Действие и результат
Инструмент имеет схему входа и результата. AI может ошибиться: проверяйте выбранный аккаунт и последствия изменений.
Инструмент, endpoint и сессия
Инструмент — действие с входной схемой и опубликованным идентификатором. Endpoint — HTTP-метод провайдера с путём, параметрами и JSON Schema; он обнаруживается отдельно и не появляется автоматически среди MCP tools. Proxy описывает вызов endpoint через подключённый аккаунт.
Сессия закрепляет доступный набор инструментов и настройки выполнения, включая TTL, budget и read-only policy. Выполнение — отдельная долговечная запись о конкретном вызове, его состоянии, попытках и результате. Ни существование сессии, ни принятие запроса не означают успех у провайдера.
Конечный пользователь
В серверной интеграции user_id связывает действия с конечным пользователем приложения. Это opaque reference, а не поле для email или персональных данных. Несколько пользователей одного workspace могут иметь отдельные аккаунты одного сервиса. Общий аккаунт доступен только при подходящих настройках sharing и ACL.