MCP легко и просто

MCP серверы расширяют возможности Kodik дополнительными инструментами: получение веб-страниц, запросы к базам данных, автоматизация браузера и всё, что может сделать небольшая программа. На этой странице показаны самые быстрые способы запустить сервер.

Вариант 1: Установка из маркетплейса

Маркетплейс позволяет установить популярные предварительно настроенные серверы в несколько кликов.

1. Нажмите значок MCP Серверы в верхней панели инструментов панели Kodik.
2. Откройте вкладку Маркетплейс и просматривайте по категориям (Поиск, Файловые системы, Автоматизация браузера и т.д.).
3. Нажмите на сервер, чтобы узнать о его инструментах и требованиях.
4. Нажмите Установить. Если серверу нужен API ключ, Kodik запросит его и сохранит в безопасном месте.
5. Kodik добавит сервер в ваш mcp.json, запустит процесс, и новые инструменты станут доступны сразу.

Проверьте статусную точку сервера во вкладке Установленные: зелёная — значит подключён.

Вариант 2: Добавить удалённый сервер по URL

Для серверов, размещённых по URL (SSE или streamable HTTP):

1. Нажмите MCP Серверы → вкладка Удалённые Серверы.
2. Введите Имя сервера и URL сервера (например, https://example.com/mcp).
3. Нажмите Добавить Сервер. Kodik подключится и отобразит инструменты сервера.

Подробнее об OAuth и авто-одобрении инструментов см. Удалённый Сервер.

Вариант 3: Быстрая ручная настройка

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

Минимальная конфигурация stdio сервера (локальный процесс):

{
  "servers": {
    "my-tool": {
      "command": "npx",
      "args": ["-y", "@scope/my-mcp-server"],
      "env": {
        "API_KEY": "sk-...",
      },
    },
  },
}

Минимальная конфигурация удалённого сервера (streamable HTTP):

{
  "servers": {
    "my-remote": {
      "type": "http",
      "url": "https://example.com/mcp",
    },
  },
}

Файл поддерживает JSONC (комментарии и замыкающие запятые разрешены). Полный справочник полей см. в Настройка MCP Серверов.

Что Kodik делает под капотом

• Для stdio серверов: Kodik запускает команду как дочерний процесс и общается через stdin/stdout.
• Для SSE / HTTP серверов: Kodik открывает HTTP соединение к URL.
• При каждом изменении конфигурации Kodik перезагружается автоматически — перезапуск не нужен.
• Секреты, введённые через UI (API ключи, пароли), хранятся в VS Code SecretStorage, а не в открытом виде в mcp.json.

Системные требования для Node.js/Python серверов

Среда выполнения	Минимальная версия	Проверка
Node.js	18.x	node --version
Python	3.10	python --version
uv (опционально, для изоляции Python)	любая	uv --version

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

• Красная статусная точка: наведите курсор, чтобы увидеть ошибку. Наиболее частые причины: неверный путь команды, отсутствующий API ключ или не установленная среда выполнения.
• Ошибка “Unknown transport type”: убедитесь, что type равен "stdio", "sse" или "http" (см. Транспорты).
• Инструмент не отображается: проверьте, что disabled не равен true и имя инструмента не находится в disabledTools.
• Удалить сервер: нажмите на сервер во вкладке Установленные → Удалить Сервер, или удалите его запись из mcp.json.

Подробнее о всех полях конфигурации см. Настройка MCP Серверов.