Добавление MCP-серверов
На этой странице объясняется, как добавлять и настраивать MCP-серверы в Elftia. Elftia поддерживает три типа транспорта, и шаги настройки для каждого из них немного отличаются.
Откройте страницу управления MCP
- Нажмите страницу MCP Servers на левой панели навигации
- Нажмите кнопку Add в правом верхнем углу
- В появившейся форме выберите режим Form Input
Вы также можете добавлять серверы пакетно с помощью режима JSON Import. См. Пакетный импорт JSON.
Добавление Stdio-сервера
Stdio — самый распространенный тип транспорта, используемый для MCP-серверов, запускаемых через локальную командную строку (например, пакеты npm или pip).
Шаги настройки
- Имя сервера — Введите легко узнаваемое имя (например,
filesystem) - Тип транспорта — Выберите
Stdio - Команда — Введите команду для запуска сервера (например,
npx) - Аргументы — По одному аргументу на строку:
-y@modelcontextprotocol/server-filesystem/path/to/allowed/directory
- Переменные окружения (необязательно) — По одной на строку в формате
KEY=VALUE:API_KEY=your-api-keyDEBUG=true - Нажмите Save
Описания полей конфигурации
| Поле | Обязательно | Описание |
|---|---|---|
| Имя сервера | Да | Уникальный идентификатор; не должен совпадать с именем уже существующего сервера |
| Команда | Да | Исполняемая команда, например npx, uvx, node, python |
| Аргументы | Нет | Список аргументов, передаваемых команде, по одному на строку |
| Переменные окружения | Нет | Дополнительные переменные окружения для дочернего процесса; наследует текущее системное окружение |
Примеры распространенных Stdio-серверов
Filesystem server:
| Поле | Значение |
|---|---|
| Команда | npx |
| Аргументы | -y , @modelcontextprotocol/server-filesystem , /Users/yourname/Documents |
Brave Search server:
| Поле | Значение |
|---|---|
| Команда | npx |
| Аргументы | -y , @modelcontextprotocol/server-brave-search@latest |
| Переменные окружения | BRAVE_API_KEY=your-brave-api-key |
Tavily Search server:
| Поле | Значение |
|---|---|
| Команда | npx |
| Аргументы | -y , tavily-mcp@latest |
| Переменные окружения | TAVILY_API_KEY=your-tavily-api-key |
Добавление SSE-сервера
SSE (Server-Sent Events) используется для удаленно размещенных MCP-серверов, которые обмениваются данными через долгоживущее HTTP-соединение.
Шаги настройки
- Имя сервера — Введите имя (например,
web-search) - Тип транспорта — Выберите
SSE - URL — Введите адрес SSE endpoint сервера
- Заголовки запроса (необязательно) — По одному на строку в формате
Key=Value:Authorization=Bearer your-tokenX-API-Key=your-api-key - Переменные окружения (необязательно) — Так же, как для Stdio
- Нажмите Save
Описания полей конфигурации
| Поле | Обязательно | Описание |
|---|---|---|
| Имя сервера | Да | Уникальный идентификатор |
| URL | Да | URL SSE endpoint MCP-сервера |
| Заголовки запроса | Нет | Заголовки HTTP-запроса, используемые для аутентификации и т. д. |
| Переменные окружения | Нет | Дополнительные переменные окружения |
Пример SSE-сервера
Zhipu Web Search:
| Поле | Значение |
|---|---|
| URL | https://api.z.ai/api/mcp/web_search_prime/mcp |
| Заголовки запроса | Authorization=Bearer your-zhipu-api-key |
Добавление HTTP-сервера
Транспорт HTTP (Streamable HTTP) основан на спецификации MCP 2025-03-26 и является более новым вариантом транспорта.
Шаги настройки
- Имя сервера — Введите имя
- Тип транспорта — Выберите
HTTP - URL — Введите адрес HTTP endpoint сервера
- Заголовки запроса (необязательно) — Так же, как для SSE
- Нажмите Save
Описания полей конфигурации
То же, что и для SSE; отличается только используемый транспортный протокол.
| Поле | Обязательно | Описание |
|---|---|---|
| Имя сервера | Да | Уникальный идентификатор |
| URL | Да | URL HTTP endpoint MCP-сервера |
| Заголовки запроса | Нет | Заголовки HTTP-запроса |
| Переменные окружения | Нет | Дополнительные переменные окружения |
Пример HTTP-сервера
Zhipu Web Reader:
| Поле | Значение |
|---|---|
| URL | https://api.z.ai/api/mcp/web_reader/mcp |
| Заголовки запроса | Authorization=Bearer your-zhipu-api-key |
Проверка зависимостей
При добавлении Stdio-сервера Elftia автоматически проверяет, установлены ли необходимые CLI-инструменты:
| Команда | Что проверяется | Способ автоустановки |
|---|---|---|
npx / npm / node | Среда выполнения Node.js | Windows: winget; macOS: Homebrew; другие: предлагает ручную установку |
uv / uvx | Менеджер Python-пакетов uv | Автоматически устанавливается через официальный install script |
Если обнаружена отсутствующая зависимость, Elftia показывает prompt с предложением автоматической установки или ссылкой на страницу ручной загрузки.
Поведение проверки зависимостей
- Сначала ищет команду в системном PATH
- Если команда не найдена, автоматически сканирует распространенные директории установки (
~/.local/bin,~/.cargo/bin, глобальная директория npm и т. д.) - После установки автоматически проверяет доступность
- Для зависимостей, которые нельзя установить автоматически, предоставляет ссылку на страницу загрузки
Тестирование подключения
После добавления сервера рекомендуется сразу протестировать подключение:
- Найдите целевой сервер в списке MCP-серверов
- Нажмите кнопку Test
- Дождитесь завершения подключения и обнаружения инструментов
- При успехе отображается сообщение
Connected successfully. Found N tools.вместе со списком имен инструментов
Использование официальных пресетов
Elftia включает предустановленные конфигурации для некоторых распространенных MCP-серверов с поддержкой установки в один клик:
- Переключитесь на вкладку Official на странице MCP Servers
- Просмотрите доступные пресеты (фильтр по категориям: поиск, vision, чтение web, репозиторий кода и т. д.)
- Нажмите кнопку Install
- Если требуется API-ключ, система попытается автоматически связать его с уже настроенным LLM-провайдером; если ключ не найден, нужно ввести его вручную
Текущие поддерживаемые официальные пресеты:
| Пресет | Категория | Транспорт | Требуется API-ключ |
|---|---|---|---|
| MiniMax Coding Plan MCP | General | Stdio | Да |
| Zhipu Vision MCP | Vision | Stdio | Да |
| Zhipu Web Search | Search | HTTP | Да |
| Zhipu Web Reader | Web reading | HTTP | Да |
| Zhipu Zread | Code repository | HTTP | Да |
| Tavily Search | Search | Stdio | Да |
| Brave Search | Search | Stdio | Да |
Устранение неполадок
Команда не найдена
Симптом: При добавлении Stdio-сервера появляется сообщение, что команда не существует.
Решение:
- Убедитесь, что соответствующая среда выполнения установлена (Node.js, Python и т. д.)
- Попробуйте вручную запустить команду в терминале для проверки
- Перезапустите Elftia, чтобы обновить переменную окружения PATH
- Используйте полный путь вместо имени команды (например,
/usr/local/bin/npx)
Тайм-аут подключения
Симптом: При тестировании подключения долго нет ответа.
Решение:
- Проверьте сетевое соединение (для SSE/HTTP-серверов)
- Убедитесь, что URL правильный, особенно порт и путь
- Проверьте, не блокирует ли подключение файрвол или прокси
- Для Stdio-серверов убедитесь, что команда может нормально запускаться
Ошибка аутентификации
Симптом: Подключение успешно, но вызовы инструментов завершаются ошибками, связанными с аутентификацией.
Решение:
- Проверьте, что API-ключ правильно задан в переменных окружения
- Для SSE/HTTP-серверов убедитесь, что информация аутентификации в заголовках запроса имеет правильный формат
- Обратите внимание на формат Bearer-токена:
Authorization=Bearer your-token
Инструменты не отображаются
Симптом: Сервер успешно подключен, но инструменты не появляются в разговоре.
Решение:
- Убедитесь, что сервер находится во включенном состоянии (
isActiveis true) - Проверьте, не установлен ли режим MCP в
disabled - В ручном режиме убедитесь, что сервер выбран
- Попробуйте использовать кнопку Discover, чтобы вручную обновить список инструментов
- Кэш инструментов истекает каждые 5 минут — дождитесь обновления кэша или переподключитесь
Следующие шаги
- Пакетный импорт JSON — Быстро импортировать несколько серверов через JSON
- Использование MCP-инструментов — Узнайте, как инструменты используются во время разговора