# Подключение MCP-сервера в Claude Desktop

Локальные серверы — в файле настроек, удалённые — через коннекторы

> Страница сайта MCP Docs — руководство (https://mcpdocs.ru/podklyuchenie/claude-desktop/). Тип: Руководство. Сверено с документацией SDK и поставщиков серверов 13.10.2026. Ревизия спецификации 2026-07-28, сверено 13.10.2026.

В 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_

```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 (не только окно) и откройте снова. Сервер появится в списке инструментов окна чата.

> Claude Desktop запускает сервер в собственном процессе: переменные окружения вашей оболочки туда не попадают. Всё, что нужно серверу, передавайте в `env`, а пути к командам и файлам пишите полностью.

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

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

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

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

Команда сама находит файл настроек, превращает путь в абсолютный и закрепляет версию SDK. Как написать такой сервер — в руководстве [«Свой сервер на Python»](https://mcpdocs.ru/svoy-server/).

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

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

> Свой коннектор подключается из облака Anthropic, поэтому адрес должен быть доступен из интернета по HTTPS. Сервер на `localhost` так не подключить.

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

Файл настроек принимает только локальные серверы с командой. Чтобы подключить сервер, который слушает HTTP на вашем компьютере (например, [EDT MCP Server](https://mcpdocs.ru/1c/edt/) на порту 8765), используют мост `mcp-remote`: он запускается как локальный сервер и пересылает запросы по HTTP.

_claude_desktop_config.json — мост к серверу на localhost_

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

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

- Проверьте, что файл — корректный JSON: лишняя запятая ломает весь файл.
- Укажите полный путь к `npx`, `uvx` или `python`, если приложение их не находит.
- Запустите сервер в [MCP Inspector](https://mcpdocs.ru/podklyuchenie/#inspector): если он не работает и там, дело в сервере, а не в настройках.

Другие ошибки — в разделе [«Частые ошибки»](https://mcpdocs.ru/podklyuchenie/#oshibki).