# MCP-сервер что это: 7 шагов до первого инструмента в Claude Code

> MCP сервер что это и зачем он нужен: связывает Claude Code с внешними данными и инструментами. Ниже - простой способ выбрать и подключить первый готовый сервер.

Источник: https://vibeceh.ru/guides/mcp-podklyuchit-pervyj-instrument
Автор: Сергей Мазур · опубликовано 2026-08-01

MCP сервер что это? Простыми словами, это связующее звено между ИИ и внешним инструментом или данными. MCP-сервер живёт отдельно от Claude Code и даёт агенту доступ к браузеру, файлам, документации, базе или API без ручного копирования всего в чат.

Я собрал эту инструкцию, чтобы ты подключил первый сервер за 10 минут и увидел результат, а не разбирался в документации неделю.   https://vibeceh.ru/?utm_source=article&utm_campaign=mcp-podklyuchit-pervyj-instrument&utm_content=cta-top#buy

## MCP-сервер: что это простыми словами

[MCP](/concepts/mcp) - стандартный разъём между ИИ и внешними инструментами или данными. Сервер находится отдельно от Claude Code, а [агент](/concepts/agent) обращается к нему, когда нужен внешний источник или действие. Без MCP каждый сервис требовал бы отдельной интеграции и ручного копирования данных в чат.

Представь USB-C для ИИ. Один разъём подходит для разных устройств. Здесь вместо устройства подключается внешний сервис.

“MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications.”

Я подключаю MCP-сервер, и Claude Code остаётся той же моделью. Агент не обучается навсегда. Сервер решает более узкую практическую задачу:

- агент получает доступ к данным за пределами чата;
- видит доступные действия;
- принимает запрос агента;
- возвращает результат из внешней системы.

Например, Claude Code может получить данные из трекера задач или мониторинга. Без MCP пришлось бы открыть сервис, найти нужную запись, скопировать её и вставить в чат.

Сервер бывает локальным или удалённым. В обоих случаях он отделён от самого Claude Code. Агент подключается к нему через стандартный протокол, поэтому для каждого сервиса не приходится собирать отдельную связку.

## Как MCP-сервер связывает Claude Code с внешним инструментом

[Claude Code](/guides/claude-code-ili-cursor) выступает клиентом, MCP-сервер публикует доступные tools, а агент вызывает их по запросу. Данные не приходится каждый раз переносить в чат вручную. Цепочка проста: Claude Code запускается как клиент, сервер сообщает доступные инструменты, агент выбирает действие, а результат возвращается прямо в диалог.

Запрос «mcp сервер как работает» сводится к простой цепочке:

1. Claude Code запускается как MCP-клиент.
2. MCP-сервер сообщает, какие инструменты доступны.
3. Claude Code получает описания этих инструментов и их схемы.
4. Агент выбирает действие в рамках задачи.
5. MCP-сервер обращается к внешней системе.
6. Результат возвращается в Claude Code.

Внешней системой может быть база данных, API, браузер, трекер задач или мониторинг. Агент получает только опубликованные сервером инструменты.

Допустим, в трекере есть задача с описанием ошибки. Без MCP сценарий выглядит так: найти задачу, скопировать текст, вставить его в Claude, потом отдельно передать результат обратно. С MCP агент вызывает инструмент сервера и работает с данными напрямую.

Claude может выбрать неподходящий сервер или пропустить его. Для первой проверки лучше прямо назвать сервер в запросе. Так проще отличить реальный вызов MCP от ответа на основе уже известных данных.

## Зачем нужен MCP-сервер в обычной работе

MCP нужен, когда агенту регулярно приходится получать контекст из внешнего инструмента или выполнять там действие. Главный сигнал - повторяющийся copy-paste между сервисом и чатом.

Запрос «зачем нужен mcp сервер» лучше проверять по своей рутине и конкретной функции. Вспомни действие, которое повторяется:

