К содержимому
Блог

Claude Desktop: установка, MCP-серверы и подключение к Relay

Claude Desktop: установка, MCP-серверы и подключение к Relay

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

Коротко

  • Установщик берите только со страницы загрузки на официальном сайте Claude.

  • Подключение MCP-сервера сводится к правке одного JSON-файла и полному перезапуску приложения.

  • К Relay приложение подключают тремя путями: Relay Desktop, CC Switch или встроенный Gateway.

  • В режиме Gateway адрес указывается как https://relay-llm.ru, без /v1.

Где взять приложение и что оно требует

Надёжный источник один: страница загрузки на официальном сайте Claude, плюс Microsoft Store для Windows. Сборки с пометками «portable» или «crack» и раздачи с торрентов обходите стороной. Подменённый установщик получает доступ ко всему, что видит приложение, а вместе с ним и ваши файлы с ключами.

Требования вендора на 29 октября 2026 года. Перед установкой сверьте их на странице загрузки.

ПлатформаМинимальная версияИсточник
macOS13 и выше, Intel и Apple Siliconстраница загрузки на сайте Claude
Windows10 и выше, сборки x64 и ARM64страница загрузки или Microsoft Store
LinuxUbuntu 22.04 и выше или Debian 12 и выше, это бетаapt-репозиторий, по инструкции вендора

Для Linux вендор опубликовал свои команды вместе с проверкой подписи репозитория, и брать их стоит из его документации, а не из пересказов. Вход в аккаунт Anthropic нужен, если вы работаете по подписке вендора. При подключении через Relay его заменяет ключ, об этом ниже.

Как подключить MCP-сервер

MCP-сервер это отдельная программа, через которую модель читает файлы, ходит в базы данных или вызывает внешние API. Большинство серверов запускается через Node.js, поэтому поставьте версию LTS с официального сайта Node.js.

Настройки лежат в меню приложения Claude в строке меню системы, а не в окне чата. Откройте Settings, перейдите на вкладку Developer и нажмите Edit Config: приложение само откроет нужный файл claude_desktop_config.json. Если нужно найти его вручную:

СистемаКонфигурацияЖурналы
macOSпапка ~/Library/Application Support/Claude~/Library/Logs/Claude
Windowsпапка %APPDATA%\Claude%APPDATA%\Claude\logs
Linuxвендор путь не называет, используйте кнопку Edit Configвендор путь не называет

В файле нужен раздел mcpServers. Пример с сервером, который открывает модели одну рабочую папку:

json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/ivan/projects"
      ]
    }
  }
}

Замените ivan на своё имя пользователя. Пути должны быть абсолютными, а в Windows обратные слеши в JSON удваиваются. Одна лишняя запятая ломает весь файл, поэтому перед перезапуском проверьте синтаксис (команда для macOS):

bash
python3 -m json.tool "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Затем завершите работу приложения полностью, закрытия одного окна мало, и запустите его снова. Новый сервер появится среди коннекторов в поле ввода сообщения. Если он не появился, смотрите журналы: общий файл mcp.log описывает подключения, а mcp-server-ИМЯ.log содержит вывод конкретного сервера.

Три способа перевести Claude Desktop на Relay

По документации Relay подключение меняет только источник модели. Запросы приложения идут на шлюз и оплачиваются с баланса, подписка Anthropic в этом сценарии не нужна, а расход каждого запроса виден в консоли Relay.

СпособЧто делаетеКогда выбрать
Relay DesktopСтавите приложение Relay, находите в нём Claude Desktop и жмёте «Connect to Relay»Нужно как можно меньше ручных шагов
CC SwitchДобавляете Relay провайдером в графическом менеджере и вводите ключВы держите несколько провайдеров под рукой
Встроенный GatewayЗаполняете поля стороннего инференса в самом приложенииНе хотите ставить дополнительные программы

В Relay Desktop вернуться к подписке Anthropic можно кнопкой «Disconnect Relay»: она убирает подключение из Claude Desktop. CC Switch документация требует версии 3.16.5 или новее. В нём откройте вкладку Claude Desktop, нажмите кнопку добавления в правом верхнем углу, найдите Relay среди готовых провайдеров, введите ключ из консоли и сохраните. Потом включите Relay на главном экране и перезапустите приложение.

Встроенная настройка обходится без сторонних программ. Включите режим разработчика: в меню Help откройте Troubleshooting и выберите Enable Developer Mode. В появившемся меню Developer откройте Configure Third-Party Inference, выберите тип подключения Gateway и заполните поля.

ПолеЗначение
Gateway base URLhttps://relay-llm.ru, без /v1
Gateway API keyключ из консоли Relay
Схема авторизацииBearer, если такое поле есть
Custom inference headersпустое значение

Когда список моделей пуст, добавьте идентификаторы руками в разделе Models, например claude-sonnet-5-5 или claude-haiku-5.5. Примените настройки, полностью закройте приложение и откройте снова. Документация Relay уточняет, что и Cowork, и Code берут шлюз из этой настройки. Отправьте сообщение и найдите его в журнале запросов консоли.

Claude Sonnet 5.50,52 $ за 1 млн входных токенов

Две оговорки по документации вендора. Режим стороннего инференса рассчитан в первую очередь на организации, и приложение даже в нём может обращаться к серверам Anthropic за служебными данными, например за обновлениями и каталогом моделей. Достучится ли оно туда, зависит от вашей сети. Кроме того, вендор не проверяет и не поддерживает сторонние шлюзы, так что при сбое начинайте с адреса, ключа и названия модели.

Нужен терминальный агент без графической оболочки? Начните со статьи Claude Code: установка и три способа оплаты или со страницы интеграции с Claude Code. Полный порядок для приложения описывает инструкция по Claude Desktop.

Если что-то не работает

Что видитеВ чём причинаКак исправить
Пустой список моделейЛишний /v1 в адресе или неверный ключУберите /v1, проверьте ключ, добавьте модели вручную
Ответ 401Ключ неверный, просроченный или отозванныйСверьтесь с консолью, при необходимости выпустите новый ключ
Ответ 402На балансе нольПополните баланс
Windows: Virtual Machine Platform not availableОтключён компонент системыWin+R, команда optionalfeatures, отметить компонент, перезагрузка
MCP-сервер не появился в спискеСинтаксис JSON, относительный путь, приложение закрыто не до концаПрогоните файл через проверку, задайте абсолютные пути, перезапустите
Не найден npxНе установлен Node.jsПоставьте LTS и перезапустите приложение

Как открыть конфигурацию MCP, если не помню путь?

Меню Claude в строке системы, затем Settings, вкладка Developer и кнопка Edit Config. Приложение открывает файл само, поэтому искать его в папках не нужно.

Нужна ли подписка Anthropic, если приложение подключено к Relay?

Нет, запросы идут на шлюз и оплачиваются с баланса за токены. В Relay Desktop вернуться к подписке можно кнопкой «Disconnect Relay», она убирает подключение из Claude Desktop.

На каких дистрибутивах Linux работает приложение?

По данным вендора, это бета для Ubuntu 22.04 и выше и Debian 12 и выше на архитектурах x86_64 и arm64. Для Fedora и Arch десктопной версии нет, там остаётся Claude Code в терминале.

Создать ключ

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.