Как подключить Cursor к Agnostic через MCP

Допустим, вы открыли сайт в Cursor и попросили добавить форму заявки. Агент посмотрел код, предложил таблицу leads и начал писать обращение к ней. Но заявки у вас уже хранятся в другой коллекции, для сотрудников настроен вход, а изменения сегодня нужно проверить в Preview. Если в открытых файлах этого не видно, агенту приходится опираться на неполную картину проекта.

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

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

В этом руководстве используется официальный Agnostic MCP через stdio. Cursor будет запускать программу на вашем компьютере, а она обратится к API Agnostic с выданным доступом; отдельный сетевой порт для MCP открывать не понадобится. Если вы пользуетесь Codex или Claude Code, последовательность будет такой же, только в командах потребуется другое имя клиента. К этому вернёмся в ответах на вопросы.

Сначала убедимся, что на компьютере есть Cursor и Node.js с npm, а ваша учётная запись имеет доступ к нужному проекту Agnostic. Для новой установки выбирайте поддерживаемую LTS-ветку Node.js; здесь ориентируемся на версию 22.12 или новее в ветке 22. В требованиях пакетов вы можете увидеть минимум 18.18, но Node 18 уже снята с поддержки. Этот минимум объясняет совместимость пакета, а для нового рабочего окружения лучше взять поддерживаемую версию.

node --version
npm --version

После запуска обеих команд вы должны увидеть номера версий. Если вместо них появилось сообщение, что команда не найдена, завершите установку Node.js и откройте новый терминал, чтобы он подхватил путь к программам. Дальше имеет смысл идти, когда работают и node, и npm: иначе установка пакетов остановится ещё до какого-либо обращения к Agnostic.

Теперь откройте в Cursor папку, с которой собираетесь работать. Если будете менять код сайта или сервиса, нужен его workspace, полученный через Agnostic CLI: в нём находятся код и связь с проектом платформы. Если пока хотите только изучить коллекции и доступные ресурсы, достаточно отдельной папки задачи. Получать весь код ради первого чтения контекста не требуется.

В интерфейсе Agnostic выберите проект, затем окружение и нажмите MCP рядом с ним. Здесь стоит остановиться на секунду и прочитать название среды: в Dev, Preview и Live могут быть разные данные и публикации. Даже если коллекции называются одинаково, агент должен подключиться именно туда, где вы собираетесь работать.

01 / Выберите контекстОткрыть снимок

В открывшемся окне будут ID проекта и окружения и инструкция для агента. Её можно скопировать кнопкой «Скопировать инструкцию» и передать в Cursor, чтобы он помог с настройкой. Если удобнее пройти шаги самостоятельно, используйте команды ниже со своими ID из этого окна. ID указывают, с чем работать; доступ вы авторизуете отдельно, поэтому токены в инструкции не нужны.

02 / Возьмите инструкцию своего проектаОткрыть снимок

Для подключения понадобятся два пакета. CLI подготовит настройки и будет выполнять команды локальной работы с платформой, а MCP-пакет содержит программу, которую Cursor запустит для общения с Agnostic. Установим их вместе, чтобы к моменту настройки у нас уже были обе части подключения.

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

Дождитесь завершения установки и посмотрите, с каким результатом она закончилась. Если npm сообщает о неподходящей версии Node.js, недоступном каталоге или ошибке загрузки, сначала разберите именно это сообщение. Например, ошибка прав на каталог ещё не означает, что нужно повторить всё с sudo: она может быть связана с тем, как установлен Node.js и куда npm пытается поместить глобальные команды.

Следующую команду запустите из открытой папки workspace или задачи. Вместо <project-id> и <environment-id> вставьте значения из своего окна MCP; угловые скобки при этом уберите. Сначала оставим флаг --dry-run, чтобы увидеть, какие настройки CLI собирается применить и потребуется ли вход в Agnostic.

agnostic agent setup cursor --project <project-id> --environment <environment-id> --dry-run

Во время dry-run конфигурация MCP не меняется и браузер для выдачи доступа не открывается. Команда показывает план, в том числе нужный файл настроек и состояние авторизации. Если вы уже входили раньше, она может использовать действующий доступ для чтения контекста через API. Поэтому даже этот предварительный шаг иногда требует соединения с Agnostic.

В плане вы увидите пользовательский файл ~/.cursor/mcp.json. Cursor поддерживает также конфигурацию отдельного проекта, но команда Agnostic записывает подключение в общий пользовательский файл. Там хранится способ запуска MCP-сервера; вставлять туда токен не нужно. Выбранный контекст задачи и право обращаться к ресурсам платформа проверит отдельно.

Если запись agnostic в этом файле уже указывает на другую программу, CLI сообщит о конфликте. Откройте существующую запись и выясните, как она появилась: возможно, это прежняя ручная настройка. Удалять ради неё весь mcp.json не стоит, поскольку в том же файле могут быть другие подключения, которыми вы продолжаете пользоваться.

