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

Команда claude mcp add, области видимости и общий файл проекта

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

В Claude Code серверы подключают командой в терминале, не в окне Claude Code. Всё, что стоит после двух дефисов, — команда запуска локального сервера.

_Claude Code хранит серверы в трёх областях: только для вас в этом проекте, для всех участников проекта через .mcp.json и для вас во всех проектах._

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

_Добавить локальный сервер_

```bash
claude mcp add playwright -- npx @playwright/mcp@latest

# с переменной окружения
claude mcp add godot -e GODOT_PATH=/opt/godot/godot -- npx @coding-solo/godot-mcp

# свой сервер на Python SDK
claude mcp add catalog -- uv run --with "mcp[cli]" mcp run /абсолютный/путь/server.py
```

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

В версиях Claude Code 2.1.1 и новее удалённый сервер удобно добавлять описанием в JSON:

_Добавить удалённый сервер с токеном_

```bash
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer ВАШ_ТОКЕН"}}'
```

В более старых версиях — так:

_Прежний формат команды_

```bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer ВАШ_ТОКЕН"
```

Если сервер поддерживает OAuth, заголовок не нужен: Claude Code предложит войти через браузер.

## Области видимости

**Ключ --scope**
| Область | Где действует | Где хранится |
|---|---|---|
| `local` (по умолчанию) | Только у вас и только в текущем проекте | Ваши настройки Claude Code |
| `project` | У всех, кто работает с проектом | Файл `.mcp.json` в корне проекта |
| `user` | У вас во всех проектах | Ваши настройки Claude Code |

_Сервер для всех участников проекта_

```bash
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
```

> Файл `.mcp.json` попадает в репозиторий. Не вписывайте в него токены: передавайте их через переменные окружения каждого участника.

## Проверка

_Список серверов и подробности_

```bash
claude mcp list
claude mcp get playwright
```

Внутри сеанса Claude Code команда `/mcp` показывает, к каким серверам есть подключение и какие у них инструменты.

## Если что-то не так

- В Windows команда `claude mcp add-json` для HTTP-сервера иногда отвечает `Invalid input` — используйте прежний формат с `--transport http`.
- Если команда запуска сервера не находится, укажите её полный путь.
- Остальное — в разделе [«Частые ошибки»](https://mcpdocs.ru/podklyuchenie/#oshibki).