Как установить MCP-серверы в Claude Desktop (пошагово)

Как добавить MCP-сервер в Claude Desktop: где лежит claude_desktop_config.json в macOS и Windows, пример конфигурации и решение проблем.

Перед началом

Понадобится приложение Claude Desktop. Большинству серверов также нужен Node.js (для команд npx) или Python с uv (для команд uvx) — это указано в README сервера.

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

Нажмите на меню Claude в системной строке меню (не на настройки внутри окна чата), выберите Settings… и откройте Developer → Edit Config. Откроется файл claude_desktop_config.json. В macOS он находится в ~/Library/Application Support/Claude/claude_desktop_config.json, в Windows — в %APPDATA%\Claude\claude_desktop_config.json.

2. Добавьте сервер

Добавьте запись в mcpServers. В этом примере добавлен официальный сервер Filesystem с доступом к одной папке:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

3. Перезапустите и проверьте

Полностью закройте Claude Desktop и откройте снова. В поле ввода чата нажмите Add files, connectors, and more, откройте Connectors → Manage connectors и выберите свой сервер, чтобы увидеть его инструменты. Если он не подключается, посмотрите журналы (mcp.log и mcp-server-ИМЯ.log) в ~/Library/Logs/Claude в macOS или в %APPDATA%\Claude\logs в Windows.

Советы

Используйте абсолютные пути.
Храните API-ключи в объекте env внутри записи сервера.
На многих страницах серверов в Socketlist есть готовая конфигурация, взятая из README.