Паветта
Как подключить MCP-сервер к Qwen Code
Qwen Code берёт MCP-серверы из mcpServers в settings.json. Добавить сервер можно вручную или командой qwen mcp add, транспорты — stdio, Streamable HTTP и SSE.
Где лежит конфиг
~/.qwen/settings.jsonДля всех проектов (по умолчанию).qwen/settings.jsonДля одного проектаКак добавить сервер
1
Удалённый сервер
qwen mcp add --transport http my-server http://localhost:3000/mcp. Ключ передаётся флагом --header "Authorization: Bearer your-api-token".
2
Локальный сервер
qwen mcp add pythonTools -e DATABASE_URL=$DB_CONNECTION_STRING python -m my_mcp_server --port 8080.
3
В проект
Добавьте --scope project, и запись попадёт в .qwen/settings.json.
4
Через файл
В mcpServers: command, args и env для stdio, httpUrl и headers для HTTP, url для SSE.
Как проверить и удалить
ПроверкаЗапустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Удалениеqwen mcp remove <имя>.
Довериеtrust: true отключает подтверждения вызовов для этого сервера в доверенной папке.
Выбор инструментовincludeTools оставляет только перечисленные инструменты, excludeTools убирает лишние. При конфликте побеждает excludeTools.
Тайм-аутtimeout задаёт время на вызов инструмента в миллисекундах, по умолчанию 600 000, то есть 10 минут.
OAuthФлаги --oauth-client-id, --oauth-client-secret, --oauth-scopes и другие. Окно /mcp показывает и состояние входа.
Готовые конфиги для Qwen Code
Нажмите на сервер, чтобы раскрыть конфиг в формате Qwen Code.
Playwright MCPДаёт агенту настоящий браузер
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
GitHub MCPПодключает агента к GitHub
{
"mcpServers": {
"github": {
"httpUrl": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer <GitHub PAT>"
}
}
}
}
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
{
"mcpServers": {
"context7": {
"httpUrl": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer <ключ Context7>"
}
}
}
}
Figma MCPПодключает агента к макетам Figma
{
"mcpServers": {
"figma": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<ваш токен Figma>"
}
}
}
}
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Fetch MCPДаёт агенту читать веб-страницы
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Memory MCPДаёт агенту долгую память между чатами
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
}
}
}
}
Supabase MCPПодключает агента к проектам Supabase
{
"mcpServers": {
"supabase": {
"httpUrl": "https://mcp.supabase.com/mcp"
}
}
}
Notion MCPЛокальный сервер Notion поверх Notion API
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
Blender MCPСвязывает агента с запущенным Blender
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
{
"mcpServers": {
"1c": {
"httpUrl": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
"headers": {
"Authorization": "Basic <логин и пароль пользователя 1С>"
}
}
}
}Ограничения
!
Токены OAuth по умолчанию лежат в ~/.qwen/mcp-oauth-tokens.json без шифрования. Шифрование включает QWEN_CODE_FORCE_ENCRYPTED_FILE_STORAGE=true.
!
Флаги --oauth-* работают только с --transport sse и --transport http.
!
Если Qwen Code уже был запущен, после добавления сервера перезапустите его в том же проекте.
Если не работает
В qwen mcp list сервер Disconnected
Проверьте адрес или команду, затем увеличьте timeout.
stdio-сервер не стартует
Укажите абсолютный путь в command и перепроверьте cwd и env.
Переменные в JSON не подставляются
Проверьте, что они заданы в окружении, где запущен Qwen Code: у терминала и графического приложения окружение может отличаться.
Частые вопросы
Куда qwen mcp add записывает сервер?
По умолчанию в ~/.qwen/settings.json, сервер виден во всех проектах. С --scope project он попадёт в .qwen/settings.json проекта.
Чем httpUrl отличается от url?
httpUrl — адрес Streamable HTTP, url — адрес SSE. Если сервер умеет оба, выбирайте HTTP.
Как передать токен удалённому серверу?
Флагом --header "Authorization: Bearer ваш-токен" или полем headers в settings.json.
Как ограничить инструменты сервера?
Перечислите нужные в includeTools или ненужные в excludeTools.
Источники: github.com, github.com