Внешние 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, поиск символов, трассировка вызовов, оценка влияния правок.

  1. Установите сервер (инструкция в его репозитории; программа обычно оказывается в ~/.local/bin).
  2. В Pulse: Hub → Подключения → «Пресет: Память кода». Одной кнопкой пресет сервер пока не ставит: установка из окна включится, когда Pulse будет сверять архив закреплённой версии. Аргумент --repo {worktree} подставит worktree задачи. Включите подключение после «Проверить».
  3. Подсказка по умолчанию говорит агентам: «сначала спроси граф кода, потом читай файлы» — это заметно экономит контекст на больших репозиториях.

Индексация при создании задачи

Пока граф не построен, спрашивать нечего: первый агент задачи разбирал репозиторий прямо внутри своего первого хода, и подсказка «сначала спроси граф кода» оборачивалась не быстрым ответом, а паузой на несколько минут. Поэтому 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 сейчас не передаёт — ключ, нужный серверу, задайте в его собственном конфиге.