MCP Academy · Урок

Подключение к Claude Desktop

Измените конфигурацию, чтобы Claude загрузил Ваш сервер.

Урок 2 из 413 шагов

«Подключение к Claude Desktop» — бесплатный урок MCP Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.

От скрипта к настоящему хосту

Ваш сервер работает, но пока с ним никто не взаимодействует. Давайте подключим его к настоящему хосту: Claude Desktop. 🖥️

Он читает файл конфигурации

Claude Desktop находит серверы в одном JSON-файле с именем claude_desktop_config.json. Вы перечисляете в нём серверы, и приложение загружает их при запуске.

Где находится файл

В macOS файл находится в каталоге Application Support, а в Windows — в папке AppData для перемещаемых данных. Откройте его через настройки приложения.

~/Library/Application Support/Claude/claude_desktop_config.json

Ключ mcpServers

Каждый сервер помещается внутрь объекта верхнего уровня mcpServers. Каждый ключ — это выбранное вами имя, а значение описывает способ запуска.

{
  "mcpServers": {}
}

Команда и аргументы

Для каждого сервера укажите команду и массив аргументов. Вместе они точно определяют, как хост запускает ваш процесс.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

Используйте абсолютные пути

Хост запускается из собственного рабочего каталога, поэтому относительные пути не работают. Всегда указывайте в аргументах абсолютный путь к скрипту.

uv упрощает работу

Если ваш проект использует uv, укажите в качестве команды uv и позвольте ему запустить модуль в нужном окружении — глобальная установка не потребуется.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

Передавайте переменные окружения

Секреты, например ключи API, помещайте в необязательный объект env. Хост передаёт их серверу при запуске, поэтому они не попадают в код.

"env": { "API_KEY": "sk-..." }

Перезапустите для применения изменений

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

Значок молотка

Если всё работает, в чате появляется небольшой индикатор инструментов. Нажмите его, чтобы увидеть инструменты, которые ваш сервер предлагает Claude. 🔨

Тщательно выбирайте имя

Выбранный в mcpServers ключ становится именем сервера. Сделайте его коротким и уникальным, чтобы несколько серверов не конфликтовали в хосте.

Быстрая проверка

Какое изменение нужно Claude Desktop, чтобы загрузить только что добавленный сервер?

Ответь в интерактивном уроке

Итоги

Вы добавили сервер в claude_desktop_config.json, указав команду, аргументы и env, использовали абсолютные пути и перезапустили приложение. Теперь он работает в Claude! ✅

Можно начать бесплатно

Изучай Python с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы: 30
Уроки: 120

Начать учиться бесплатно Посмотреть полный курс

Часто задаваемые вопросы

Урок «Подключение к Claude Desktop» бесплатный?

Да — полный текст урока «Подключение к Claude Desktop» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.

Чему я научусь в уроке «Подключение к Claude Desktop»?

Измените конфигурацию, чтобы Claude загрузил Ваш сервер. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать MCP Academy?

Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Подключение к Claude Desktop»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке MCP Academy?

Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к MCP Academy