Подключение к удалённому серверу

Удалённые MCP серверы — это процессы, запущенные где-то в сети: на облачном хосте, на вашем собственном сервере или в стороннем сервисе. Kodik подключается к ним по HTTP с использованием транспорта SSE или streamable HTTP. Локальная установка не нужна.

Добавление удалённого сервера через UI

Самый быстрый способ — через вкладку Удалённые Серверы:

Нажмите MCP Серверы в панели инструментов Kodik.
Откройте вкладку Удалённые Серверы.
Заполните:
- Имя сервера — уникальное имя на ваш выбор (используется как ключ в mcp.json и как префикс в именах инструментов: mcp__<имя>__<инструмент>)
- URL сервера — полный URL эндпоинта (например, https://api.example.com/mcp)
Нажмите Добавить Сервер.

Kodik вызывает addRemoteMcpServer, который записывает запись в mcp.json и немедленно пытается установить соединение. Сервер появится во вкладке Установленные с индикатором статуса.

Подключайтесь только к серверам, которым вы доверяете. Удалённые MCP серверы обрабатывают ваши запросы и могут иметь доступ к любым данным, которыми вы с ними делитесь.

Тип транспорта

Kodik определяет транспорт из поля type в конфигурации (или путём вывода):

type: "http" (или "streamableHttp") — Streamable HTTP транспорт. Это рекомендуемый современный транспорт для новых серверов.
type: "sse" — Server-Sent Events транспорт. Используйте для старых серверов, использующих диалект SSE.

При добавлении через UI Kodik по умолчанию использует streamable HTTP. Если сервер требует SSE, отредактируйте mcp.json напрямую и установите type: "sse".

Управление подключённым сервером

После добавления найдите сервер во вкладке Установленные:

Индикаторы статуса

Цвет	Значение
Зелёный	Подключён и готов
Жёлтый	Подключается
Красный	Отключён или ошибка (наведите курсор для деталей)

Включение/отключение

Переключите тумблер рядом с сервером. При отключении сервер остаётся в mcp.json, но Kodik к нему не подключается.

Авто-одобрение инструментов

Разверните панель настроек сервера, чтобы увидеть все предоставляемые инструменты. Вы можете переключить авто-одобрение для каждого инструмента отдельно, или установить для всего сервера режим авто-одобрения через defaultToolsApprovalMode: "auto-approve" в mcp.json. См. Авто-одобрение.

Тайм-аут

Используйте выпадающий список Тайм-аут запроса в панели настроек сервера (от 30 секунд до 1 часа). По умолчанию 60 секунд.

Перезапуск / удаление

Перезапустить Сервер — переподключается без удаления конфигурации. Используйте, если сервер перестал отвечать.
Удалить Сервер — удаляет запись из mcp.json.

Расширенная конфигурация в mcp.json

Удалённые серверы поддерживают дополнительные поля помимо имени и URL. Откройте mcp.json через MCP Серверы → Установленные → Настроить MCP Серверы:

{
  "servers": {
    "my-remote": {
      "type": "http",
      "url": "https://api.example.com/mcp",
      "headers": {
        "X-Tenant-Id": "my-org",
      },
      "timeout": 120,
      "autoApprove": ["search", "read_doc"],
      "defaultToolsApprovalMode": "always-ask",
      "disabled": false,
    },
  },
}

Полный справочник полей, включая enabledTools, disabledTools и auth, см. в Настройка MCP Серверов.

OAuth 2.1 аутентификация

Многие размещённые MCP серверы требуют OAuth. Когда Kodik получает ответ 401, он автоматически запускает OAuth 2.1 поток — вы увидите запрос в браузере на вход в систему. Затем Kodik кэширует токен и прикрепляет его как заголовок Bearer ко всем последующим запросам.

Если сервер не публикует метаданные обнаружения .well-known, вы можете указать детали вручную в блоке auth:

{
  "servers": {
    "protected-api": {
      "type": "http",
      "url": "https://api.example.com/mcp",
      "auth": {
        "clientId": "my-client-id",
        "scopes": ["mcp:tools"],
        "authorizationServer": "https://auth.example.com",
      },
    },
  },
}

Чтобы полностью пропустить OAuth для сервера, установите "auth": { "disabled": true }.

Устранение неполадок

Симптом	Что проверить
Красная точка сразу после добавления	Убедитесь, что URL доступен и сервер запущен
`401 Unauthorized`	Повторно запустите OAuth поток, перезапустив сервер, или проверьте поля `auth`
Инструменты не появляются	Сервер подключился, но не предоставил инструменты; проверьте логи сервера
Медленные ответы	Увеличьте `timeout`; стандартных 60 с может не хватить для тяжёлых операций