AI и MCP.

Подключение

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

Не создавайте вручную 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-инструменты. Поиск ранжирует совпадения и не является полным перечнем интеграций. Теги 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 не доказывает, что внешняя запись не применялась.

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