Atomno labs

Установка MCP в Claude Desktop

Как добавить MCP-сервер в Claude Desktop: путь к конфиг-файлу на macOS / Windows / Linux, формат конфига, проверка работоспособности.

Обновлено:

Требования

Путь к конфиг-файлу

ОСПуть
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

В Claude Desktop путь можно найти через Settings → Developer → Edit Config. Это откроет файл в системном текстовом редакторе.

Минимальный конфиг

{
  "mcpServers": {
    "atomno-cbr-rates": {
      "command": "uvx",
      "args": ["atomno-mcp-cbr-rates"]
    }
  }
}

После сохранения — полностью перезапустите Claude Desktop (Cmd+Q на macOS, или закройте из системного трея на Windows).

Проверка

В чате должна появиться кнопка с иконкой инструментов (внизу справа от поля ввода). Нажмите на неё — увидите список тулов atomno-cbr-rates.

Попросите Claude:

«Какой курс евро ЦБ на сегодня и динамика за последние 7 дней?»

Если Claude вызывает тул и отвечает с реальными числами — установка успешна.

С env-vars

Аналогично Cursor:

{
  "mcpServers": {
    "atomno-fns-check": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-check"],
      "env": {
        "MCP_FNS_CHECK_TOKEN": "atl_xxxxx"
      }
    }
  }
}

Полный конфиг с несколькими MCP

{
  "mcpServers": {
    "atomno-cbr-rates": {
      "command": "uvx",
      "args": ["atomno-mcp-cbr-rates"]
    },
    "atomno-fns-check": {
      "command": "uvx",
      "args": ["atomno-mcp-fns-check"],
      "env": { "MCP_FNS_CHECK_TOKEN": "atl_xxx" }
    },
    "atomno-egrul": {
      "command": "uvx",
      "args": ["atomno-mcp-egrul"]
    },
    "atomno-zakupki": {
      "command": "uvx",
      "args": ["atomno-mcp-zakupki"],
      "env": { "MCP_ZAKUPKI_TOKEN": "atl_yyy" }
    }
  }
}

Особенности Claude Desktop

  • Один глобальный конфиг — нет проектных настроек. Все MCP подключаются всегда.
  • Логи: ~/Library/Logs/Claude/mcp*.log (macOS), %APPDATA%\Claude\logs\mcp*.log (Windows).
  • Approval: при первом вызове тула Claude Desktop спрашивает разрешение. Можно дать «всегда» для конкретного MCP.

Типовые проблемы

MCP не появился в списке тулов

  1. Проверьте JSON — должен быть валидным. Используйте jsonlint.com.
  2. Перезапустили ли Claude полностью (Quit, не закрытие окна)?
  3. Посмотрите логи: tail -f ~/Library/Logs/Claude/mcp.log — там будет ошибка стартапа.

”spawn uvx ENOENT” в логах

uvx не в PATH процесса Claude. Решения:

  1. На macOS: укажите полный путь к uv в конфиге:

    "command": "/Users/<you>/.local/bin/uvx"

    (Узнать через which uvx.)

  2. Или добавьте ~/.local/bin в системный PATH через ~/.zshrc / ~/.bashrc.

Подробный troubleshooting → /docs/troubleshooting

Что дальше