Внешние MCP-серверы
Сверено с выпуском 0.36.0, 14.11.2026.
MCP (Model Context Protocol) — открытый протокол, по которому агенту дают дополнительные инструменты: граф кода, поиск по документации, доступ к трекеру, базе, чему угодно. Pulse подключает MCP-серверы один раз, а дальше они доступны всем выбранным агентам во всех задачах.
Подключения живут в Hub → вкладка «Подключения» (пункт Hub в левой колонке, ⌘ 5; до 0.36 — раздел «Плагины»).
Skills, роли и блоки интерфейса — на соседней вкладке «Библиотека» (Библиотека). На вкладке
«Подключения» две группы: «Pulse для внешних агентов» (Pulse как MCP-сервер для CLI-агентов, см.
Команды среды) и «MCP-серверы» — ваши подключения.
Добавить сервер
| Поле | Что писать |
|---|---|
| Имя | как сервер будет подписан в подсказке агенту и в карточках вызовов |
| Транспорт | stdio (команда запускается локально) или http (адрес сервера) |
| Команда / аргументы | для stdio: чем запускать. {worktree} в аргументах подставляется путём worktree задачи. Переменные окружения из формы для stdio не передаются: сервер с ними не запустится, поле помечено «для stdio не применяется» |
| Для каких агентов | пусто — для всех; иначе список (например, только Claude Code) |
| Подсказка | текст, который уйдёт агенту первым ходом: когда и зачем пользоваться этим сервером |
Кнопки сверху: «Пресет: Память кода», «Добавить MCP» и «Перенести из Cursor / VS Code».
Новое подключение встаёт выключенным — включаете его вы, после проверки. Кнопка «Проверить» запускает сервер, делает рукопожатие и показывает список инструментов — сразу видно, что команда верная и сервер жив. Перед запуском локальной команды Pulse спрашивает системным подтверждением и показывает аргументы целиком.
Состояние подключения видно плашкой у каждого сервера: «Отключён», «Не настроен» (тоном предупреждения), «Проверяется», «Проверка прошла», «Ошибка подключения» (красным), «Не проверялся». Итог последней проверки переживает перезапуск Pulse: плашка пишет «Проверен» с датой и список инструментов, а у неудачной — дату и причину. Число MCP-серверов в Hub и в нижней строке окна одно и то же.
Отпечаток инструментов. При первом подключении Pulse запоминает названия, описания и
схемы инструментов сервера. Описание инструмента читает модель — это указание ей, поэтому
если сервер потом сменил описания или набор, подключение выключается с кодом
PULSE-AGENT-010 и разницей словами, до того как новые описания попадут агенту.
Выключили или изменили подключение — встроенный агент больше не вызывает его инструменты, а идущие сессии CLI-агентов, которым сервер был доступен, останавливаются.
Перенести из Cursor, VS Code и Windsurf
Hub → Подключения → «Перенести из Cursor / VS Code» (или ссылка на последнем шаге мастера первого запуска). Pulse показывает, что нашёл, с галочками, и ничего не переносит до нажатия «Перенести». Итог — «Перенесено N» и список того, что не перенеслось, с причиной.
Где ищет — пути из документации редакторов; на живых компьютерах каждой системы они ещё не проверены:
| Редактор | Файл |
|---|---|
| Cursor | ~/.cursor/mcp.json; в репозитории — .cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | mcp.json и ключ "mcp" в settings.json в папке профиля: ~/Library/Application Support/Code/User (macOS), %APPDATA%\Code\User (Windows), ~/.config/Code/User (Linux), то же для Insiders; в репозитории — .vscode/mcp.json |
Что и как переносится:
- Серверы встают выключенными — как любой новый: включите после «Проверить».
- Ключи (переменные с именами вроде
*_TOKEN,*_API_KEYи значения, похожие на ключи) показываются маской и без галочки «перенести и ключи» остаются в редакторе — впишите их сами в «Изменить». Ключ, записанный прямо в команде или адресе, отделить нельзя: такой сервер переносится только вместе с ним. В Pulse переменные MCP хранятся в настройках так же открыто, как в конфиге редактора. - Не переносится: серверы по SSE; заголовки HTTP-серверов (если в них авторизация,
сервер запрос не примет);
envFile; подстановки${input:…}и${env:…}— значение впишите сами.${workspaceFolder}становится{worktree}. - Правила проекта —
.cursor/rules/*.mdc,.cursorrules,.windsurf/rules/*.md,.windsurfrules,.github/copilot-instructions.mdв подключённых репозиториях — собираются вAGENTS.mdв корне репозитория: сначала правила «всегда», потом по файлам, у каждого — когда оно действует и откуда взято. ЕслиAGENTS.mdуже есть, он не перезаписывается. Исходные файлы остаются на месте.
Как это видит агент
- Внешние агенты по ACP получают MCP-серверы в параметрах новой сессии — они подключаются к ним сами, как если бы вы прописали сервер в их конфиге.
- Встроенный агент Pulse подключает stdio-серверы сам и отдаёт их инструменты модели как
функции с именами
mcp__<сервер>__<инструмент>. Каждый вызов проходит через разрешения сессии — клетка «MCP-инструменты» в матрице доверия (см. Агенты и модели). Вызовы видны в транскрипте и на графе обычными карточками, вывод обрезается до разумного размера. - Подсказки серверов собираются в блок «Подключённые MCP-серверы» и уходят первым ходом — чтобы модель знала, что у неё есть, и не изобретала своё.
Если сервер не поднялся, в транскрипт придёт ошибка, а сессия продолжит работу без него.
Память кода
Готовый пресет — codebase-memory-mcp: граф кода на tree-sitter, поиск символов, трассировка вызовов, оценка влияния правок.
- Установите сервер (инструкция в его репозитории; программа обычно оказывается в
~/.local/bin). - В Pulse: Hub → Подключения → «Пресет: Память кода». Одной кнопкой пресет сервер пока не
ставит: установка из окна включится, когда Pulse будет сверять архив закреплённой версии.
Аргумент
--repo {worktree}подставит worktree задачи. Включите подключение после «Проверить». - Подсказка по умолчанию говорит агентам: «сначала спроси граф кода, потом читай файлы» — это заметно экономит контекст на больших репозиториях.
Индексация при создании задачи
Пока граф не построен, спрашивать нечего: первый агент задачи разбирал репозиторий прямо внутри своего первого хода, и подсказка «сначала спроси граф кода» оборачивалась не быстрым ответом, а паузой на несколько минут. Поэтому Pulse строит граф сам.
Как только у задачи появилась worktree, приложение поднимает сервер памяти кода
отдельным процессом, зовёт index_repository на этот worktree и гасит процесс: держать его
до первого хода незачем — агенты поднимают свои экземпляры сами, а граф остаётся в базе
сервера. Создание задачи это не задерживает, работа идёт фоном.
Видно это в ленте активности задачи (Дашборд → Активность), строкой на каждое известное состояние:
| Состояние | Что написано |
|---|---|
| идёт разбор | «Память кода: индексируется worktree, проект «…»» |
| сервер ответил, что готово | «индекс построен, проект «…» — агенты могут спрашивать граф» |
| программы сервера нет | «сервер не установлен, индексации не будет» с причиной от запуска |
| сервер есть, инструмента нет | «у сервера нет инструмента index_repository» и список того, что он отдал |
| разбор сорвался | «ошибка индексации» и первая строка ответа сервера |
Готовым индекс называется только после ответа сервера — «идёт» и «готово» не одно и то же.
Имя проекта Pulse собирает как pulse-<репозиторий>-<id задачи> (у каждой задачи своя
ветка и своя worktree, общий граф на всех был бы графом чужого кода), но если сервер
назвал проект по-своему, в ленте стоит его имя, а не наше пожелание.
Worktree участников роя
У роя каждый разработчик работает в своём worktree на своей ветке, и каждый такой worktree
индексируется отдельно — под своим именем проекта pulse-<репозиторий>-<id задачи>-<роль>:
одно имя на все означало бы граф чужой ветки под своим названием. Участник без своего
worktree работает в worktree задачи и отдельной целью не становится — один каталог не
разбирается дважды. Индексация запускается после того, как рой развёл участников по своим
worktree.
Цена известна заранее: worktree несколько, репозиторий один и тот же, и он читается заново под каждый. Очередь пускает не больше двух разом, так что рой из четырёх разработчиков строит свои графы дольше, чем одна задача, — фоном, а в ленте видно, кто ждёт очереди.
Пресет не подключён, выключен или без команды запуска — Pulse молчит: ничего не обещали, индексировать нечем. У задачи-черновика без репозитория индексировать тоже нечего. Разбор большого репозитория идёт минутами, поэтому у него свой предел терпения — 20 минут вместо обычного минутного таймаута MCP.
Чего индексация не делает
- Не переиндексирует по изменениям. Граф снимается один раз, при создании задачи. Пока агент правит код, граф устаревает, и Pulse об этом не узнает: сигнала «репозиторий изменился» у него нет. На долгой задаче агент может спрашивать вчерашнюю картину.
- Не строит worktree роя общего графа. Каждый разбирается отдельно: способа снять граф один раз и переиспользовать его между ветками у сервера нет.
- Не индексирует worktree авторов команды и созданные позже. Разбираются worktree задачи и worktree участников роя; свои worktree авторов команды профилей и worktree, сделанные сессии после создания задачи, в этот разбор не попадают.
- Не индексирует задачу, пришедшую посылкой. Она заводится другим путём, мимо создания задачи в окне.
- Не убирает за собой. Удаление задачи сносит worktree, но проект из базы памяти кода не удаляет: база принадлежит серверу, а не Pulse. Чистить её нужно средствами самого сервера.
Советы
- Держите включёнными только те серверы, которые действительно нужны: каждый добавляет инструменты в контекст модели.
- Для маленьких моделей лишние инструменты вредны — они начинают путаться. Проверьте поведение кнопкой «Проверить» у локальной модели.
- Секреты в аргументы не кладите: аргументы показываются целиком в системном подтверждении и видны в карточках вызовов. Переменные окружения для stdio Pulse сейчас не передаёт — ключ, нужный серверу, задайте в его собственном конфиге.