Если в плане указаны нужные проект и окружение, можно повторить команду без --dry-run. При отсутствии подходящего доступа CLI предложит авторизацию в браузере. Если доступ уже действует, новое окно может не открыться: команда использует имеющуюся авторизацию и продолжит настройку.

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

На странице авторизации проверьте свою учётную запись и область, к которой подключается устройство: проект, окружение, срок и запрашиваемые разрешения. Например, если вы планировали попробовать подключение в Dev, а видите рабочий Live, сначала вернитесь к ID в команде. После выдачи доступа агент будет работать в указанной области, поэтому исправить выбор удобнее сейчас.

После авторизации вернитесь в терминал и дождитесь завершения setup. Команда должна сохранить контекст и зарегистрировать MCP в Cursor; если в результате есть просьба перезапустить Cursor, выполните её. Открытое приложение может всё ещё использовать старую конфигурацию, хотя новая запись уже появилась на диске. Именно поэтому дальше мы проверим подключение отдельным запросом.

Если коллега предлагает прислать свой рабочий JSON, лучше сравнить устройство настройки, а setup выполнить у себя. У него могут отличаться пути к программам, проект и разрешения. Токен также не нужно передавать в чат: браузерная авторизация связывает доступ с вашим устройством без ручного переноса секрета в беседу.

agnostic agent doctor cursor --project <project-id> --environment <environment-id>

Команда doctor проходит путь, который мы собирались настроить: читает конфигурацию Cursor, проверяет API и запускает MCP-сервер через stdio. Затем запрашивает инструменты, контекст проекта и доступные действия. Поэтому она полезна даже после успешного setup: теперь мы проверяем, что записанную конфигурацию действительно можно использовать для обращения к Agnostic.

В обычном выводе будет видно состояние API, контекста и MCP stdio. Если один из этапов завершился ошибкой, повторите команду с --json: так вы получите подробный результат и сможете посмотреть конкретное поле, не пытаясь угадать причину по общему сообщению. Основные поля находятся внутри объекта data и разобраны в таблице ниже.

agnostic agent doctor cursor --project <project-id> --environment <environment-id> --json

Читать этот результат удобнее по месту сбоя. Если api.ready подтверждает доступ, но mcp.ready сообщает об ошибке, сначала проверьте запуск локальной программы и её настройку. Если сервер запускается, а API отказывает в доступе, вернитесь к авторизации и роли пользователя. Такое разделение позволяет исправлять причину, вместо того чтобы переустанавливать всё подключение при любой неполадке.

Когда doctor завершится успешно, останется проверить, что новые инструменты видит сам Cursor в вашей беседе. Откройте новую беседу и попросите прочитать контекст, пока ничего не меняя. Для этого можно использовать такой запрос.

Проверь подключение Cursor к Agnostic MCP.
Если его нет, попроси инструкцию из меню MCP выбранного
проекта и окружения Agnostic, покажи план настройки
и продолжи после моей авторизации в браузере.
Инструкция: https://agn0.ru/blog/connect-cursor/.

Прочитай контекст проекта через инструмент Agnostic MCP.
Назови проект и окружение, перечисли доступные действия.
Отдельно укажи ограничения подключения.
В самом проекте ничего не изменяй.

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

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

Если понадобится помощь разработчика, сохраните команду, точный текст или код ошибки и этап, на котором она появилась, убрав из сообщения секреты. Например, сведения о том, что API отвечает, а запуск MCP stdio заканчивается определённой ошибкой, сразу сузят поиск до локальной программы. По одному сообщению «MCP не работает» пришлось бы заново проверять всю цепочку.

При обновлении устанавливайте CLI и MCP вместе той же командой npm и затем повторяйте doctor. Особенно полезно сделать это после смены версии Node.js или способа его установки: путь к глобальным программам мог измениться, хотя права в Agnostic остались прежними. Если setup обнаружит старую запись, сравните её с новым путём и устраните конфликт до повторной проверки.

После того как агент прочитал правильный контекст, можно перейти к небольшой задаче внутри проекта. Для нашей формы попросите предложить поля заявки с учётом уже существующей коллекции и объяснить, какие изменения понадобятся. Так вы сможете оценить план до его выполнения. Если дело дойдёт до кода, проверьте ещё и workspace: он должен относиться к тому сайту или сервису, который вы собираетесь менять.

Доступ Local Agent в Agnostic ограничен ролью пользователя, окружением и выданным допуском. Если допуска сессии нет, точное действие подтверждает пользователь в платформе. Если он выдан, сервер проверяет, входит ли действие в его границы. Поэтому подключённый агент сможет выполнить только разрешённые операции, а публикация потребует отдельного действия; подтвердить свой запрос от вашего имени агент не может.

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

Команду doctor с ID своего проекта удобно сохранить в рабочей заметке без токенов. Тогда после обновления Cursor или перехода на другой компьютер у вас будет готовая проверка того же подключения. Если результат изменится, по её выводу можно будет увидеть, требуется ли снова настроить локальную программу, авторизоваться или поправить выбранный контекст.