Установка MCP в Claude Desktop
Локальный MCP в Claude Desktop: конфиг macOS и Windows, ключ ФНС, проверка подключения и отличие от remote-коннектора.
Обновлено:
Требования
Эта инструкция запускает MCP-клиент на вашем компьютере через stdio. Claude Desktop
запускает uvx и обменивается с процессом вызовами инструментов. Если клиент использует
размещённый API, он обращается к нему отдельно — это не remote MCP-коннектор Claude.
- Claude Desktop последней версии (claude.ai/download).
- uv в PATH (см. Cursor setup).
Путь к конфиг-файлу
| ОС | Путь |
|---|---|
| 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 не появился в списке тулов
- Проверьте JSON — должен быть валидным. Используйте jsonlint.com.
- Перезапустили ли Claude полностью (Quit, не закрытие окна)?
- Посмотрите логи:
tail -f ~/Library/Logs/Claude/mcp.log— там будет ошибка стартапа.
”spawn uvx ENOENT” в логах
uvx не в PATH процесса Claude. Решения:
-
На macOS: укажите полный путь к uv в конфиге:
"command": "/Users/<you>/.local/bin/uvx"(Узнать через
which uvx.) -
После изменения PATH полностью перезапустите приложение. Настройки shell в
~/.zshrc/~/.bashrcмогут не применяться к GUI-приложению; полный путь кuvxв конфиге устраняет эту неоднозначность.
Подробный troubleshooting → /docs/troubleshooting
Что дальше
- Claude Code (CLI) → — для тех, кто работает в терминале.
- Cline / Continue → — для VS Code.
- Каталог MCP → — выбрать какие добавить.
Частые вопросы
Чем настройка через файл отличается от 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, без чужих секретов.
Нужно ли давать всем инструментам постоянное разрешение?
Нет. Просмотрите список действий и начните с чтения. Для операций, которые меняют данные или списывают деньги, сохраняйте явное подтверждение.