- открыть трекер задач и скопировать описание issue;
- взять данные из базы;
- проверить состояние сервиса в мониторинге;
- открыть страницу в браузере;
- найти нужный фрагмент документации;
- отправить запрос в API.

С MCP я подключаю разные источники одним общим способом, вместо того чтобы настраивать отдельную интеграцию под каждый сервис.

“Connect a server when you find yourself copying data into chat from another tool, like an issue tracker or a monitoring dashboard. Once connected, Claude can read and act on that system directly instead of working from what you paste.”

Я проверяю данные в рабочей системе без ожидания подрядчика. Документация, файлы или браузер оказываются прямо в привычном диалоге.

Проверяй результат MCP. Агент получает доступ к внешнему источнику, а правильность решения зависит от его работы. Начинай с чтения данных и одного понятного действия.

Практикум по вайб-кодингу связан с той же задачей: собрать рабочую связку руками и проверить, что она делает. Там этот подход проходит на практических сценариях.  
https://vibeceh.ru/?utm_source=article&utm_campaign=mcp-podklyuchit-pervyj-instrument&utm_content=cta-mid#buy

## MCP, навык и обычный API: в чём разница

Skill задаёт инструкции, MCP подключает внешние данные, а обычный API - интерфейс конкретного сервиса.

| Характеристика | Skill | MCP | Обычный API |
|---|---|---|---|
| Что делает | Задаёт инструкции и процедуру | Подключает внешний источник данных или действий | Интерфейс конкретного сервиса |
| Вопрос | «Как выполнять процедуру» | «Где взять данные или выполнить действие» | «Какой у сервиса контракт» |
| Подключение | Файл SKILL.md | MCP-сервер (локальный или удалённый) | HTTP-эндпоинты, отдельная интеграция |

Skill отвечает на вопрос «как выполнять процедуру». Это может быть чек-лист, шаблон поведения или набор инструкций в файле `SKILL.md`.

Skills extend what Claude can do. Create a `SKILL.md` file with instructions, and Claude adds it to its toolkit.

MCP отвечает на другой вопрос: «где взять данные или выполнить действие». Он может подключить браузер, базу, файлы или внешний API.

Обычный API - интерфейс конкретного сервиса. Для прямой работы с ним разработчику обычно приходится отдельно описывать запросы, авторизацию, операции и обработку ответов.

MCP не заменяет любой API. MCP-сервер часто сам работает как адаптер над существующим API. Claude Code получает опубликованные MCP-инструменты и их схемы, а агенту достаточно работать с ними без отдельного разбора всех HTTP-эндпоинтов сервиса.

## Какие бывают MCP-серверы: примеры для первого знакомства

MCP-сервер выбирается под конкретное действие. Playwright MCP открывает браузер и проверяет страницу, Memory MCP хранит контекст между сессиями, Filesystem MCP читает файлы проекта, а Context7 подставляет актуальную документацию.

Запрос «примеры mcp серверов» можно разложить по типу работы:

- **Playwright MCP** управляет браузером. Через него Claude может открыть страницу и проверить её содержимое.
- **Memory MCP 1file** хранит локальную память. Данные остаются на машине.
- **Filesystem MCP** читает, записывает, ищет и перемещает файлы, а также показывает метаданные. Для первого опыта лучше ограничить его одним каталогом проекта.
- **Context7** подставляет в контекст актуальную документацию библиотек и фреймворков.
- **Fetch MCP** загружает веб-страницы, API-ответы и документы и преобразует их в текст.

Есть и серверы для других систем. В источниках также упоминаются GitHub, Google Workspace и SQLite, но они не подходят для самого короткого первого сценария: там появляются токены, OAuth, права доступа или дополнительные ограничения.

Не выбирай сервер по громкому названию. Сначала задай вопрос: какое действие он убирает? Если ответа нет, подключение пока не нужно.

## Как выбрать первый полезный MCP-сервер

