Claude Code MCP: как подключить свои сервисы

Q: Как подключить Figma к Claude Code?

Через MCP-сервер Figma: добавляете его командой `claude mcp add` с адресом сервера, и Claude получает доступ к макету — реальным отступам, цветам и шрифтам вместо скриншота. Актуальный адрес и способ входа берите в документации Figma, они меняются.

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

Ниже: что такое MCP простыми словами, команды подключения для Claude Code, три области видимости и то, что ломается на практике. Все команды проверены по официальной документации в октябре 2026 года.

Что такое MCP простыми словами

MCP (Model Context Protocol) — общий язык, на котором нейросеть разговаривает с внешними программами. Раньше под каждую связку писали свой переходник: один код для Gmail, другой для Google Sheets, третий для GitHub. MCP убирает эту работу: сервис один раз выставляет наружу MCP-сервер, и дальше его понимает любой клиент, который знает протокол.

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

Важная деталь, которая экономит время: MCP-сервер не обязан быть «умным». Это просто программа, которая отдаёт список действий и выполняет их по запросу. Большинство готовых серверов — обёртки над обычным API сервиса.

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

Серверы бывают двух видов: локальные (запускаются на вашей машине) и удалённые (сервис держит их у себя).

Удалённый сервер по HTTP — самый частый случай у крупных сервисов:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Локальный сервер — команда, которая запускается у вас. Всё после -- это уже команда запуска:

claude mcp add airtable --env AIRTABLE_API_KEY=ВАШ_КЛЮЧ -- npx -y airtable-mcp-server

Если сервер требует токен в заголовке:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer ваш-токен"

Проверить, что получилось, и посмотреть подробности:

claude mcp list
claude mcp get notion

Удалить: claude mcp remove notion. Внутри сессии состояние серверов показывает команда /mcp — по ней видно, какие подключились, а какие отвалились.

Три области видимости: где будет жить подключение

Это то место, где чаще всего путаются, а потом не понимают, почему сервер «пропал».

local (по умолчанию) — только в текущем проекте, настройки в ~/.claude.json.
project — в файле .mcp.json в корне проекта. Этот файл уезжает в git, поэтому подключение получает вся команда.
user — во всех ваших проектах.

Задаётся флагом --scope:

claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Практическое правило: то, чем пользуетесь везде (GitHub, таблицы, календарь), ставьте в user. То, что относится к одному проекту и нужно коллегам, — в project. Токены при этом в .mcp.json не пишите, он лежит в репозитории.

Вход через OAuth вместо токенов

У многих сервисов не нужно добывать API-ключ руками — есть обычный вход в браузере:

claude mcp login sentry

Откроется страница сервиса, вы разрешаете доступ, Claude Code сохраняет токен сам. Выйти и стереть сохранённое: claude mcp logout sentry.

Если в вашей сети нужен фиксированный порт для обратного вызова, он задаётся при добавлении:

claude mcp add --transport http --callback-port 8080 my-server https://mcp.example.com/mcp

Google Sheets, Drive и почта: что это даёт на практике

Связка Claude с Google-сервисами меняет характер работы сильнее всего, потому что рабочие данные у большинства лежат именно там.

Что получается, когда Claude видит Google Sheets и Google Drive напрямую: он сам открывает таблицу, дописывает строки, форматирует, собирает сводный лист из нескольких, достаёт документ из папки и отвечает по нему. Вы перестаёте быть курьером, который копирует данные из одного окна в другое.

Мы так ведём базы контактов для рассылок и клиентские презентации: Claude дописывает строки в таблицу и помечает статусы, а не отдаёт текст, который потом переносят руками.

n8n MCP: когда нужны и сценарии, и нейросеть

n8n mcp — частый запрос, и за ним прячется путаница. Разведём.

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

MCP — это доступ к сервису для нейросети, которая решает по ходу дела, что сделать.

Вместе они работают так: n8n держит MCP-сервер, и тогда нейросеть может запускать ваши готовые сценарии как инструменты. В поиске эту связку ищут в обе стороны, «n8n mcp» и «mcp n8n», и имеют в виду обычно именно её. Или наоборот — внутри n8n стоит нода n8n ai agent, и агент внутри сценария пользуется MCP-серверами. Что из этого выбрать, зависит от того, где нужна жёсткая логика, а где рассуждение. Подробнее про границу между подходами — в разборе n8n и ИИ-агентов.

