MCP и навыки

MCP (Model Context Protocol) — открытый протокол, по которому агент подключается к внешним программам-инструментам — MCP-серверам. Навык — папка с инструкциями и материалами для определённого вида задач. Серверы и навыки настраиваются в разделе Настройки → MCP и навыки; поля формы описаны в разделе «Настройки».

Подключить MCP-сервер

Используйте MCP-серверы, утверждённые в вашей организации; программа сервера должна быть установлена заранее. Сервер добавляет агенту инструменты.

Нажмите + Добавить сервер, введите Имя сервера и нажмите Далее. Затем выберите способ подключения:

• Команда — сервер запускается на вашем компьютере. Поле Команда запуска заполняется так же, как команда в терминале: <программа сервера> <аргументы>. Допустимы кавычки и ~ вместо домашней папки. Под полем видно, что станет программой, а что — аргументами.
• Адрес — сервер работает по сети; в поле Адрес сервера введите его адрес, начинающийся с http:// или https://.

Нажмите Добавить. Строка сервера покажет итог запуска: число инструментов, нужен вход или причину ошибки, например не запустился: программа не найдена. Подробности ошибки показаны второй строкой.

Новый сервер доступен агенту со следующего запроса — и в новых, и в уже открытых сессиях. Когда агент вызывает инструмент сервера, в ленте появляется серия вызовов. Если вызов требует подтверждения, появится карточка Запрос на вызов инструмента: проверьте аргументы и нажмите Разрешить или Отклонить.

Переменные окружения сервера

Переменные окружения форма не принимает. Задайте их в файле настроек ядра config.toml, в таблице env этого сервера:

[mcp_servers.docs]
command = "docs-server"
args = ["--read-only"]

[mcp_servers.docs.env]
DOCS_TOKEN = "значение"

Здесь docs — имя сервера из формы, docs-server и --read-only — программа и аргументы из поля Команда запуска, DOCS_TOKEN — переменная, которую ожидает сервер. Путь к config.toml показан в разделе Настройки → Ядро и диагностика (строка .astracode).

После правки файла нажмите Обновить в блоке Серверы MCP. Если потом изменить сервер кнопкой Изменить, приложение сохранит его таблицу env.

Вход и удаление

Если у сервера стоит метка нужен вход, нажмите Войти и завершите вход в браузере — список обновится сам.

Кнопка Изменить открывает форму сервера. Кнопка Удалить… после подтверждения убирает сервер из настроек ядра; программа сервера остаётся установленной. Удаление сервера не отменяет действий, которые он уже выполнил во внешних системах.

Пример: навык проверки README

Устанавливайте навыки только из доверенных источников: навык добавляет агенту инструкции.

Создайте папку docs-check с файлом SKILL.md:

---
name: docs-check
description: Проверка README по текущим файлам проекта.
---

# Проверка документации

Прочитай README и файлы с командами запуска и проверок.
Найди несовпадения и предложи конкретные исправления.
Указывай путь к файлу, на котором основан вывод.
Не меняй файлы, пока пользователь не попросит применить правки.

1. Откройте проект, затем раздел Настройки → MCP и навыки, блок Установка навыка.
2. Выберите Из папки и укажите папку docs-check.
3. В поле Куда установить выберите Только в текущий проект или Только для текущего пользователя.
4. Нажмите Установить, затем Обновить и убедитесь, что у навыка отмечен флажок Включен.
5. Начните новую сессию и отправьте $docs-check Проверь README этого проекта и перечисли неточности.

Ожидаемый результат — список неточностей с путями и предложениями. Навык задаёт только инструкции; какие файлы агенту разрешено изменять, определяет режим сессии (см. раздел «Права и подтверждения»).

Установка копирует папку целиком, поэтому последующие изменения исходной папки на установленный навык не влияют. Навык проекта копируется в папку <проект>/.astracode/skills и доступен только в этом проекте; навык пользователя копируется в папку skills каталога ядра и доступен во всех проектах. Без открытого проекта доступна только установка для пользователя.

Навык недоступен

Кнопка Удалить удаляет папку навыка с диска — и у навыка проекта, и у навыка пользователя. Путь к папке показан в окне подтверждения. Чтобы сохранить файлы, вместо удаления снимите флажок Включен.