Как дать агенту в n8n доступ к вебу: нода MCP Client за 10 минут

Агент в n8n умеет рассуждать, но не умеет смотреть в интернет. Одна нода закрывает этот пробел: агент получает поиск, чтение страниц и извлечение данных как встроенные инструменты и сам решает, когда ими воспользоваться.

В n8n есть AI Agent, к нему подключаются инструменты. Проблема в том, что модель знает мир на момент обучения: спросите её о вчерашней новости, цене в магазине или текущей версии библиотеки - она либо признается, либо уверенно придумает. Дальше два пути: собирать интеграции руками через HTTP Request под каждый источник, либо подключить один MCP-сервер и получить набор инструментов сразу.

#Что такое MCP и почему это удобнее HTTP Request

MCP (Model Context Protocol) - открытый стандарт, по которому агент узнаёт у сервера, какие инструменты есть, какие у них параметры и что они возвращают. Ключевая разница с обычным REST-вызовом в том, кто принимает решение.

• HTTP Request вызываете вы. Вы заранее описали, что запросить и в какой момент воркфлоу.
• MCP-инструмент вызывает агент. Он видит описание инструмента и сам понимает, что для ответа нужно сходить в веб - иногда дважды, иногда с уточнённым запросом.

Второе следствие приятнее: описания и параметры инструментов агент запрашивает у сервера в момент подключения. Появился новый инструмент - он появится у агента без правки воркфлоу.

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

1. n8n версии 1.80 или новее - в ней нода MCP Client Tool уже входит в стандартный набор.
2. Готовый AI Agent в воркфлоу с подключённой моделью.
3. API-ключ вида srz_live_… из личного кабинета, раздел «API-ключи».

#Настройка ноды

#Шаг 1. Добавить ноду к агенту

На канвасе под нодой AI Agent есть коннектор Tool. Нажмите плюс рядом с ним и выберите MCP Client Tool. Важно добавлять её именно через этот коннектор: если поставить ноду в основную цепочку, агент её не увидит - она станет обычным шагом воркфлоу.

#Шаг 2. Указать адрес сервера

В поле Endpoint URL вставьте адрес MCP-сервера:

https://srezai.ru/api/mcp

Адрес один на все инструменты - отдельных эндпоинтов под поиск и чтение нет.

#Шаг 3. Авторизация

Здесь чаще всего спотыкаются. Настройки такие:

Слово Bearer нода подставляет сама. Если написать его в поле руками, в заголовок уедет Bearer Bearer srz_live_… и сервер ответит отказом.

#Шаг 4. Выбрать инструменты

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

#Какие инструменты появятся у агента

Кредит равен 10 копейкам. Типичный вызов агента - поиск плюс два-три чтения страниц, то есть 3-4 кредита, около 40 копеек. get_usage бесплатный и квоту не расходует специально: агент может спросить остаток, даже упёршись в лимит.

#Проверка без n8n

Если нода не подтянула список инструментов, полезно отделить проблему воркфлоу от проблемы доступа. Метод tools/list по JSON-RPC отвечает и без ключа:

curl -X POST https://srezai.ru/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Заголовок Accept обязателен: сервер отвечает потоком text/event-stream, и без него запрос будет отклонён. Пришёл список инструментов - сервер и сеть в порядке, разбираться нужно с ключом или с самой нодой.

#Когда нода падает

#«Could not connect to your MCP server. Authentication failed.»

Формулировка сбивает с толку. Это не проблема транспорта или сети - это ровно HTTP 401 от сервера, который n8n показывает своим текстом. Причин ровно три, и только первая означает «неверный ключ»:

• ключ отозван или скопирован с опечаткой;
• у ключа истёк срок действия;
• исчерпан собственный лимит запросов ключа.

Быстрый способ различить: список инструментов подтягивается, а вызов падает. Методы initialize и tools/list у нас открыты без ключа, чтобы каталоги MCP-серверов могли прочитать описания, а tools/call - нет. Значит проблема гарантированно в ключе.

#«MCP client: Failed to connect to MCP Server»

Эта строка в логах пугает напрасно: n8n пишет её и при обычной отмене исполнения. Прежде чем искать поломку, посмотрите статус исполнения - если он canceled, никакой ошибки не было.

#Что дальше

Проверить связку проще всего вопросом, ответ на который модель знать не может: «что писали на этой неделе про MCP в n8n?». Агент, у которого нет инструментов, честно скажет, что не знает. Агент с подключённым поиском сходит в веб и вернёт ссылки - в логе исполнения будет видно, какие инструменты он вызвал и с какими параметрами.

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

Отдельный совет по гигиене: выдайте воркфлоу собственный ключ с лимитом запросов вместо основного. Агент в цикле может вызвать инструмент десятки раз за исполнение, и лимит на ключе - самая простая страховка от неожиданного расхода. Заодно по счётчику ключа сразу видно, сколько запросов делает именно этот воркфлоу.