# Навыки и MCP

> Навыки со skills.sh и инструменты любого MCP-сервера — ставятся один раз и выдаются конкретным агентам стрелкой.

Source: https://docs.neurosquad.ai/ru/skills-mcp

Два вида дополнений делают агента сильнее в конкретной работе, и NeuroSquad ставит оба сам:

  - **MCP-сервер**: Небольшая программа или веб-сервис, который даёт агенту **новые инструменты**: прочитать файл Figma, открыть задачи GitHub, сделать запрос к базе, получить свежую документацию библиотеки. Говорит на Model Context Protocol — стандарте, который понимают все крупные агенты.
  - **Навык**: Папка с **экспертными инструкциями** (`SKILL.md`, иногда со скриптами и справочными файлами), которая объясняет агенту, как хорошо делать определённую работу: продумать идею до реализации, сделать выразительный интерфейс, составить нормальный план тестирования.

## Как это устроено

**1. Найдите в каталоге**

**Skills & MCP** ищет по официальному **MCP Registry** (около 35 000 серверов) и **skills.sh**
(20 000 самых популярных навыков, с числом установок и проверками безопасности) — по мере ввода.
См. [Каталог и установка](https://docs.neurosquad.ai/ru/skills-mcp/catalog).

**2. Установите один раз**

До любой загрузки видно, что именно будет запущено, — и вы подтверждаете. Всё ставится в
собственную папку NeuroSquad: ничего глобально, ваши настройки агентов не трогаются.

**3. Положите карточку на холст и протяните стрелку**

Карточка **MCP server** или **Skill** — это один установленный элемент. Протяните стрелку от неё
к агенту — и у агента он есть. См. [Как выдать агентам](https://docs.neurosquad.ai/ru/skills-mcp/cards).

> **Видят только подключённые агенты.** Агент без стрелки к карточке MCP или навыка не видит ничего
> из установленного — даже того, что оно есть. Пять агентов могут делить один сервер, а могут
> получить каждый свой.

## Какие агенты это умеют

| Агент | Навыки и MCP-серверы | После того как нарисована стрелка |
| --- | --- | --- |
| **Claude Code** | Да | Сразу, без перезапуска |
| **Hermes Agent** | Да | Сразу, без перезапуска |
| **Kilo Code** | Да | Сразу, без перезапуска |
| **GitHub Copilot CLI** | Да | Сразу, без перезапуска |
| **Pi** | Да | Сразу, без перезапуска |
| **omp** | Да | Сразу, без перезапуска |
| **aider** | Да | Сразу, без перезапуска |
| **Factory Droid** | Да | Сразу, без перезапуска |
| **Amp** | Да | Сразу, без перезапуска |
| **Auggie** | Да | Сразу, без перезапуска |
| **Goose** | Да | Сразу, без перезапуска |
| **MiMo Code** | Да | Сразу, без перезапуска |
| **Codex CLI** | Да | При следующем запуске агента |
| **Qwen Code** | Да | При следующем запуске агента |
| **Antigravity CLI** | Да | Сразу |
| **Kimi Code** | Да | При следующем запуске агента |
| **ZCode** | Да | При следующем запуске агента |
| **PenguinHarness** | Да | При следующем запуске агента |
| **Cline CLI** | Да | При следующем запуске агента |
| Остальные агенты | Нет | — |

То же самое карточка пишет рядом с каждым подключённым агентом: **Сразу**, **После перезапуска**
или **Недоступно**. Последнее значит, что NeuroSquad вообще не выдаёт этому агенту инструменты — это
те же агенты, которым [стрелки](https://docs.neurosquad.ai/ru/canvas/arrows) не дают возможностей.

## Откуда агент знает, что у него есть

Ничего объяснять агенту не нужно.

- **Навыки:** инструмент агента `skill_load` перечисляет все подключённые навыки со строкой «когда
использовать», поэтому агент сам загружает подходящий навык перед задачей — так же, как работают
собственные навыки Claude Code.
- **MCP-серверы:** инструменты каждого сервера появляются под его именем, например
`framelink__get_figma_data`; в описании каждого указан сервер, плюс собственные подсказки сервера.
- **`neurosquad_connections`** — инструмент, которым агент смотрит, что на другом конце его стрелок, —
тоже перечисляет подключённые серверы и навыки.

## Агенты подключают себе нужное сами

Агенту не нужно ждать, пока вы что-то подключите. Он знает, что есть в NeuroSquad, и может
подключить это к **своей карточке**, когда этого требует задача:

- **Он знает список.** На первом ходу сессии агент получает короткую справку — [плагины](https://docs.neurosquad.ai/ru/plugins),
которые работают для него, и установленные вами навыки и MCP-серверы, по строке на каждый (не
больше ~300 токенов). Подробности даёт инструмент `neurosquad_catalog`: для чего каждый, какие
инструменты даёт, что уходит в сеть и что нужно настроить, подключён ли он уже.
- **Он подключает нужное.** `neurosquad_equip` ставит карточку рядом с агентом (или берёт ту, что
уже есть на холсте) и проводит стрелку — инструменты появляются сразу. Вы видите уведомление,
например «Claude Code подключил Context7», с кнопкой **Отменить**.
- **Новая установка всегда спрашивает вас.** Навык или MCP-сервер, которого ещё нет, ставится только
после кнопки **Установить и подключить** в диалоге, где видно, что именно будет установлено: пакет
и версия, источник, команды, закреплённый хэш. Само ничего не ставится — и в опасном режиме тоже.
Сервер, которому нужен ключ или адрес, открывается в каталоге, чтобы вы его настроили. Плагины,
которые что-то скачивают (RTK, Code Graph, Graphify), по-прежнему ждут, пока вы запустите загрузку
на их карточке.
- **Опасный режим: MCP-серверы разрешаете вы.** Агент в опасном режиме запускал бы инструменты
MCP-сервера без вашего подтверждения каждого вызова, поэтому сам такой сервер не подключит. Вместо
этого появится диалог: какой агент, какой сервер, какие инструменты он получит и как сервер
запускается. **Разрешить** подключает его (как если бы стрелку провели вы), **Отказать** запоминается
до перезапуска приложения. Если сервер ещё и не установлен — это один диалог: **Установить и разрешить**.
- **Обычные правила действуют.** Каждый вызов инструментов MCP-сервера подтверждается как обычно;
агент не может забрать себе терминал, браузер или MCP-карточку, которые настроили вы; RTK не
работает в воркспейсах WSL/SSH, Graphify — по SSH.
- **CLI, которые читают инструменты один раз.** Codex, Kimi Code, ZCode, PenguinHarness, Cursor и Crush читают список
инструментов при запуске: инструменты плагинов и навыков у них есть с самого начала и работают,
как только появилась стрелка, а инструменты только что подключённого **MCP-сервера** появятся
после перезапуска карточки (разговор продолжится).

Чтобы выключить, снимите **Агенты могут подключать себе плагины, навыки и MCP** в диалоге
редактирования воркспейса. Тогда подключаете только вы.

## Что стоит знать

- **Каждый вызов установленного сервера вы подтверждаете.** Его инструменты идут через отдельный
сервер (`ns-connected`), который NeuroSquad не разрешает заранее, поэтому Claude Code, Codex и
Qwen спрашивают перед каждым вызовом — если только вы сами не включили агенту режим, где всё
разрешено. Hermes Agent сам никогда не спрашивает, поэтому за него спрашивает NeuroSquad:
**Разрешить один раз**, **Разрешить до перезапуска** или **Запретить** (без ответа за пять минут —
отказ). Если сервер позже меняет свои инструменты, на карточке появляется блок с изменениями:
пока вы их не примете, агенты новых и изменённых инструментов не видят.
- **Это сторонний код.** Установленный сервер работает на вашем компьютере (или это сервис в
интернете); текст навыка попадает прямо в инструкции агента. Ставьте то, чему доверяете, — каталог
показывает источник, точные команды и, для навыков, проверки безопасности.
- **Пока ставится не всё.** Серверы, опубликованные только как MCPB, NuGet- или Cargo-пакеты, и
пакеты, поднимающие локальный веб-сервер, видны, но не устанавливаются.
- **Некоторые входы пускают только одобренные приложения.** Например, официальный удалённый сервер
Figma отказывает во входе приложениям, которых он не одобрил. Берите сервер с личным токеном —
**Framelink Figma MCP** (`FIGMA_API_KEY`) работает с вашим токеном Figma.