MCP

Подключите своих ИИ-агентов

Claude Code, Cursor, Codex, Copilot и любые клиенты MCP получают доступ к вашим проектам «Помощника SA»: читают схемы и спецификации, вносят правки и создают артефакты — с историей версий и откатом.

MCP-серверhttps://helper-sa.ru/api/mcp
АвторизацияAuthorization: Bearer sah_…
Тариф«Про» и выше

  1. 1. Создайте ключ API

    Ключ создаётся в профиле, действует до выбранной даты и даёт агенту ваши права: те же проекты и лимиты тарифа.

    Создать ключ

  2. 2А. Подключите MCP-сервер вручную

    Выберите клиент и выполните команду или добавьте конфигурацию, подставив свой ключ.

    Команда в терминале; сервер будет доступен во всех проектах.

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

    2Б. Или доверьте настройку агенту

    Скачайте инструкцию и передайте её агенту со словами «Выполни инструкцию из файла» (ключ можно приложить в сообщении): агент сам пропишет MCP-сервер в своём клиенте и установит навык работы с «Помощником SA».

    SKILL.md — навык (skill) для Claude Code и других агентов: порядок работы с проектами, правила изменений и отката. Он уже включён в инструкцию.

    Инструкция, навык и описание ручной установки есть и в открытом репозитории: github.com/vt244/helper-sa-mcp

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

MCP-сервер предоставляет агенту 28 инструментов:

Аккаунт

whoamiПод каким аккаунтом и тарифом подключён агент и до какой даты действует тариф
list_toolsКоды инструментов: dbml, openapi, xsd…

Проекты

list_projectsВсе проекты пользователя
search_projectsПоиск проекта по названию, роли, дате
get_projectОдин проект
create_projectСоздать проект
update_projectПереименовать, изменить описание
delete_projectУдалить проект (только по явной просьбе)

Папки и структура

get_project_treeДерево папок и файлов с путями
search_foldersПоиск папок
get_folderПапка с содержимым
create_folderСоздать папку
update_folderПереименовать или переместить папку
delete_folderУдалить папку
place_artifactПоложить файл в папку

Артефакты

list_artifactsАртефакты проекта или личные
search_artifactsПоиск по названию, пути и тексту
get_artifactПрочитать артефакт с номером версии
create_artifactСоздать артефакт в проекте и папке
update_artifactИзменить целиком — с защитой от затирания чужих правок
edit_artifactТочечная правка без передачи файла целиком
validate_artifactПроверить синтаксис — как в редакторе
move_artifactПеренести в проект или в личное
delete_artifactУдалить артефакт

Версии

list_versionsИстория версий с авторами
get_versionПрочитать версию
diff_versionsЧто изменилось между версиями
restore_versionОткатить к версии

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