← Все гайды

Как подключить ИИ-агента к проектам по MCP (Claude Code, Cursor, Codex)

· 2 мин чтения

Как дать ИИ-агенту доступ к схемам и спецификациям проектов: ключ API, подключение MCP-сервера в Claude Code, Cursor, VS Code и Codex, навык для агента и история изменений.

ИИ-агенты в IDE и терминале могут работать с документацией так же, как с кодом: прочитать спецификацию перед реализацией, обновить схему БД после миграции, разложить файлы по папкам. Для этого у Помощника SA есть MCP-сервер.

Что понадобится

  • Тариф «Про» или выше.
  • Ключ API: Профиль → Ключи API. Ключ даёт агенту ваши права — храните его в личной конфигурации клиента, не в репозитории.

Быстрое подключение

  1. Откройте страницу «ИИ-агенты».
  2. Скачайте инструкцию helper-sa-mcp-setup.md и передайте её агенту со словами «Выполни инструкцию из файла», приложив ключ.
  3. Агент сам пропишет MCP-сервер в своём клиенте, установит навык работы с Помощником SA и проверит подключение.
Страница подключения ИИ-агентов с настройками клиентов
Готовые настройки для Claude Code, Cursor, VS Code и Codex

Ручное подключение

На той же странице — готовые настройки для каждого клиента. Например, для Claude Code — одна команда:

claude mcp add --transport http --scope user helper-sa https://helper-sa.ru/api/mcp \
  --header "Authorization: Bearer sah_ВАШ_КЛЮЧ"

Для Cursor и VS Code — блок в mcp.json, для Codex — раздел в config.toml, для клиентов без HTTP — мост mcp-remote.

Что умеет агент

  • Искать проекты, папки и артефакты, в том числе по тексту.
  • Читать артефакты и вносить точечные правки без пересылки файла целиком.
  • Создавать артефакты в нужной папке, переносить и раскладывать их.
  • Проверять синтаксис по тем же правилам, что в редакторах.
  • Смотреть историю, сравнивать версии и откатывать изменения.

Контроль

Все изменения агента попадают в историю версий с источником «MCP»: видно, что и когда он поменял, и любую правку можно откатить (см. «История версий»). Те же операции доступны через REST API — документация API.

Примеры задач для агента

  • «Найди в проекте “Интеграция с банком” спецификацию платежей и добавь метод возврата по аналогии с оплатой».
  • «Сравни модель БД в db/model.dbml с миграциями в репозитории и обнови модель».
  • «Разложи артефакты проекта по папкам api, schemas, docs».
  • «Что поменялось в orders.yaml за последние три версии?»

Вопросы и ответы

Какие клиенты поддерживаются? Любые клиенты MCP с транспортом Streamable HTTP (Claude Code, Cursor, VS Code, Codex) и остальные через мост mcp-remote.

Как обновить навык агента? Передайте агенту свежую инструкцию со словами «Обнови подключение по инструкции» — ключ повторно не нужен.

Что если агент сломал файл? Ответ на каждое изменение содержит проверку синтаксиса, а любую версию можно откатить.

Гайд помог?