---
title: "MCP-серверы для AI-агентов"
description: "MCP-серверы для AI-агентов. Примеры подключения и настройки. Документация и инструкции по работе с облачными сервисами Timeweb Cloud."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

MCP (Model Context Protocol) — это протокол, который позволяет AI-агенту работать не только с собственными знаниями, но и с внешними инструментами. Например, с его помощью агент может выполнять поиск в интернете, работать с документацией, подключаться к сервисам вроде Notion или управлять браузером и использовать полученные результаты при формировании ответа пользователю.

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

#### Как AI-агент узнает, какие инструменты доступны

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

На этом этапе формируется контракт между агентом и MCP-сервером. Агент понимает, какие действия ему доступны, и может выбирать, какой инструмент использовать в той или иной ситуации.

![2](https://content.timeweb.com/assets/23b3f84f-b776-4b04-a0a5-1b241a0ad046.png?width=1920&height=927)

Этот список инструментов можно получить и вручную — обычным HTTP-запросом. Например, у MCP-сервера exa search, который предоставляет AI-агенту доступ к поиску в интернете, можно запросить список инструментов так:

```bash
curl -s https://mcp.exa.ai/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }' \
| sed -n 's/^data: //p' \
| jq
```

В ответ сервер вернет список инструментов. В нем можно увидеть, какие функции доступны, для чего они предназначены и какие параметры ожидают. Например, один инструмент отвечает за поиск по интернету, другой — за исследование компаний, третий — за поиск кода и документации. Для каждого инструмента явно описано, какие данные нужно передать на вход.

Важно, что AI-агент не «угадывает» эти параметры и не придумывает формат запроса. Он работает строго по описанию, которое получил от MCP-сервера.

#### Как выглядит работа с MCP при запросе пользователя

После подключения и получения списка инструментов AI-агент «держит в голове», какие инструменты ему доступны и в каких случаях их можно использовать.

Пользователь задает вопрос AI-агенту. Если агент может ответить на него сразу — он просто формирует ответ. Но если информации не хватает, агент понимает, что ему нужно воспользоваться внешним инструментом, и формирует запрос к MCP-серверу.

> [!NOTE]
> Можно явно указать агенту использовать инструменты. Например, при подключении Context7 в конце промпта можно написать: «Используй Context7», — и агент будет использовать инструменты этого MCP-сервера, а не придумывать информацию.

Рассмотрим взаимодействие с MCP-сервером на примере exa search. Пользователь задает вопрос AI-агенту. Если агент понимает, что не может ответить сразу — например, потому что ему не хватает актуальной информации, — он решает обратиться к инструменту поиска и формирует запрос к MCP-серверу. MCP-сервер выполняет функцию поиска в exa search и возвращает AI-агенту структурированный результат. Дальше агент читает найденное, выбирает главное и уже на основе этих данных формирует ответ пользователю.

![1](https://content.timeweb.com/assets/6e1ff26a-544c-4b08-861d-1ecedff56f97.png?width=1920&height=927)

MCP-сервер не отвечает пользователю напрямую и не принимает решений. Он выполняет конкретные функции и возвращает результат. Вся логика, интерпретация данных и генерация ответа остается на стороне AI-агента.

## Настройка подключения

Вы можете подключить MCP-сервер вручную по этой инструкции или воспользоваться [галереей MCP-серверов](https://timeweb.cloud/docs/ai-agents/mcp-server#galereya-mcp-serverov), если в ней есть нужный вам сервер.

MCP-серверы бывают двух типов: stdio и Streamable HTTP. Условно их можно разделить на локальные (stdio) и удаленные (Streamable HTTP).

Подключать к агентам можно только удаленные серверы — Streamable HTTP.

Чтобы добавить новое подключение:

1.  Перейдите во вкладку «MCP-серверы» в разделе «AI-агенты».
    
2.  Нажмите кнопку «Создать» или «Добавить».
    

![Scr 20260210 Koqx](https://content.timeweb.com/assets/4ed5644c-7b06-45e8-890c-fd181a26e40e.png?width=2080&height=1486)

3.  Заполните поля:
    

-   Название — произвольное имя подключения;
    
-   Комментарий — необязательное поле;
    
-   Адрес сервера — URL, по которому доступен MCP-сервер;
    
-   Протокол — HTTP или SSE;
    
-   Авторизация — выберите способ аутентификации:
    

-   Bearer-токен;
    
-   OAuth 2.0;
    
-   Кастомные заголовки;
    
-   Без авторизации.
    

5.  Нажмите «Добавить сервер».
    

![Scr 20260210 Kpbp](https://content.timeweb.com/assets/b8eadd6f-8431-4135-bd54-f39e0d180ced.png?width=2508&height=1464)

После этого новое подключение появится в списке инструментов.

## Галерея MCP-серверов

В панели управления доступны готовые к установке MCP-серверы — для их подключения достаточно указать только токены авторизации для нужного сервиса.

![MCP (2)](https://content.timeweb.com/assets/f1d881fb-eec0-4ce2-b6e5-f1573bc7e791.png?width=1666&height=869)

## Управление MCP-серверами агента

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

1.  Перейдите во вкладку «Управление» нужного агента.
    
2.  В строке «MCP-серверы» нажмите «Изменить».
    

![Scr 20260210 Kpyk](https://content.timeweb.com/assets/7dd4e73b-4390-49cc-abf5-60088571436c.png?width=2140&height=1474)

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

![Scr 20260210 Kqvs](https://content.timeweb.com/assets/59cf46ed-e7a8-4632-a884-4b516872fe35.png?width=2526&height=1478)

Чтобы отвязать MCP-сервер от агента, в этом же окне нажмите на кнопку «Удалить MCP-сервер».

К одному агенту можно подключить несколько MCP-серверов. Одно подключение может использоваться несколькими агентами.

## Использование 

После подключения MCP-сервера агент будет использовать его функции как при работе через OpenAI-совместимый API, так и в интерфейсе виджета.

При использовании OpenAI-совместимого API подключенные MCP-серверы применяются только в случае, если в запросе не передается параметр `tools` в явном виде.

Потоковая передача данных (SSE) пока не поддерживается для агентов с подключенными MCP-серверами.