Як підключити сервери MCP до Claude Desktop

Віддалені сервери: додайте власний конектор

Відкрийте Claude Desktop, перейдіть у Settings, потім Connectors, і натисніть Add custom connector. Дайте йому назву, вставте URL сервера і підтвердьте. Власні конектори через віддалений MCP доступні на планах Free, Pro, Max, Team і Enterprise; акаунт Free обмежений одним власним конектором. На планах Team і Enterprise власник організації спершу додає конектор у налаштуваннях організації, а учасники потім вмикають його на власній сторінці Connectors.

Сервери, що підтримують OAuth, при першому використанні просять вас увійти й підтвердити області доступу в браузері; більше нічого не потрібно. Необов'язковий розділ Advanced settings приймає ідентифікатор і секрет клієнта OAuth для серверів, що вимагають попередньо зареєстрованого клієнта, чого більшість публічних серверів не вимагає. Для сервера HostTracker URL такий: https://mcp.host-tracker.com/mcp; він використовує OAuth із динамічною реєстрацією клієнта, тож конектор тримає лише ті області доступу, які ви підтвердили, і жодного ключа вставляти не потрібно.

Конектори виконуються на стороні Anthropic, а не з вашої машини, тож вони не можуть дістатися сервера у вашій локальній мережі, і це той самий механізм, що використовують claude.ai і Cowork. Файл конфігурації, описаний далі, - його локальний аналог.

Локальні сервери: редагування claude_desktop_config.json

Відкрийте Settings, оберіть вкладку Developer і натисніть Edit Config. Це відкриє файл конфігурації у вашому редакторі, створивши його, якщо він ще не існує. Файл лежить за адресою ~/Library/Application Support/Claude/claude_desktop_config.json на macOS і %APPDATA%\Claude\claude_desktop_config.json на Windows; у бета-версії для Linux користуйтеся кнопкою Edit Config, а не вгадуйте шлях. Кожен сервер - це запис під mcpServers із командою запуску та її аргументами:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Збережіть файл, потім повністю закрийте Claude Desktop і запустіть знову; закриття вікна недостатньо, бо сервери запускаються при старті застосунку. На Windows середовище виконання, від якого залежить команда, наприклад Node.js для npx, має бути встановлене і в PATH, який бачить десктопний застосунок, тож сервер, що нормально працює в терміналі, але не із застосунку, - зазвичай саме різниця в PATH.

Щоб побачити, що сервер завантажився, натисніть іконку "Add files, connectors, and more" внизу зліва від поля повідомлення, наведіть на Connectors і відкрийте Manage connectors; сервер буде в списку з його інструментами. У старішій документації цю іконку називають іконкою молотка, і сторінка усунення несправностей досі використовує цю назву в одному заголовку.

Розширення з каталогу

Settings, потім Extensions, потім Browse extensions показує курований каталог локальних серверів, спакованих як розширення, які встановлюються в одне клацання і оновлюються самі. Завантажений пакет встановлюється через Install Extension вибором файлу; ці пакети використовують формат .mcpb, що замінив попередню назву .dxt, і можуть загортати сервери на Node.js, Python чи бінарні. Пакети приватного поширення не оновлюються самі, і після зміни їх треба перевстановлювати вручну.

Де шукати логи, коли нічого не з'являється

Claude Desktop веде загальний лог з'єднань і по одному логу на кожен сервер. На macOS вони лежать у ~/Library/Logs/Claude/ як mcp.log і mcp-server-NAME.log; на Windows - у %APPDATA%\Claude\logs. Файл окремого сервера несе його власний вивід помилок, і саме там прописано відсутній модуль, неправильний шлях чи відхилені облікові дані. Якщо файл порожній, застосунок узагалі не зміг запустити команду, а це вказує назад на PATH чи на синтаксичну помилку JSON у файлі конфігурації.

Один застосунок, дві поверхні

Claude Desktop тепер має вкладку Code, що запускає Claude Code всередині застосунку, поряд із вкладкою Chat. Сервери, задекларовані в claude_desktop_config.json, доступні як на поверхні чату, так і в локальних сесіях вкладки Code, поряд із тими, що з ~/.claude.json і проєктного .mcp.json; коли те саме ім'я існує в обох місцях, вкладка Code бере визначення з десктопного файлу. Окремий командно-рядковий Claude Code не читає десктопний файл. Якщо ви спершу налаштували сервери в десктопному застосунку і хочете отримати їх у терміналі, claude mcp add-from-claude-desktop імпортує їх на macOS і Windows Subsystem for Linux, як описано в посібнику як додати сервер MCP до Claude Code.

Віддалений сервер моніторингу як перший конектор

Віддалений сервер - найшвидший спосіб переконатися, що потік підключення конектора працює, бо тут нічого встановлювати, а відповідь можна перевірити. Додайте сервер HostTracker як власний конектор, увійдіть, коли попросять, і запитайте Claude, чи працює знайомий вам сайт; відповідь має посилатися на перевірку, виконану з названих контрольних точок HostTracker, а не на здогадку. Сторінка сервера MCP перелічує всі 65 інструментів і області доступу, потрібні кожному з них, від миттєвих перевірок до оновлень сторінок статусу.