первый сервер должен убрать конкретное повторяющееся действие и вернуть релевантный контекст. Начинай с одного сценария, а не с большого каталога.

Оценивай сервер по самому частому ручному переносу данных. Подойдут такие признаки:

1. Ты регулярно копируешь один и тот же тип информации из внешнего сервиса.
2. Источник нужен в рабочих задачах, а не только для эксперимента.
3. Результат можно проверить одним чтением или простым действием.
4. Для подключения не требуются широкие права и production-доступ.
5. У сервера понятный небольшой набор инструментов.

Хороший первый сценарий выглядит так: открыть страницу, найти нужный фрагмент, вернуть его в Claude Code. Или прочитать один каталог проекта и найти в нём файл.

Плохой старт - подключить большой сервер только потому, что в нём много функций. Большой список увеличивает объём описаний и усложняет проверку.

Начни с одного сервера под одну рабочую боль. После проверки добавляй следующий. Так проще понять, какой инструмент реально помог, а какой только занял место в контексте.

Сначала используй тестовый проект и тестовые данные. Не подключай непроверенный сервер к секретам, production-базе и широким разрешениям.

## Где найти бесплатный готовый MCP-сервер

готовые решения ищут в репозиториях и каталогах MCP-серверов. Бесплатность или публичность не доказывает безопасность конкретного сервера.

Запрос «бесплатные mcp сервера» приводит к нескольким типам источников:

