MCP для Qwen Code: подключение сервера через settings.json

Короткий ответ

Qwen Code читает серверы из ключа mcpServers в файле settings.json. Два места: ~/.qwen/settings.json — для всех проектов, .qwen/settings.json в папке проекта — только для него.

Добавить можно и командой, не открывая файл:

qwen mcp add --transport http мой-сервер http://localhost:3000/mcp

Результат одинаковый: команда просто дописывает запись в тот же settings.json.

Как выглядит запись

Локальный сервер, который запускается процессом на вашей машине:

{
  "mcpServers": {
    "мой-сервер": {
      "command": "npx",
      "args": ["-y", "имя-пакета"]
    }
  }
}

Формат тот же, что у Cursor — ключ mcpServers, внутри именованные серверы. Отличается только путь к файлу. Если вы уже настраивали MCP в другом редакторе, запись переносится копированием.

Проверить, что подключилось

Запустите qwen и откройте диалог управления MCP-серверами — там видно список и состояние каждого. Это первое место, куда стоит смотреть, если агент не видит инструмент: часто оказывается, что сервер описан, но падает при запуске.

Зачем это Qwen

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

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

Частые причины, почему не работает

Правится не тот файл. Проектный .qwen/settings.json перекрывает домашний, и правки в домашнем выглядят как проигнорированные.

Ошибка в JSON. Лишняя запятая ломает файл целиком, и пропадают сразу все серверы, а не один.

Команда не запускается сама по себе. Скопируйте её в терминал и выполните руками — если падает там, упадёт и здесь.

С чего начать

Один сервер, решающий вашу реальную задачу. Хорошие первые варианты — сервер документации или файловый доступ к рабочей папке.

Общий порядок подключения, одинаковый для любого агента, разобран в инструкции по подключению MCP. Что вообще бывает и зачем нужно — в обзоре MCP для нейросетей.