Appearance
Исследование кода в чате
Доступ модели к кодовой базе строится на инструментах, подключаемых через 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 тула.
Как подключить
- Зарегистрировать сервер в mcp-gateway (админ API
POST /api/v1/servers, транспортstdioилиstreamable_http), проверить:POST /api/v1/servers/{slug}/test. - Выбрать, куда едут тулы:
- Пространство — slug привязывается к пространству как его MCP-сервер;
- Обычный чат (без ассистента) — переменная
AI_CODE_MCP_SLUGSв ai-router (CSV со списком слагов код-серверов); - Multi-agent / obs — слаги обнаруживаются автоматически через discovery включённых серверов гейтвея.
- Системный агент
code-research(packs/usagent/code-research) берёт слаги изAI_CODE_MCP_SLUGSи вызывает только инструменты исследования кода. Агентtask-systems-analysisсначала ищет задачи в базе знаний и вызываетcode-researchтолько если тот установлен и код-сервер отвечает.ai_chat_agentsостаётся для кастомных ассистентов администратора.
Безопасность
Код, прочитанный тулами, попадает в историю чата и к провайдеру модели. Выбирайте read-only серверы, ограничивайте корень поиска проектом и не подключайте серверы, которые отдают .env и ключи: deny-листов на стороне платформы нет — ответственность за содержимое выдачи на подключаемом сервере.