Как подключить Agnostic MCP к локальному агенту

Agnostic MCP подключает локальный coding agent к выбранному проекту и окружению. Агент получает безопасный контекст, видит разрешённые действия, может подготовить изменение и проверить его результат, но не может подтвердить своё действие, прочитать секрет или напрямую обратиться к облачному провайдеру.

Официальная автоматическая настройка поддерживает Codex, Claude Code и Cursor. Сервер работает локально через stdio и не открывает отдельный сетевой порт.

Ссылка о работе со своим агентом на главной странице открывает эту инструкцию. Чтобы подключить клиент, выберите свой проект и окружение, затем выполните шаги ниже. Просмотр главной страницы сам по себе доступ агенту не выдаёт.

• Нужно, чтобы агент учитывал актуальные таблицы, автоматизации, App Auth,

подключения и возможности Runtime SDK.

• Вы хотите создавать или изменять ресурсы из локального агента с подтверждением в Agnostic или в пределах явно выданного допуска сессии.
• Агент должен проверить локальные изменения, отправить разрешённую часть

workspace и проследить за сборкой.

• Установите Node.js 18.18 или новее и npm.
• Установите Codex, Claude Code или Cursor.
• Для работы с кодом склонируйте сервис или сайт через Agnostic CLI. Для изменения ресурсов достаточно отдельной папки задачи и ID проекта/окружения.
• Для изменения ресурсов или отправки кода нужна роль с соответствующими

правами. Доступные агенту действия всегда ограничены вашей ролью и выбранным окружением.

Создание нового стартового App доступно только в Live. Для этой задачи выберите Live и обновите контекст агента. В Dev и Preview такое действие не предлагается: подтверждение в этих окружениях не разрешает создание в Live. Изменение кода, сборка и публикация существующего App остаются отдельными действиями.

Через интерфейс Agnostic

1. Откройте нужный проект и выберите рабочее окружение в меню слева.
2. Нажмите MCP справа в общей строке окружения под названием проекта. Открытая кнопка выделяется; закрыть окно можно повторным нажатием или клавишей Escape.
3. Проверьте ID проекта и окружения.
4. Нажмите «Скопировать инструкцию» и отправьте текст своему coding agent.

Вместо копирования можно скачать agnostic-mcp-context.txt или передать агенту снимок открытого окна.

1. Агент сначала покажет безопасный dry-run. Проверьте план и разрешите

продолжить настройку.

1. Завершите browser authorization в Agnostic и дождитесь результата

диагностики.

Инструкция содержит только выбранный контекст и публичные команды настройки. Токены, секреты и provider credentials в неё не попадают.

Вручную через CLI

1. Установите CLI и официальный MCP-сервер:

   npm install -g @nsp-labs/agnostic-cli @nsp-labs/agnostic-mcp

1. Перейдите в папку workspace или в отдельную папку задачи для работы с ресурсами.
2. Скопируйте ID проекта и окружения из меню MCP, затем запустите настройку

для своего клиента:

   agnostic agent setup codex \
     --project <project-id> \
     --environment <environment-id>

Для другого поддерживаемого клиента замените codex:

   agnostic agent setup claude --project <project-id> --environment <environment-id>
   agnostic agent setup cursor --project <project-id> --environment <environment-id>

1. В открывшемся окне Agnostic проверьте проект, окружение, устройство, срок

доступа и разрешения профиля Local Agent. Подтвердите доступ только для ожидаемого клиента.

1. Дождитесь первого обновления контекста и сообщения об успешной настройке.
2. Если CLI попросит, перезапустите Codex, Claude Code или Cursor.
3. Проверьте подключение:

   agnostic agent doctor codex

Для Claude Code или Cursor укажите соответственно claude или cursor.

Перед изменением настроек можно посмотреть план:

agnostic agent setup codex \
  --project <project-id> \
  --environment <environment-id> \
  --dry-run

--dry-run не открывает браузер, не выдаёт доступ и не изменяет файлы или настройки MCP-клиента.

Начните с явной просьбы прочитать контекст Agnostic. Например:

Прочитай контекст текущего проекта Agnostic и перечисли доступные мне действия.
Ничего не изменяй.

После этого можно дать агенту точную задачу:

Подготовь создание таблицы leads с полями email и status.
Покажи, что изменится, и дождись моего подтверждения в Agnostic.

Без привязки к допуску сессии сценарий выглядит так:

1. Агент читает контекст проекта и список доступных действий.
2. Агент подготавливает одно точное действие и возвращает ссылку на Agnostic.
3. Вы открываете ссылку и проверяете проект, окружение, сводку, риск и срок

