---
title: "AI и MCP"
description: "Подключение агента, discovery и проверка результата."
group: "Техническая документация"
order: 21
---

## Адреса этого стенда

- Документация: https://context4.me/docs.md
- Индекс для агента: https://context4.me/docs/agent-index.json
- Консоль и подключения: https://console.context4.me/integrations
- MCP: https://context4.me/mcp
- HTTP API: https://context4.me/v1
- Composio base URL: https://context4.me/compat/context4/v1
- OpenAPI: https://context4.me/docs/openapi.json
- Каталог HTTP/MCP: https://context4.me/docs/api-index.json
- Маршруты Composio: https://context4.me/docs/compat-routes.json
- Коннекторы: https://context4.me/docs/connectors.json


# AI и MCP

## Подключение

Адрес MCP этого стенда: `https://context4.me/mcp`. Для облачного клиента он должен быть доступен по HTTPS. Клиент с поддержкой remote HTTP MCP обнаружит OAuth, откроет браузерный вход и запросит доступ к выбранному рабочему пространству. API-ключ Context4 для этого сценария не нужен. [Быстрый старт](https://context4.me/docs/quickstart.md) начинается с готового промпта на странице [подключения](https://context4.me/connect).

Не создавайте вручную provider authorization URL. Ссылка приходит от Context4. Вход в Context4 и подключение аккаунта провайдера — разные разрешения. Провайдер может требовать собственный ключ, OAuth consent или credentials в защищённой форме.

Автоматизации могут использовать API-ключ в `Authorization: Bearer`, `x-consumer-api-key` или `x-api-key` согласно настройке клиента. Секрет не включается в URL. HTTP ресурс поддерживает `POST`, `GET`, `DELETE /mcp`; транспорт — Streamable HTTP.

## Рабочая последовательность агента

1. `CONTEXT4_SEARCH_TOOLS`: найти действие по задаче; проверить connection status и теги.
2. `CONTEXT4_GET_TOOL_SCHEMAS`: получить точные input/output schemas найденных `tool_slug`.
3. `CONTEXT4_MANAGE_CONNECTIONS` с `action: list`: проверить аккаунты. С `action: connect` получить существующее активное подключение либо hosted Connect Link.
4. Показать пользователю полученную ссылку. При наличии `connection_id` вызвать `CONTEXT4_WAIT_FOR_CONNECTIONS`; повторять по `retry_after_ms`, пока статус не станет active либо терминальным отказом.
5. `CONTEXT4_MULTI_EXECUTE_TOOL`: передать 1–20 инструментов с аргументами из схем; явно указать `connection_id`, если аккаунтов несколько.
6. Проверить каждый элемент `results`: `succeeded`, `pending` или `error`. Пустые данные сообщить как пустые; pending не выдавать за успех.

Полный набор и схемы: [MCP-инструменты](https://context4.me/docs/mcp-tools.md). Поиск ранжирует совпадения и не является полным перечнем интеграций. Теги `read-only`, `destructive`, `idempotent`, `open-world`, `curated` помогают отбору; все `tags` должны присутствовать, любое совпадение `exclude_tags` исключает результат.

## Сессии и динамические инструменты

Глобальный `/mcp` показывает пять стабильных метаинструментов. Адрес сессии `/mcp?session=` возвращается при создании сессии и показывает её snapshot инструментов, разрешённые feature flags метаинструменты и `context4.get_execution`. Схемы provider-инструментов зависят от закреплённой версии каталога; используйте фактический `tools/list`.

`context4.get_execution` принимает объект с единственным обязательным строковым `execution_id`; дополнительные поля схема не объявляет. Он позволяет получить состояние и терминальный результат pending-вызова. SDK session mode также публикует включённые алиасы `COMPOSIO_SEARCH_TOOLS`, `COMPOSIO_GET_TOOL_SCHEMAS`, `COMPOSIO_MANAGE_CONNECTIONS`, `COMPOSIO_WAIT_FOR_CONNECTIONS`, `COMPOSIO_MULTI_EXECUTE_TOOL`. Они направляются в те же обработчики.

Если session flag workbench включён, могут перечисляться `COMPOSIO_REMOTE_WORKBENCH` и `COMPOSIO_REMOTE_BASH_TOOL`: они возвращают `not_supported`, поскольку удалённый sandbox в этом развёртывании не реализован. Наличие имени в списке не является обещанием работающего shell.

Сессия `readOnly` разрешает только инструменты с тегом `read-only`; инструмент без тега считается записью. Поиск и метаисполнение внутри такой сессии наследуют ограничение. TTL, отзыв и call budget сессии проверяются также при выполнении.

## Результаты и ошибки

MCP-ответ содержит `structuredContent` и текстовый JSON в `content`. Неизвестное имя или некорректные аргументы дают error result с `isError: true`; транспортный успех сам по себе не означает успех инструмента. Ошибки внутри пачки проверяются отдельно в каждом `results`.

`connection_required` требует подключения, `connection_ambiguous` — выбора аккаунта, `authorization_pending` — ожидания, `invalid_arguments` — сверки схемы. При `permission_denied` и `rate_limited` устраните ограничение; при `execution_pending` используйте execution id и указанный интервал. `execution_failed` не доказывает, что внешняя запись не применялась.

Права на чтение не разрешают агенту делать тестовую запись. Первую проверку выполняйте безопасным доступным чтением. Удаления, изменения и сообщения выполняются только по явному поручению пользователя.