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

Вы прочитали, что нейросеть может сама искать документы на диске или карточки клиентов в вашей CRM, и решили попробовать. Дальше обычно встают вопросы, как подключить MCP-сервер: куда его вписать, какую команду набрать и как понять, что всё заработало.

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

Что понадобится

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

• клиент, программа с нейросетью, которая пользуется сервером: Claude Code, приложение Claude, n8n;
• сервер, который даёт доступ к вашим файлам, CRM или сервису.

Сами серверы бывают двух видов, и подключаются они по-разному:

Что такое MCP и зачем он бизнесу, объяснено в статье MCP-сервер простыми словами. Здесь только подключение.

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

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

Шаг 1. Установите Node.js

Многие локальные серверы запускает бесплатная программа Node.js: скачайте её с официального сайта nodejs.org и установите как обычную программу.

Затем откройте терминал, окно для текстовых команд. В VS Code это меню Terminal, пункт New Terminal. Проверьте установку:

bash npx --version

Если в ответ пришёл номер версии, всё готово.

Шаг 2. Добавьте сервер

Откройте терминал в папке, где вы работаете с Claude Code, и выполните команду. Последней частью укажите полный путь к папке, к которой даёте доступ:

bash claude mcp add files -- npx -y @modelcontextprotocol/server-filesystem /Users/anna/Documents/kofeynya

Здесь files это имя сервера, его вы придумываете сами. Всё после двух дефисов это команда, которой Claude Code будет запускать сервер. Claude Code ответит строкой «Added stdio MCP server files…».

Шаг 3. Проверьте подключение

bash claude mcp list

Напротив сервера должна стоять отметка «✔ Connected». Если там «Failed to connect», смотрите таблицу ошибок в конце статьи.

Шаг 4. Дайте задачу

Запустите Claude Code и спросите о чём-то, что есть только в папке. Мы положили в неё прайс и спросили: «Сколько стоит торт Медовик? Посмотри в файлах через MCP-сервер files». Claude открыл файл и ответил: «Торт Медовик стоит 1900 ₽ за 1 кг, по данным файла docs/prices.txt».

Когда Claude первый раз захочет воспользоваться сервером, он спросит разрешения. Можно разрешить действие один раз или сказать, чтобы больше не спрашивал.

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

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

bash claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp

Слова --transport http говорят, что сервер работает по адресу. После этого claude mcp list показал «✔ Connected», и Claude через этот сервер перечислил разделы документации n8n.

Если сервис выдал вам ключ доступа, по документации Claude Code его передают отдельной частью команды:

bash claude mcp add --transport http crm https://адрес-сервера/mcp --header "Authorization: Bearer ваш-ключ"

Ключ сохранится в настройках на вашем компьютере. Не вставляйте его в тексты задач и в файлы, которые отправляете коллегам.

Где Claude Code хранит настройку

По умолчанию сервер подключается только для той папки, где вы выполнили команду. Мы проверили: в другой папке claude mcp list этот сервер уже не показывает. Это удобно, но часто сбивает с толку.

У третьего варианта есть особенность. Сервер из файла .mcp.json не запускается сам: Claude Code показывает «Pending approval» и ждёт, пока вы одобрите его при запуске. Так Claude защищает вас от сервера, который мог подложить кто-то другой.

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

В n8n для MCP есть два блока с одинаковыми настройками:

• MCP Client вызывает одно действие сервера как обычный шаг схемы;
• MCP Client Tool подключается к блоку AI Agent, и тогда агент сам решает, когда воспользоваться сервером.

Блок MCP Client мы проверили на том же сервере DeepWiki. Настройка выглядит так:

1. Добавьте в схему блок MCP Client.
2. В поле Server Transport выберите HTTP Streamable: так работает большинство новых серверов.
3. В поле Endpoint URL вставьте адрес сервера, у нас это https://mcp.deepwiki.com/mcp.
4. В поле Authentication оставьте None, если сервер не требует ключа, или выберите Bearer Auth и создайте учётные данные с ключом.
5. В поле Tool выберите действие сервера, а в параметрах впишите, что ему передать.

Мы выбрали действие read_wiki_structure и передали название проекта n8n-io/n8n. Блок вернул список разделов документации. Значит, связь работает, и тот же адрес можно подключать к агенту через MCP Client Tool.

Как устроены схемы и блоки, показано в руководстве n8n на русском. В n8n агент может работать на российской нейросети, поэтому этот путь подходит и тем, кому Claude недоступен.

Как подключить MCP в приложении Claude

В приложении Claude для компьютера и в веб-версии серверы подключают без команд, через раздел настроек «Коннекторы» (Connectors). Это самый простой путь для почты, календаря и облачных дисков, он описан в статье про MCP простыми словами.

Если не работает

Начинайте с серверов, которые только читают данные, и давайте доступ к одной папке, а не ко всему диску. Какие серверы стоит подключить первыми, собрано в подборке лучших MCP-серверов. Если нужного сервера нет, его можно написать самому: пример есть в инструкции как создать MCP-сервер.