действия.

1. Вы подтверждаете или отклоняете запрос в браузере.
2. Агент дожидается результата и обновляет локальный контекст.

Для работы с кодом попросите агента сначала показать локальные изменения. Отправка workspace требует отдельного разрешения MCP-клиента. Сборка включается явно. Публикация остаётся отдельным действием: в режиме «Авто» её нужно подтвердить в Agnostic, а режим «Полный» разрешает её только в пределах явно выданного допуска.

Отправка изменений выполняется на платформе в фоне. Если она не успела завершиться, инструмент отвечает, что отправка ещё идёт. Это не ошибка и не потеря изменений. Агент продолжает ту же отправку через agnostic_workspace_push_resume. Разовая проверка agnostic_workspace_status тоже применит результат локально, когда отправка закончится. Одни и те же изменения не отправляются дважды. Продолжить или отменить ожидающую отправку вручную можно командами agnostic workspace push --resume и agnostic workspace push --cancel.

Работа из Codex до готового результата

Можно сразу поручить весь результат: «Измени страницу, проверь её, отправь код и опубликуй в выбранном окружении». Агент использует MCP, при необходимости CLI или поддерживаемый API. Управление браузером требуется для визуальной проверки или действия, у которого нет программного способа. Вход, ввод секретов и требуемое подтверждение выполняете вы по возвращённой ссылке.

Агент сообщает, какой этап выполняется и что уже проверено: сохранение кода, сборка выбранной версии, публикация и её результат. MCP передаёт реальные изменения статуса; способ их отображения зависит от клиента. Процент готовности не вычисляется из прошедшего времени.

После отправки агент дожидается именно её сборки через agnostic_build_wait. Если вы поручили публикацию, он подготавливает её отдельно и следует действующему допуску. После необходимого подтверждения продолжает проверку той же операции; повторять «продолжай» не требуется. Таймаут ожидания означает продолжение наблюдения, а не повторную отправку или публикацию. В конце агент сообщает результат, адрес и выполненные проверки исходного сценария. Проверка состояния платформы и проверка HTTP-ответа приложения — отдельные шаги.

Ожидание сборки, продолжение отправки через MCP и сообщения прогресса добавлены в текущую разработку; для установленного клиента они станут доступны после выпуска и обновления CLI/MCP.

Data-инструменты управления появляются только у роли администратора или разработчика с явно выданным профилем Local Agent. Права Data read и workspace для них не подходят. Агент должен сначала создать план, показать полный diff и hash, затем подготовить ссылку; подтвердить план можно только в Agnostic. Полный сценарий требует CLI 0.7.0 / MCP 0.3.0 или новее; более старый или несовместимый клиент должен завершиться до любого изменения. MCP не принимает содержимое файла импорта: сначала CLI загружает и проверяет JSONL.gz, затем MCP работает только с полученным артефактом и планом. Если в диагностике есть отсутствующая, неоднозначная, обязательная или относящаяся к другому окружению ссылка, подготовка подтверждения будет заблокирована.

Если агент показывает инструмент подтверждения или отмены Data job, чтения секретов, прямого provider-доступа либо публикации без отдельного действия, не разрешайте вызов. Официальный Agnostic MCP таких инструментов не предоставляет. Таймаут agnostic_data_job_wait прекращает только ожидание и не отменяет серверную задачу.

Попросите агента вызвать agnostic_workspace_doctor. Инструмент отдельно проверяет чтение, push, статус сборки и подготовку публикации, включая реальные CLI-профили и привязку workspace. Роль admin в контексте агента сама по себе не подтверждает готовность push.

agnostic_workspace_renew явно продлевает корректную привязку workspace, сохраняя локальные файлы и исходную версию кода. Если удалённый код изменился, потребуется обычный pull. Renew не восстанавливает отозванные права.

agnostic_service_runtime_check проверяет Runtime SDK внутри выбранной активной ревизии backend-сервиса. Укажите сервис, окружение и ревизию из проекта. Инструмент возвращает безопасный результат проверки без Runtime-токена и без чтения пользовательских записей.

После настройки в .agnostic/ появится локальный снимок контекста и карточки ресурсов. Их не нужно коммитить: workspace push игнорирует эту папку. Токен не записывается в MCP-конфигурацию клиента.

MCP автоматически проверяет актуальность контекста перед подготовкой действия, когда наступает время следующей проверки. Совпадающий снимок не требует пересоздания карточек или ручной синхронизации. Если ресурс изменился, клиент сначала получает актуальный контекст. Сервер проверяет права и окружение при каждом действии; сохранённый снимок не выдаёт доступ.