Figma MCP в Claude Code: макет вместо скриншота

figma mcp claude code — запрос новый и растёт быстро, потому что закрывает настоящую боль вёрстки. Без MCP вы кидаете нейросети скриншот макета, и она угадывает отступы и цвета по картинке. С Figma MCP Claude читает сам макет: настоящие значения отступов, названия цветов, размеры шрифтов, структуру слоёв.

Разница видна сразу: вместо «примерно похоже на макет» получается вёрстка с теми числами, которые в макете и стоят. Как добиться приличного результата в остальном, разобрали в скиллах Claude для дизайна.

Что ломается на практике

Четыре вещи, на которых мы потеряли время. Ни одна из них не пишется в документации.

Версии протокола не совпадают. Клиент может требовать одну версию MCP, а сервер отдавать другую — и подключение просто не поднимается, без внятной ошибки. У нас так вышло с сервером Google Workspace: пришлось поставить между ними тонкую прослойку, которая переводит версию. Если сервер «не видно» без причины, смотрите в первую очередь на версию протокола.

После правки настроек нужен перезапуск. Список серверов читается на старте. Поменяли конфиг в открытом окне — Claude об этом не знает.

Токен в репозитории. .mcp.json уезжает в git вместе с проектом. Ключи там держать нельзя: либо переменные окружения, либо вход через OAuth.

Лишние серверы мешают выбирать. Чем больше подключено, тем больше у Claude похожих инструментов и тем чаще он берёт не тот. Держите подключённым то, чем пользуетесь.

И отдельно про безопасность: MCP-сервер работает с вашими правами и видит те данные, к которым вы его пустили. Ставьте серверы известных авторов, а незнакомый сначала откройте и посмотрите, куда он обращается.

Где брать готовые MCP-серверы

modelcontextprotocol.io — описание протокола и каталог;
у самого сервиса в документации — крупные платформы держат свои MCP-серверы и дают готовую строку подключения;
mcp-builder из набора примеров Anthropic — если нужного сервера нет, он помогает собрать свой под ваш API. Пригодится и тогда, когда вы строите на Claude API свой продукт и хотите дать ему те же инструменты. Ставится вместе с набором: /plugin marketplace add anthropics/skills, затем /plugin install example-skills@anthropic-agent-skills.

MCP даёт Claude доступ, а работать по вашим правилам его учат скиллы — полный список скиллов Claude Code с командами установки собран отдельно. Если вы ещё не ставили Claude Code, начните с установки скиллов Claude.

Частые вопросы

Что такое MCP? Model Context Protocol — общий протокол, по которому нейросеть подключается к внешним сервисам: таблицам, почте, GitHub, CRM. Один раз реализованный сервер понимают все клиенты, которые знают протокол, поэтому под каждую связку больше не нужен свой переходник.

Зачем MCP в Claude Code? Чтобы Claude работал с вашими настоящими данными, а не с тем, что вы ему скопировали в окно. С MCP он сам открывает таблицу, читает документ, создаёт задачу и делает коммит. Без MCP он может только посоветовать, как это сделать вам.

Как подключить Figma к Claude Code? Через MCP-сервер Figma: добавляете его командой claude mcp add с адресом сервера, и Claude получает доступ к макету — реальным отступам, цветам и шрифтам вместо скриншота. Актуальный адрес и способ входа берите в документации Figma, они меняются.

Чем MCP отличается от скилла? MCP даёт доступ, скилл задаёт порядок работы. MCP открывает таблицу, скилл говорит, как её заполнять. Обычно нужны оба.

Нужен ли программист, чтобы подключить MCP? Для готового сервера нет — это одна команда в терминале. Программист нужен, если своего MCP-сервера для вашей системы не существует и его надо написать.

Сколько MCP-серверов можно подключить? Технически много, практически — столько, сколько реально используете. Каждый сервер добавляет Claude список инструментов, и при десятках похожих инструментов он начинает выбирать не тот.

Пара серверов по этой инструкции ставится за вечер. Сложное начинается дальше: выдать доступы нескольким сотрудникам, не открыв лишнего, и не сломать всё на ближайшем обновлении. Это уже наша работа — опишите задачу, цену назовём до старта. Что входит в работу — на странице ИИ-агент для бизнеса под ключ.