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

> Быстрый способ добавить MCP сервер в Kodik: установка из маркетплейса или ручная быстрая настройка.

Источник: https://docs.kodik.ru/mcp/made-easy

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

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

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

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

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

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

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

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

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

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

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

Файл поддерживает JSONC (комментарии и замыкающие запятые разрешены). Полный справочник полей см. в [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring).

## Что 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"` (см. [Транспорты](https://docs.kodik.ru/mcp/transports)).
- **Инструмент не отображается**: проверьте, что `disabled` не равен `true` и имя инструмента не находится в `disabledTools`.
- **Удалить сервер**: нажмите на сервер во вкладке Установленные → **Удалить Сервер**, или удалите его запись из `mcp.json`.

Подробнее о всех полях конфигурации см. [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring).