3SELLER Journal 3SELLER →

Как подключить MCP к Claude: 5 команд и 10 минут на настройку

13.10.2026

Что такое MCP и зачем он нужен

MCP (Model Context Protocol) это открытый протокол, который позволяет Claude подключаться к внешним инструментам и данным. Если коротко, через MCP нейросеть получает доступ к файлам, базам данных, браузеру, API и куче других вещей, которые в обычном диалоге ей недоступны.

Без MCP Claude работает только с текстом, который вы вводите в чат. Он не умеет читать локальные файлы, открывать сайты или выполнять запросы в базу данных. С MCP это меняется радикально: нейросеть может прочитать проект, изменить файл, запустить тест и показать результат. Разница такая же, как между калькулятором и компьютером.

Два типа MCP-серверов

Есть два способа подключить MCP: удалённый и локальный. Удалённые серверы работают по HTTP, их можно подключить из интерфейса Claude Desktop. Локальные запускаются на вашей машине через терминал и общаются с Claude Code по протоколу stdio. Первые проще в настройке, вторые дают полный контроль над данными.

К удалённым относится, например, Context7. Это агрегатор документации по разным технологиям. Вы просто вставляете URL в настройках Desktop, и Claude получает доступ к свежим докам. Ничего устанавливать не нужно.

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

Подключение MCP к Claude Desktop

Разберёмся с десктопной версией. Это самый простой способ, если вы хотите подключить удалённый MCP-сервер. Откройте приложение Claude, в левом сайдбаре нажмите Customize. Дальше переходите в Connectors, жмёте Add и выбираете Add custom connector.

В появившемся окне вставляете URL сервера. Например, для Context7 это готовый URL, который можно найти на их сайте. После добавления коннектор появится в списке, и вы сможете использовать его в чатах. Если авторизация прошла успешно, нажмите Configure, чтобы выбрать доступные инструменты и настроить права.

Но большинство MCP-серверов, которые реально требуются разработчикам, живут локально на вашей машине. Для них интерфейс Desktop не подходит, здесь нужен Claude Code.

Подключение MCP к Claude Code через терминал

Claude Code это инструмент для работы в терминале. Он наследует те же коннекторы, что и Desktop, но добавляет возможность запускать локальные MCP-серверы через команду `claude mcp add`. Синтаксис простой: вы указываете имя сервера, область видимости (-s user или -s project) и команду запуска.

Самый популярный пример - доступ к файловой системе. Выполните в терминале:

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Desktop

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

claude mcp list

Она покажет все активные MCP-серверы с их статусом и количеством инструментов.

На Windows иногда возникает ошибка при вызове `claude` в терминале. Если видите что-то в духе "command not found" или проблему с Node.js, замените `claude` на `claude.cmd`: 

claude.cmd mcp add -s user filesystem -- npx -y @modelcontextprotocol/server-filesystem "D:/Obsidian/Obsidian"

Кавычки здесь обязательны, если в пути есть пробелы.

Разбираем команду claude mcp add

Когда вы пишете `claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents`, происходит вот что:

`filesystem` это имя сервера, под которым он появится в списке. Оно может быть любым, но лучше выбирать осмысленное. `-s user` определяет область видимости: `user` значит сервер будет доступен во всех ваших проектах, `project` только в текущем. Дальше идёт двойное тире `--`, после которого начинается команда запуска. В данном случае это `npx -y @modelcontextprotocol/server-filesystem ~/Documents`. Утилита npx скачает и запустит MCP-сервер, а путь к папке будет аргументом.

Обратите внимание: команда запуска может быть любой. Вы можете передавать переменные окружения через `-e`. Например, для PostgreSQL: `claude mcp add postgres -s user -e DATABASE_URL=your-db-url -- npx -y @modelcontextprotocol/server-postgres`.

Если вы работаете в команде, удобно хранить конфигурацию прямо в проекте. Создайте файл `.mcp.json` в корне репозитория и пропишите там нужные серверы. Тогда все участники получат одинаковый набор инструментов, просто склонировав код.

Готовые MCP-серверы для разных задач

Когда разберётесь с базовой настройкой, захочется расширить возможности. Вот подборка из тех, что я использую сам чаще всего.

Ставить всё сразу не нужно. На Reddit практикующие разработчики сходятся во мнении: начинать стоит с Context7 и Filesystem, а дальше уже по задачам. Важно помнить: MCP-серверы получают доступ к вашим данным, поэтому не подключайте незнакомые инструменты, если не понимаете, что они делают.

Диагностика и решение проблем

MCP-серверы иногда капризничают. Особенно на старте. Первым делом проверьте список подключённых серверов через `claude mcp list`. Если сервер в списке, но не отвечает, загляните в логи.

На macOS и Linux логи живут в файле `~/Library/Logs/Claude/mcp.log`. Посмотреть последние записи можно командой:

tail -f ~/Library/Logs/Claude/mcp.log

На Windows путь другой: `%APPDATA%\Claude\logs\mcp.log`. Чтобы открыть его, выполните:

type "%APPDATA%\Claude\logs\mcp.log"

Команда `/mcp` прямо в Claude Code тоже пригодится. Она выводит список серверов и позволяет перезапускать проблемные.

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

npx -y @modelcontextprotocol/server-filesystem ~/Documents

Так вы увидите, есть ли ошибки в самом сервере, или проблема в интеграции. Чаще всего проблема в Node.js: он либо не в PATH, либо слишком старый. Этот нюанс часто всплывает в обсуждениях на Reddit. Обновите Node и повторите попытку.

Доступ к Claude из России: рабочий лайфхак

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

Есть сервис, который решает эту задачу раз и навсегда. Называется 3GPT от 3SELLER. Это ИИ-роутер, который даёт доступ из России ко всем флагманским моделям нейросетей. Цена вопроса 149 рублей. Никаких иностранных карт, оплата российской картой, СБП или криптой.

Какие модели доступны:

И много других. Полный список смотрите на официальном сайте: https://3seller.com/3gpt. Пополнить баланс можно российской картой, через СБП или криптой.

3GPT закрывает повседневные задачи в бизнесе и работе: создавайте продающие тексты, сайты, любые тексты. Вот пример генерации изображений:

Пример изображений, созданных через 3GPT

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

Кроме того, у 3GPT есть фишка, которой я не видел у конкурентов: готовые ИИ-агенты под разные задачи. Выбираете агента, начинаете с ним общение, и модель можно менять прямо в чате. Удобно, когда под рукой нет нужного промпта.

Готовые ИИ-агенты в 3GPT

Подробнее про агентов смотрите здесь. А доступ ко всем флагманским моделям нейросетей из России оформляется на официальном сайте 3GPT: https://3seller.com/3gpt.

Что в итоге

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

И не забывайте про легальный доступ в Россию. Сервис 3GPT реально работает, и за 149 рублей вы получаете все флагманские нейросети без боли с иностранными картами. Особенно удобно, что оплата идёт через СБП или крипту.

Начните с двух серверов - filesystem и Context7, и вы почувствуете разницу в первую же минуту. А если география мешает доступу к Claude, 3GPT снимет этот барьер за 149 рублей.

← Вернуться к блогу

Читать дальше