Skip to content

Исследование кода в чате ​

Доступ модели к кодовой базе строится на инструментах, подключаемых через MCP: платформа не поставляет код-сервер и не знает путей к коду. Администратор подключает к mcp-gateway любой MCP-сервер с инструментами исследования кода (Code Context Engine, serena, git-коннектор, собственный) — ai-router сам распознаёт такие тулы по именам и подставляет их в ход.

Какие имена тулов распознаёт ai-router ​

Имена квалифицируются как mcp__{slug}__{tool}; смотрится только часть {tool}:

  • Поиск по коду (подставляется в eager-поиск и «promised search»): имя содержит search или query — например context_search, search_files, code_search. Запрос юзера кладётся в первый найденный параметр из query/q/search/text/prompt.
  • Grep (факты для API-диаграмм: @Router, .Group(, .GET(): grep, rg, ripgrep, search_files, find_text. Паттерн кладётся в pattern/regex/query/…, скоуп — в path/glob/include.
  • Чтение файла (read_file, get_file, read): путь кладётся в path/file_path/filepath/file/target/uri.
  • Сохранение при роутинге тулов для запросов про код (слова «код», «архитектур», «зависимост», «ревью», …): всё перечисленное выше плюс имена с expand, context, recall, list_files, list_dir — например expand_chunk, related_context, session_recall.

Схемы параметров сервер адаптирует сам — жёсткого контракта нет, имена аргументов берутся из JSON-schema тула.

Как подключить ​

  1. Зарегистрировать сервер в mcp-gateway (админ API POST /api/v1/servers, транспорт stdio или streamable_http), проверить: POST /api/v1/servers/{slug}/test.
  2. Выбрать, куда едут тулы:
    • Пространство — slug привязывается к пространству как его MCP-сервер;
    • Обычный чат (без ассистента) — переменная AI_CODE_MCP_SLUGS в ai-router (CSV со списком слагов код-серверов);
    • Multi-agent / obs — слаги обнаруживаются автоматически через discovery включённых серверов гейтвея.
  3. Системный агент code-research (packs/usagent/code-research) берёт слаги из AI_CODE_MCP_SLUGS и вызывает только инструменты исследования кода. Агент task-systems-analysis сначала ищет задачи в базе знаний и вызывает code-research только если тот установлен и код-сервер отвечает. ai_chat_agents остаётся для кастомных ассистентов администратора.

Безопасность ​

Код, прочитанный тулами, попадает в историю чата и к провайдеру модели. Выбирайте read-only серверы, ограничивайте корень поиска проектом и не подключайте серверы, которые отдают .env и ключи: deny-листов на стороне платформы нет — ответственность за содержимое выдачи на подключаемом сервере.