MCP-подключения
Memoh полностью поддерживает Model Context Protocol (MCP) и позволяет подключать Bot к внешним сервисам инструментов и поставщикам контекста.
Идея: расширение возможностей Bot
MCP даёт стандартизированный способ открыть Bot доступ к внешним источникам данных и инструментам. У каждого Bot может быть собственный независимый набор MCP-подключений.
Подключения можно настраивать вручную на вкладке MCP или начать с готового шаблона в Supermarket, а затем просмотреть предзаполненный черновик в редакторе Bot.
Типы подключений
MCP-подключения настраиваются на вкладке MCP страницы Bot.
1. Stdio (локальный процесс)
Подключение этого типа выполняет локальную команду внутри контейнера Bot и общается через стандартный ввод/вывод.
| Поле | Описание |
|---|---|
| Command | Исполняемый файл (например, npx, python3). |
| Arguments | Список аргументов командной строки (например, -y, @modelcontextprotocol/server-filesystem, /opt/memoh/data). |
| Env | Пары «ключ — значение» для переменных окружения. |
| CWD | Рабочий каталог процесса. |
2. Remote (HTTP/SSE)
Подключение этого типа соединяется с удалённым MCP-сервером по сети.
| Поле | Описание |
|---|---|
| URL | Конечная точка удалённого MCP-сервера. |
| Headers | Пользовательские HTTP-заголовки (например, для аутентификации). |
| Transport | Выбор между http и sse (Server-Sent Events). |
Аутентификация по OAuth
Некоторым MCP-серверам нужна аутентификация на основе OAuth. Memoh поддерживает полный MCP-поток OAuth:
- Нажмите кнопку OAuth на подключении, требующем аутентификации.
- Memoh автоматически обнаружит OAuth-конфигурацию сервера.
- Нажмите Authorize, чтобы открыть страницу авторизации поставщика.
- После выдачи доступа вы будете перенаправлены обратно в Memoh.
- Токен обменивается и безопасно сохраняется для этого подключения.
Также можно:
- Check status — посмотреть текущее состояние OAuth-токена.
- Revoke — удалить сохранённый OAuth-токен.
Операции
- Add Connection: нажмите Add, выберите тип и заполните конфигурацию.
- Import JSON: кнопка Import быстро добавляет несколько подключений из стандартного JSON-файла конфигурации
mcpServers. - Export: экспорт конфигураций подключений в JSON-файл для резервной копии или обмена.
- Toggle Active: включение и выключение отдельных подключений без удаления.
- Search: быстрый поиск подключения по имени или ID.
- Batch Delete: выбор нескольких подключений и удаление их разом.
Обнаружение инструментов
Как только MCP-подключение становится активным, Memoh автоматически обнаруживает инструменты, которые предоставляет сервер. Вы можете:
- Открыть подключение, чтобы посмотреть его детали.
- В разделе Tools увидеть все доступные инструменты с их именами и описаниями.
- Bot будет сам использовать эти инструменты в разговорах, когда это уместно.
Кнопкой Probe можно вручную обновить список инструментов с сервера.
Взаимодействие с Bot
Когда MCP-подключение активно, Bot автоматически:
- обнаруживает инструменты и ресурсы, предоставляемые MCP-сервером;
- использует эти инструменты для выполнения задач по запросу пользователя;
- включает контекст, полученный от MCP-сервера, в процесс рассуждения.