MCP-серверы
MCP (Model Context Protocol — протокол контекста модели) — открытый стандарт, позволяющий AI Agent взаимодействовать с внешними серверами инструментов. Через MCP вы можете подключить к Elftia в стандартизированном виде такие возможности, как доступ к файловой системе, веб-поиск, запросы к базам данных и просмотр репозиториев кода, позволяя Agent напрямую вызывать эти внешние инструменты в ходе диалога.
Зачем нужен MCP
Встроенные возможности Agent ограничены. С помощью MCP вы можете:
- Расширить набор инструментов — зарегистрировать возможности любого внешнего сервиса как инструменты, доступные Agent для вызова
- Стандартизировать интерфейс — инструменты из разных источников взаимодействуют по единому протоколу, устраняя необходимость писать отдельные адаптеры для каждого из них
- Подключать по требованию — включать только те серверы, которые нужны для текущей задачи, не перегружая список инструментов
- Переиспользовать между проектами — один и тот же набор конфигураций MCP-серверов можно использовать совместно в нескольких Agent
Три транспортных протокола
Elftia поддерживает три типа транспорта MCP. Выберите тот, который подходит для вашего случая:
| Тип транспорта | Способ подключения | Сценарий использования | Пример |
|---|---|---|---|
| Stdio | Запускает локальный дочерний процесс, взаимодействует через стандартный ввод/вывод | Локальные инструменты, CLI-обёртки, npm/pip-пакеты | npx @modelcontextprotocol/server-filesystem |
| SSE | Длительное соединение через HTTP Server-Sent Events | Удалённые сервисы, сценарии с необходимостью push-уведомлений в реальном времени | https://api.example.com/mcp/sse |
| HTTP | Запрос/ответ на основе Streamable HTTP | Удалённые MCP-сервисы в стиле REST | https://api.example.com/mcp |
:::tip Как выбрать
- Выбирайте Stdio в большинстве случаев — пакеты MCP-серверов, установленные через npm или pip, как правило, используют Stdio
- Выбирайте SSE или HTTP для сервисов с удалённым хостингом — например, облачных MCP-сервисов, предоставляемых сторонними провайдерами
- SSE против HTTP — SSE основан на более старой спецификации MCP; HTTP основан на спецификации MCP от 2025-03-26 (Streamable HTTP). Для новых сервисов предпочтительнее HTTP :::
Процесс обнаружения и использования инструментов
После настройки MCP-сервера Elftia автоматически выполняет следующие шаги:
MCP-сервер запускается / подключается
↓
Elftia автоматически обнаруживает список инструментов, предоставляемых сервером
↓
Инструменты регистрируются в доступном наборе инструментов Agent
↓
Agent вызывает инструменты по мере необходимости в ходе диалога
↓
Инструмент возвращает результат; Agent включает его в ответ
Формат именования инструментов: каждый MCP-инструмент регистрируется как mcp__<имя-сервера>__<имя-инструмента>. Например, инструмент read_file, предоставляемый сервером с именем filesystem, идентифицируется в Agent как mcp__filesystem__read_file.
MCP и Agent
MCP-серверы можно гибко использовать совместно с Agent:
- Автоматический режим (по умолчанию) — инструменты всех включённых MCP-серверов автоматически доступны всем Agent
- Ручной режим — перед каждым диалогом выбирайте, какие MCP-серверы использовать
- Привязка к Agent — связывайте конкретные MCP-серверы с конкретными Agent для создания выделенных конфигураций инструментов
Краткий обзор возможностей
| Возможность | Описание |
|---|---|
| Несколько транспортных протоколов | Варианты подключения: Stdio, SSE и HTTP |
| Автоматическое обнаружение инструментов | После подключения список инструментов загружается автоматически и кэшируется на 5 минут |
| Массовый JSON-импорт | Добавление нескольких серверов сразу через JSON-конфигурацию |
| Автоматическое определение зависимостей | Автоматическая проверка наличия node/npm/uv/uvx и других CLI-инструментов |
| Проверка подключения | Тестирование статуса подключения и доступных инструментов в один клик |
| Отключение инструментов | Выборочное отключение отдельных инструментов сервера |
| Управление доверием | Разграничение между доверенными и недоверенными серверами |
| Официальные пресеты | Встроенные конфигурации для установки популярных MCP-серверов в один клик |
Дальнейшие шаги
- Добавление MCP-серверов — пошаговое руководство по добавлению MCP-серверов каждого типа
- Массовый JSON-импорт — добавление нескольких серверов сразу через JSON-конфигурацию
- Использование MCP-инструментов — как инструменты применяются в ходе диалога