Чтобы выполнить проверку сейчас и сохранить неизменившиеся карточки:

agnostic context sync --changed-only

Через MCP попросите агента вызвать agnostic_context_sync с changedOnly: true. Для полной пересборки карточек выполните agnostic context sync без флага. Подробности — в инструкции CLI.

Без связи с сервером сохранённые карточки доступны как справка с неподтверждённой актуальностью. Подготовка изменения требует серверной проверки. Возможность работает после обновления CLI, MCP-сервера и Agnostic.

Обновляйте CLI и MCP-сервер вместе:

npm install -g @nsp-labs/agnostic-cli@latest @nsp-labs/agnostic-mcp@latest

Для другого MCP-совместимого клиента не копируйте токен и не переносите конфигурацию вручную. Автоматическая безопасная выдача доступа сейчас поддерживается только для Codex, Claude Code и Cursor.

В диалоге Agnostic откройте меню щита и выберите Настроить допуск. Выберите нужные окружения, инструменты и бюджет; проверьте срок допуска. Для обычной работы используйте Подтверждать за меня, а для выполнения разрешённых действий без повторных вопросов — Полный доступ. После выдачи нажмите Подключить внешний агент, скопируйте инструкцию и отправьте её агенту в папке задачи. Подключение доступно в Dev, Preview и Live, если текущее окружение входит в допуск. В разделе Подключить через терминал можно скопировать команду CLI с точными проектом и окружением.

Вместо CLI агент может вызвать agnostic_session_bind с ID сессии, проекта и окружения. Это привязка существующего допуска, а не выдача нового разрешения. Сервер автоматически выполняет обычные разрешённые действия; опасные действия в режиме «Подтверждать за меня» по-прежнему требуют решения пользователя. Срок, отзыв, бюджет и ваша роль проверяются перед каждым действием. Изменения схемы через Data plan и импорт сохраняют одно подтверждение точного плана. Доступ к чтению записей Data выдаётся отдельно.

Чтобы вернуться к подтверждению отдельных действий, выполните agnostic agent session --clear или передайте null в agnostic_session_bind. Это снимает местную привязку; сам допуск отзывается в Agnostic.

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

Повторите agnostic agent setup codex, затем agnostic agent doctor codex --json. Setup добавляет отсутствующие таймауты и разрешает подготовку действия, подключение выданного допуска и чтение статуса без второго вопроса Codex, сохраняя ваши явные настройки подтверждений. Решение о выполнении остаётся за допуском или точным подтверждением в Agnostic. Отправка workspace сохраняет отдельное согласование клиента.

Doctor проверяет реальное подключение stdio и чтение контекста, а также сообщает об отключённом сервере и скрытых базовых инструментах Codex. Он не проверяет уже открытый чат Codex; после изменения настроек перезапустите подключение.

MCP показывает базовые инструменты даже при отсутствии выбранного проекта или ошибке авторизации; ошибка конкретного вызова объясняет нужную настройку. Контекст проверяется автоматически перед подготовкой действия по времени следующей проверки; карточки обновляются только при изменениях. Ожидание занимает до 20 секунд по умолчанию: WAIT_TIMEOUT содержит текущее действие, которое можно дальше читать через agnostic_action_status. Это не отмена и не повод повторять подготовку или переходить к управлению браузером.

В одной сессии дождитесь завершения предыдущего запуска перед следующим действием. agnostic_action_wait учитывает завершение серверной обработки; один статус succeeded ещё может сопровождаться активным runStatus.

Совпадение манифеста с целевой схемой не означает, что поля уже доступны в Dev. Проверьте выбранное окружение и его применённую версию. Ответы data.schema.diff и data.schema.snapshot показывают её отдельно в environmentSchema; tables в snapshot описывает целевую схему.

Если окружение отстаёт, создайте новый план через agnostic_data_plan для этого окружения, используя актуальную целевую схему. Даже при пустом списке новых изменений план содержит ожидающие миграции. Подготовьте точное подтверждение через agnostic_data_plan_prepare, дождитесь успешного результата и перечитайте схему. Не создавайте те же поля повторно.

data.schema.repair_sync восстанавливает синхронизацию схемы с репозиторием. Это подтверждаемое действие; оно не применяет миграции к окружению. Если после него окружение всё ещё отстаёт, агент получает указание подготовить план схемы.

Если запись отклонена до отправки, агент сообщает определённый отказ и нужное следующее действие. Сначала устраните причину, затем повторите проверку на технических данных. При действительно неизвестном результате автоматического повтора нет: проверьте запись и статус исходного действия перед новым запросом.