Перейти к основному содержанию

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

Локальный MCP в Claude Desktop: конфиг macOS и Windows, ключ ФНС, проверка подключения и отличие от remote-коннектора.

Обновлено:

Требования

Эта инструкция запускает MCP-клиент на вашем компьютере через stdio. Claude Desktop запускает uvx и обменивается с процессом вызовами инструментов. Если клиент использует размещённый API, он обращается к нему отдельно — это не remote MCP-коннектор Claude.

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

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

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

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

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

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

Проверка

Откройте «+» у поля ввода → Connectors → Manage connectors. Проверьте инструменты atomno-cbr-rates; состояние подключения и логи также доступны в настройках Developer.

Попросите Claude:

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

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

С env-vars

В совместимом клиенте размещённый check_contractor использует MCP_FNS_API_KEY. YOUR_ATOMNO_API_KEY ниже замените своим ключом из общего кабинета. Это ключ Atomno, а не Anthropic API key. Без него клиент сохраняет открытый режим; наличие ключа не переводит все остальные инструменты в размещённый режим.

В опубликованной версии этот режим не работает. На 7 октября 2026 на PyPI доступен клиент 0.1.12. Проверка его пакета и вызова MCP подтвердила: он игнорирует MCP_FNS_API_KEY и продолжает локальную проверку, без обращения к API подписки. Добавление ключа в конфигурацию не подключает общую квоту.

Режим проверен в локальных исходниках 0.2.4, но это не опубликованный релиз. Ниже — схема настройки для совместимого клиента; применять её для размещённого доступа можно после выпуска и приёмки такого клиента. Сейчас обычный uvx atomno-mcp-fns-check не даёт этот режим.

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

Полный конфиг с несколькими 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_API_KEY": "YOUR_ATOMNO_API_KEY" }
    }
  }
}

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

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

Remote MCP — отдельное подключение

Claude также поддерживает удалённые MCP-коннекторы по URL. Они настраиваются в аккаунте Claude и вызываются из облака Anthropic; файл claude_desktop_config.json к этому способу не относится. См. официальную инструкцию Claude.

Для remote нужен именно MCP endpoint и совместимая авторизация. Обычный REST URL не заменяет его. Доступность remote MCP Atomno в Claude здесь не подтверждена; выдуманного адреса для подключения мы не приводим.

О подключении в других приложениях и повторном использовании ключа: один ключ и общая квота.

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

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. После изменения PATH полностью перезапустите приложение. Настройки shell в ~/.zshrc / ~/.bashrc могут не применяться к GUI-приложению; полный путь к uvx в конфиге устраняет эту неоднозначность.

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

Что дальше

Частые вопросы

Чем настройка через файл отличается от remote-коннектора Claude?

Файл claude_desktop_config.json описывает запуск локального процесса через stdio. Remote-коннектор настраивается отдельно в аккаунте Claude и требует MCP endpoint с совместимой авторизацией. Обычный REST URL не заменяет такой endpoint.

Что проверить, если сервер не появился после сохранения конфига?

Проверьте корректность JSON, полностью завершите Claude Desktop и запустите его заново. Если в логах есть spawn uvx ENOENT, приложение не находит uvx: проверьте PATH или укажите полный путь к программе.

Как начать с курсов валют ЦБ в Claude Desktop?

Добавьте локальную команду uvx atomno-mcp-cbr-rates по примеру инструкции и перезапустите приложение. Затем запросите курс нужной валюты и проверьте дату полученных сведений.

Почему ключ Atomno не заменяет URL remote MCP?

Ключ относится к поддерживаемому размещённому доступу, а remote-коннектору нужен совместимый MCP endpoint. Нельзя подключить обычный REST-адрес вместо MCP-сервера; локальный stdio-клиент настраивается отдельно.

Почему после установки пакета его инструменты ещё не видны в Claude?

Установка пакета и добавление сервера в конфигурацию — разные шаги. Проверьте путь к настройке, команду запуска и журнал ошибки; после изменения файла следуйте шагам перезапуска из инструкции.

Можно ли взять mcp.json из Cursor без проверки?

Конфигурации похожи по идее, но расположение файла и настройка хоста отличаются. Переносите только подходящую запись запуска по инструкции Claude Desktop, без чужих секретов.

Нужно ли давать всем инструментам постоянное разрешение?

Нет. Просмотрите список действий и начните с чтения. Для операций, которые меняют данные или списывают деньги, сохраняйте явное подтверждение.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть