Сервер MCP — это внешняя программа со своим адресом, к которой Claude Code подключается, чтобы работать с тем, чего у него самого нет: со справочником, с данными, со сторонним сервисом. Подключение занимает одну команду в терминале, а дальше всё решает область видимости: от неё зависит, в каких проектах сервер работает и увидят ли его коллеги. Здесь разобрано, как сервер добавляют, где хранится запись о нём, как её посмотреть и убрать и в каких задачах вместо сервера подходит навык.
Как подключить сервер MCP
Сам протокол Anthropic описывает на справочной странице Connect Claude Code to tools via MCP первой же фразой: «Claude Code can connect to hundreds of external tools and data sources through the Model Context Protocol (MCP), an open source standard for AI-tool integrations». Перевод наш: «Claude Code может подключаться к сотням внешних инструментов и источников данных через Model Context Protocol (MCP) — открытый стандарт для связи инструментов с ИИ».
Подключение состоит из одной команды. На странице «Подключение к серверам MCP» Anthropic показывает её на примере собственного справочника:
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
Команда читается слева направо, и в английской версии той же страницы, Connect to MCP servers, каждая часть разобрана отдельно. Про ключ транспорта сказано: «--transport http: the server is hosted at a URL rather than run as a local process». Перевод наш: «--transport http — сервер размещён по адресу, а не запускается как местный процесс». Про имя сказано: «claude-code-docs: a name you make up». Перевод наш: «claude-code-docs — имя, которое вы придумываете сами». Последним стоит адрес сервера, к которому Claude Code будет обращаться.
Проверяют соединение прямо в разговоре. Команда /mcp, набранная в Claude Code, показывает серверы, с которыми он сейчас соединён. Добавленный сервер в этом перечне есть — команда сделала своё дело, и агент может обращаться к серверу в этом же разговоре.
Где хранится запись и кому сервер виден
Команда добавления записывает сервер в файл настроек. Какой именно это файл, решает область видимости — круг проектов и людей, для которых запись действует. Область назначают тем же вызовом claude mcp add, ключом --scope.
По умолчанию сервер попадает в область local. Anthropic поясняет, что это значит, прямо по ответу команды: «The local config part means the server is registered to you, in this project: if you start Claude Code in a different project, this server isn’t active there». Перевод наш: «Слова local config означают, что сервер записан на вас и на этот проект: если запустить Claude Code в другом проекте, там этот сервер не работает».
Ключ --scope user поднимает запись на уровень вашего пользователя. Сервер, добавленный так, работает сразу во всех ваших проектах, и повторять команду в каждом новом каталоге не нужно. Видимость при этом остаётся личной: у коллеги такой сервер не появится.
Ключ --scope project делает запись общей с командой. Файл с ней Anthropic советует положить в систему контроля версий: «Check .mcp.json into version control so everyone on your team gets the same MCP tools and services». Перевод наш: «Закоммитьте .mcp.json в систему контроля версий, чтобы все в вашей команде получили одни и те же инструменты и службы MCP». У тех, кто склонирует репозиторий, сервер подключается после подтверждения: Claude Code показывает запрос, и только потом соединяется.
Как поменять область
Область назначается один раз — в момент добавления, и на месте она не правится. Anthropic говорит об этом одной фразой: «A server’s scope is fixed when you add it, so changing scope means removing the entry and re-adding it at the new one». Перевод наш: «Область сервера закрепляется в момент добавления, поэтому смена области означает удаление записи и повторное добавление в новой области».
Смена области идёт в два шага. Сначала запись убирают из той области, где она сейчас: claude mcp remove <имя> --scope local. Затем сервер добавляют заново — тем же claude mcp add, но уже с нужным ключом, --scope user или --scope project. Имя и адрес при этом берут прежние, иначе в настройках появится второй сервер вместо переехавшего.
Такой порядок стоит держать в голове с самого начала. Когда сервер заводят для всей команды, ключ --scope project проще указать сразу, чем потом удалять запись и повторять подключение на каждой машине.
Как посмотреть и убрать сервер
Перечень подключённых серверов выводит команда claude mcp list. Она отвечает на первый вопрос, который возникает после недели работы: что вообще подключено и под какими именами.
Подробности об одном сервере показывает claude mcp get <имя>. По её ответу видно, что записано под этим именем — адрес, транспорт, область, — и с этого начинают разбор любого странного поведения.
Убирает сервер команда claude mcp remove <имя>. Область при удалении называют ключом --scope, как в примере выше: удаление работает внутри одной области, и запись из другой останется на месте. Все три команды набирают в терминале, рядом с claude mcp add; внутри разговора для быстрой сверки остаётся /mcp. Остальные команды сеанса — очистка разговора, сжатие истории, смена режима разрешений — перечислены в статье о повседневной работе с Claude Code.
Когда один и тот же сервер описан сразу в нескольких местах, старшинство задано порядком: сначала local, затем project, затем user, затем серверы от плагинов и подключения из claude.ai. Claude Code соединяется с сервером один раз, беря описание из источника с наибольшим старшинством.
Сервер или навык: что когда
Сервер и навык закрывают разные нужды, и в сводной таблице способов расширения на странице Extend Claude Code это записано двумя строками. Про навык: «Instructions, knowledge, and workflows Claude can use». Перевод наш: «Указания, знание и порядки работы, которыми Claude может пользоваться». Про MCP в графе «когда брать»: «External data or actions». Перевод наш: «Внешние данные или действия».
Признак, по которому заводят сервер, назван там же в перечне поводов: «You keep copying data from a browser tab Claude can’t see → Connect that system as an MCP server». Перевод наш: «Вы снова и снова копируете данные из вкладки браузера, которую Claude не видит → подключите эту систему сервером MCP».
Документация Anthropic, из которой взяты цитаты выше, снята 15 сентября 2026 года.
Отсюда и выбор между ними. Задача, где нужно дотянуться до внешней системы с её собственным доступом, ложится на сервер. Задача, где агент уже умеет всё нужное, но каждый раз приходится заново объяснять ему порядок работы, ложится на навык. Устройство навыка со всеми полями файла разобрано в отдельной статье — про skills для Claude Code. Кому Claude Code отдаёт работу — отдельному помощнику внутри разговора или своей же основе без командной строки — разобрано в статье про агентов Claude Code.
Внешняя система при этом не всегда подключается сервером. Работа с репозиторием на GitHub у Claude Code держится на приложении и файле рабочего процесса, и команда claude mcp add в ней не участвует вовсе; как это устроено и что агент делает с обсуждениями и запросами на слияние, разобрано в статье Claude Code и GitHub.
GEN202 даёт агенту навык: его подключают обычной просьбой словами, а её текст целиком приведён на странице генерации изображений из Claude Code.
Как это выглядит на живом подключении
Что меняет сервер в повседневной работе, видно по разбору практика. В статье «MCP-серверы для Claude Code: как подключить Telegram, базы данных и всё что угодно» от 5 июня 2026 года автор под именем opium описывает исходное положение так: «Без MCP Claude Code видит только то, что ты явно ему показал: файлы в проекте, то что написал в чате».
Про запуск серверов он пишет: «Claude Code читает .mcp.json при старте и поднимает серверы автоматически». Проверку автор сводит к одной команде: «claude mcp list. Должен появиться telegram в списке. Если появился — всё работает». Сам разбор построен на подключении Telegram: сервер на библиотеке Telethon, строка сеанса в переменных окружения и четыре шага от установки зависимостей до проверки.
Порядок из этого разбора совпадает с документацией и добавляет к ней одну привычку. Проверять подключение стоит сразу после команды добавления, не откладывая до первой настоящей задачи: claude mcp list отвечает на это за секунду.
Картинки в проекте
Изображения нужны почти любому проекту: кадр для README, картинка на лендинг, снимок для карточки товара. Claude Code читает код и правит файлы, а само изображение создаёт отдельная модель — и это как раз та задача, под которую агенту добавляют умение со стороны.
Подключение занимает одну фразу. Вы даёте её агенту, он открывает описание навыка — страницу с порядком вызовов GEN202 API — и настраивает обращения у себя. Ключ агент берёт из переменной окружения GEN202_KEY; когда переменной нет, он проводит вас по подключению по тому же описанию.
Дальше агент работает сам. По описанию словами он создаёт новое изображение, переделывает то, которое вы ему прислали, подбирает разрешение и форму кадра под место, где картинка встанет, и отдаёт готовый файл ссылкой. Ссылка действует четырнадцать суток — за этот срок файл переносят в проект.
Работу выполняют модели Nano Banana 2, Nano Banana Pro, GPT Image 2 и Grok Imagine Image 2.0, а какую взять, агент решает по задаче, которую вы назвали. Стоимость картинки складывается из выбранной модели и разрешения: в невысоком разрешении на Nano Banana 2 она выходит в 7,2 ₽, ставки остальных моделей собраны в таблице на странице генерации изображений из Claude Code.
Частые вопросы
Чем сервер MCP отличается от навыка?
Сервер MCP — это внешняя программа со своим адресом, которую подключают командой claude mcp add; запись о подключении хранится в файле настроек, и у неё есть область видимости. Навык устроен проще: это каталог с текстовыми указаниями внутри проекта или домашнего каталога, команда подключения ему не нужна, а Claude обращается к нему сам, когда речь зашла про его тему. Разница по смыслу такая же, как по устройству: сервер отвечает за доступ к чужой системе, навык — за умение и порядок работы. Устройство навыка подробно разобрано в статье про skills для Claude Code.
Виден ли сервер команде?
Видимость целиком задаёт область, выбранная при добавлении. Запись в области project общая с командой: она попадает в файл .mcp.json в корне проекта, и её коммитят вместе с кодом. Запись в области user остаётся вашей, но действует во всех ваших проектах, а хранится в домашнем файле ~/.claude.json. Область local, которая ставится по умолчанию, ограничена вами и текущим проектом, поэтому сервер, добавленный без ключа --scope, коллеге не достанется. Посмотреть, какая область у конкретного сервера, помогает команда claude mcp get <имя>.
Что делать, если сервер не отвечает?
Начните с проверки, видит ли Claude Code сервер вообще: команда /mcp показывает подключённое внутри разговора, а claude mcp list — записи в терминале. Пустой ответ при том, что сервер добавляли, чаще всего означает область: запись в local действует только в том проекте, где её сделали, и в соседнем каталоге её нет. Дальше смотрят саму запись командой claude mcp get <имя> и сверяют адрес и транспорт с тем, что указано в документации сервера. Когда в записи нашлась ошибка, сервер удаляют командой claude mcp remove <имя> --scope local и добавляют заново. Разбор подключения Anthropic держит на странице «Подключение к серверам MCP».
Нужен ли сервер MCP, чтобы получать картинки? Картинки от GEN202 приходят через навык. Вы даёте агенту одну фразу, он читает описание навыка, настраивает вызовы GEN202 API и дальше рисует изображение по описанию, переделывает присланное и приносит готовый файл по ссылке. Фраза подключения и таблица цен с моделями собраны на странице генерации изображений из Claude Code.