В Claude для компьютера два пути. Локальные серверы, которые приложение запускает само, описывают в файле claude_desktop_config.json. Удалённые подключают в разделе «Коннекторы» по адресу HTTPS.

Claude Desktop: локальный сервер запускается по команде из файла настроек, удалённый подключается как коннектор по адресу HTTPS.

Где файл настроек#

Таблица: Расположение claude_desktop_config.json | Система | Путь | |---|---| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json |

Если папки нет, установите Claude Desktop и запустите его один раз: папка появится.

Локальный сервер#

Добавьте сервер в объект mcpServers. Пример для эталонного сервера файлов: он видит только перечисленные папки.

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": { "MEMORY_FILE_PATH": "/Users/me/.claude-memory.jsonl" }
    }
  }
}

Полностью закройте Claude Desktop (не только окно) и откройте снова. Сервер появится в списке инструментов окна чата.

Свой сервер на Python: команда mcp install#

Если сервер написан на официальном Python SDK, запись в файл настроек можно не писать руками:

Регистрация сервера в Claude Desktop

uv run mcp install server.py
# с переменными окружения:
uv run mcp install server.py -v API_KEY=abc123

Команда сама находит файл настроек, превращает путь в абсолютный и закрепляет версию SDK. Как написать такой сервер — в руководстве «Свой сервер на Python».

Удалённый сервер#

Удалённые серверы добавляют в настройках приложения: Settings → Connectors → Add custom connector — и указывают адрес сервера. Если сервер закрыт OAuth, Claude откроет вход в браузере.

Сервер на localhost по HTTP: мост mcp-remote#

Файл настроек принимает только локальные серверы с командой. Чтобы подключить сервер, который слушает HTTP на вашем компьютере (например, EDT MCP Server на порту 8765), используют мост mcp-remote: он запускается как локальный сервер и пересылает запросы по HTTP.

claude_desktop_config.json — мост к серверу на localhost

{
  "mcpServers": {
    "edt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8765/mcp"]
    }
  }
}

Если сервер не появился#

Проверьте, что файл — корректный JSON: лишняя запятая ломает весь файл.
Укажите полный путь к npx, uvx или python, если приложение их не находит.
Запустите сервер в MCP Inspector: если он не работает и там, дело в сервере, а не в настройках.

Другие ошибки — в разделе «Частые ошибки».