- GitHub-репозитории отдельных серверов;
- подборки вроде [Awesome MCP Servers](https://mcpservers.org/ru/);
- списки бесплатных MCP-серверов;
- каталоги с группировкой по задачам.

В подборках можно найти серверы для браузера, файлов, документации, памяти и веб-страниц. Каталог показывает доступные варианты, но качество каждого сервера нужно оценивать отдельно.

Anthropic отдельно предупреждает о сторонних серверах. Удалённый сервер может изменить поведение после подключения. Локальный сервер позволяет прочитать код и закрепить версию, но проверка всё равно нужна.

“MCP servers, third-party plugins, and web search tools all feed content into the agent’s context from sources you don’t control.”

Перед подключением проверь:

- какой доступ просит сервер;
- куда он отправляет данные;
- нужен ли API-ключ;
- можно ли начать с тестовой информации;
- есть ли понятный репозиторий и инструкция.

Публичный HTTP-адрес удобен для первого теста, но сам по себе не делает сервер безопасным для любых данных. Сначала проверь read-only сценарий.

## Почему не стоит подключать сразу много MCP-инструментов

подключённые инструменты занимают [контекст](/concepts/kontekst) ещё до вызова. Большой список усложняет выбор и может уменьшить место для кода и задачи.

Claude Code может загружать полные схемы tools от настроенных серверов без выборочной фильтрации отдельных инструментов. Поэтому сервер способен занимать контекст, даже если его функции пока не использовались.

В отчёте о нескольких AWS MCP-серверах зафиксирован статический расход **18,3 тыс. [токенов](/concepts/token)**, или **9,2% [контекста](/concepts/kontekst)**. Там же указано, что такой расход уменьшал эффективное окно примерно на **4-5 тыс. строк кода**.

Ещё одно ограничение: после изменения доступности MCP-сервера требовался перезапуск сессии. Добавление посреди длинного разговора может привести к потерям.

“All configured MCP servers load their complete tool schemas into the context at session initialization, consuming tokens regardless of actual usage.”

Правило для первого подключения простое:

- один сервер;
- одна понятная зона работы;
- небольшой набор инструментов;
- один проверяемый сценарий.

Если подключил сервер и начал получать странные ответы, сначала убери лишние подключения. Не пытайся лечить кашу ещё десятью инструментами.

## Как подключить первый MCP-сервер к Claude Code

команду запускают в обычном терминале, не внутри сессии Claude Code. После добавления проверь список, статус соединения и фактический вызов инструмента. Так ты убедишься, что сервер не просто записан в конфигурации, а действительно отвечает на запросы агента. Ниже - пошаговая инструкция от открытия терминала до проверки tool call в выводе Claude Code.

Команда регистрации выполняется в терминале, а не в активном диалоге `claude`.

Это публичный HTTP-сервер документации Claude Code.

```bash
claude mcp add --transport http \
 claude-code-docs \
 https://code.claude.com/docs/mcp
```

Здесь `claude-code-docs` - имя сервера. URL указывает на MCP-эндпоинт документации.

Выполни команду в том же терминале.

```bash
claude mcp list
```

В списке должен появиться сервер `claude-code-docs`. Сохранённая запись показывает, что настройка прошла, поэтому дополнительно смотри на статус.

Ищи такой сигнал:

```text
claude-code-docs ... ✔ Connected
```

Если видишь только сообщение о добавлении записи, этого недостаточно. Нужна проверка через `claude mcp list`.

```bash
claude
```

Если Claude Code уже был открыт до изменения конфигурации, перезапусти сессию. Файл конфигурации читается при старте.

Такой запрос исключает случайный ответ без вызова MCP.

```prompt Проверка MCP-сервера
Use the claude-code-docs server to look up what MCP_TIMEOUT does.
```

В ответе ищи объяснение `MCP_TIMEOUT` и вызов инструмента с именем `claude-code-docs`.

Команда показывает подключённые серверы, их статус и доступные инструменты.

```text
/mcp
```

Если сервер есть в списке и проверочный запрос вызывает его инструмент, базовое подключение работает.

## Как понять, что Claude Code действительно видит инструмент

запись в конфигурации подтверждает только сохранение настроек. Рабочее подключение подтверждают статус `✔ Connected` и фактический tool call с именем MCP-сервера.

Проверяй два сигнала:

1. В терминале команда `claude mcp list` показывает `✔ Connected`.
2. В выводе Claude появляется вызов инструмента с именем `claude-code-docs`.

The tool call in Claude's output is labeled with the server name, which is how you confirm the answer came from the MCP server rather than Claude's built-in knowledge.

Одна запись в списке ещё не подтверждает рабочее соединение. При наличии статуса и отсутствии вызова Claude мог ответить встроенными знаниями или использовать другой инструмент.

Поэтому проверочный запрос должен прямо называть MCP-сервер. Нет гарантии, что Claude всегда сам выберет подключённый инструмент.

## Где хранится подключение и почему сервер исчезает в другом проекте

MCP-сервер добавляется на уровне `local`, `project` или `user`. От выбранного уровня зависит, в каком проекте и кому он доступен.

Официальная документация описывает три области:

- `local` - запись в `~/.claude.json` внутри текущего проекта. Доступ только текущему пользователю и только в этом проекте.
- `project` - файл `.mcp.json` в корне проекта. Настройка доступна тем, кто клонирует проект.
- `user` - верхнеуровневый ключ `mcpServers` в `~/.claude.json`. Сервер доступен текущему пользователю во всех проектах.

По умолчанию используется `local`. Поэтому сервер может работать в одном каталоге и исчезать в другом.

Для общего проекта:

```bash
claude mcp add --scope project --transport http \
  claude-code-docs https://code.claude.com/docs/mcp
```

Для всех проектов текущего пользователя:

```bash
claude mcp add --scope user --transport http \
  claude-code-docs https://code.claude.com/docs/mcp
```

Не отправляй секреты в `.mcp.json`, если файл попадёт в Git. Уровень `project` удобен для общей конфигурации, но доступы и ключи требуют отдельной проверки.

## Что делать, если MCP-сервер подключён, но не работает

проверь подключение снаружи и внутри сессии, затем переходи к ключам, URL, файлу конфигурации, способу запуска и таймауту.

Иди по порядку:

1. **Проверь список в терминале.**

   ```bash
   claude mcp list
   ```

   Убедись, что сервер есть и у него нет статуса ошибки или ожидания.

2. **Открой список внутри Claude Code.**

   ```text
   /mcp
   ```

   Команда показывает серверы, статус и доступные tools.

3. **Уточни обязательные переменные.** Если список tools пуст, сервер может требовать API-ключ или другую переменную окружения.

   ```bash
   claude mcp add --env KEY=value ...
   ```

4. **Перезапусти Claude Code после изменения `.mcp.json`.** Конфигурация читается при старте сессии. Изменение файла в уже открытом диалоге не гарантирует обновление подключения.

5. **Проверь каталог запуска.** Сервер уровня `local` должен относиться к тому же проекту, из которого запущен Claude Code.

6. **Подтверди проектный сервер.** При статусе `Pending approval` запусти Claude Code в этом проекте и подтверди подключение.

7. **Проверь URL HTTP-сервера.**

   ```bash
   curl -I https://example.com/mcp
   ```

   Замени адрес на URL подключённого сервера.

8. **Проверь stdio-сервер вручную.** Запусти команду сервера в терминале и посмотри исходную ошибку. Так можно увидеть проблему пакета, команды или доступа к файлам.

9. **Увеличь таймаут для долгого запуска.**

   ```bash
   MCP_TIMEOUT=60000 claude
   ```

10. **Проверь режим отладки при пустом списке.**

    ```bash
    claude --debug mcp
    ```

    Отладочный вывод помогает увидеть stderr сервера и причину, по которой tools не загрузились.

## Какие ошибки новичка мешают подключению MCP

чаще всего проблема связана с местом конфигурации, названием ключа, разделителем команды или текущим каталогом запуска.

Проверь типичные промахи:

- MCP не добавляется в `.claude/settings.json`. Для подключений используются `~/.claude.json` и `.mcp.json` в зависимости от scope.
- Пользовательский scope хранится в `~/.claude.json`, а не в случайном файле настроек редактора.
- В CLI забывают разделитель `--`. Он отделяет параметры Claude Code от команды и аргументов MCP-сервера.

  ```bash
  claude mcp add --transport stdio my-tool \
    -- npx -y some-mcp-server
  ```

- В JSON пишут `servers` вместо `mcpServers`.

  ```json
  {
    "mcpServers": {
      "my-tool": {}
    }
  ```

- В массиве `args` объединяют несколько аргументов в одну строку. `"mcp serve"` должно быть разделено на `"mcp"` и `"serve"`.
- Относительный путь считают от расположения `.mcp.json`. На деле он считается от каталога, из которого запущен Claude Code.

  ```json
  {
    "mcpServers": {
      "my-tool": {
        "type": "stdio",
        "command": "./tools/my-server"
      }
    }
  ```

  Такой путь заработает только при правильном каталоге запуска. Надёжнее использовать абсолютный путь или запускать Claude Code из корня проекта.

- Ждут автоматического вызова инструмента. Для проверки назови сервер в запросе и ищи tool call в выводе.

- [Model Context Protocol - Anthropic](https://docs.anthropic.com/en/docs/mcp)
- [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Connect to MCP servers](https://code.claude.com/docs/en/mcp-quickstart)
- [Extend Claude with skills](https://code.claude.com/docs/en/skills)
- [MCP connector](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector)
- [Introducing the Model Context Protocol](https://www.anthropic.com/news/model-context-protocol)
- [How we contain Claude across products](https://www.anthropic.com/engineering/how-we-contain-claude)
- [Improve Claude Code Token Management with MCP Servers](https://github.com/anthropics/claude-code/issues/7172)
- [MCP Tool Filtering](https://github.com/anthropics/claude-code/issues/7328)
- [Filesystem MCP](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)
- [Playwright MCP](https://github.com/microsoft/playwright-mcp)
- [Memory MCP 1file](https://github.com/pomazanbohdan/memory-mcp-1file)
- [Context7](https://github.com/upstash/context7)
- [Awesome MCP Servers](https://mcpservers.org/ru/)