> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/advanced-basic/extensions/mcp.md).

# MCP и внешние инструменты

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

<figure><img src="/files/fdc4842ca849f0bc94cd22d125c67bb1ae58c19d" alt="MCP 设置页面中的服务器列表、搜索和添加入口"><figcaption><p>В 【Настройки】→【MCP】 можно централизованно просматривать статус серверов; сначала заставьте один сервер работать нормально отдельно, а затем привяжите его к Agent.</p></figcaption></figure>

## Когда нужен MCP

* Когда Agentу нужно вызывать сервисы, помимо встроенных инструментов Cherry Studio;
* Когда у команды уже есть база данных, браузер или бизнес-система, предоставляющие MCP-интерфейс;
* Когда хочется, чтобы один и тот же набор внешних возможностей использовался несколькими Agent;
* Когда нужно единообразно предоставлять модели инструменты, ресурсы или подсказки.

Если нужен только фиксированный процесс — используйте skills; если нужно только искать в базе знаний Cherry Studio — напрямую привяжите базу знаний, не нужно строить MCP просто ради «большей продвинутости».

<figure><img src="/files/d7375cf602db56cf7aa998f5daa161db7832a8f8" alt="MCP 服务器的快速创建、从 JSON 导入和手动创建方式"><figcaption><p>Если есть JSON от провайдера сервиса, его можно импортировать напрямую; если готовой конфигурации нет, тогда заполняйте команду или адрес вручную.</p></figcaption></figure>

## Добавить сервер

Путь: 【Настройки】→【MCP】→【MCP-серверы】→【Добавить】.

{% stepper %}
{% step %}

### 1. Подтвердите способ подключения

Локальные команды обычно используют стандартный ввод-вывод; удалённые сервисы обычно предоставляют SSE или HTTP-адрес, поддерживающий потоковую передачу. Заполняйте конфигурацию согласно данным от провайдера сервиса, не догадывайтесь по названию.
{% endstep %}

{% step %}

### 2. Заполните конфигурацию и проверьте права

Для локального сервера нужны команда, параметры и переменные окружения; для удалённого сервера нужен URL, а некоторые сервисы также требуют авторизацию. Перед сохранением проверьте источник команды и диапазон данных.
{% endstep %}

{% step %}

### 3. Запустите и просмотрите инструменты

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

В списке инструментов разверните конкретный инструмент, чтобы увидеть полное описание Markdown, а также параметры, типы, отметки обязательности и значения перечислений, показанные по уровням иерархии. Перед вызовом сначала проверьте обязательные параметры; параметры типа объект или массив следует раскрывать по уровням, чтобы не ориентироваться только на название инструмента и не гадать формат ввода.
{% endstep %}

{% step %}

### 4. Привязать к Agent

Откройте 【Работа】→ меню Agent→【Редактировать】→【MCP】 и включите этот сервер. Незапущенный сервер нельзя нормально привязать и использовать.
{% endstep %}
{% endstepper %}

## Встроенные серверы и сервисный маркетплейс

【Встроенный MCP】 предоставляет распространённые возможности, которые можно установить или включить напрямую; 【сервисный маркетплейс】 используется для управления источниками сторонних маркетплейсов. Перед установкой всё равно нужно посмотреть описание, команду, переменные окружения и права; встроенный вход не означает, что у всех операций внешнего сервиса нет риска.

## Рекомендации по конфигурации

| Параметр конфигурации      | Значение по умолчанию в продукте            | Рекомендуемая отправная точка                                                      | Роль                                               | Сценарий применения                         | Примечания                                                              |
| -------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------- |
| Статус сервера             | После добавления определяется конфигурацией | Включайте по одному и проверяйте                                                   | Контролирует, доступен ли сервер                   | Первое подключение, устранение неполадок    | Если несколько сервисов одновременно сбойны, трудно определить источник |
| Привязка Agent             | Не привязывать автоматически все серверы    | Привязывать только серверы, нужные текущему Agent                                  | Контролирует диапазон возможностей                 | Распределение задач между несколькими Agent | Избегать, чтобы не относящиеся инструменты занимали контекст            |
| Переменные окружения       | Не заполнять ключи заранее                  | Использовать учётные данные с минимально необходимыми правами, требуемыми сервисом | Предоставлять параметры аутентификации или запуска | Приватный сервис                            | Перед снимками экрана и экспортом скрывайте конфиденциальное содержимое |
| Подтверждение инструментов | Определяется режимом прав Agent             | Инструменты записи или оплаты оставляйте с подтверждением                          | Предотвращает случайные операции                   | База данных, файлы, внешние API             | Вход через канал можно использовать в более строгом режиме              |

## Кейс пользователя: подключить проектную базу данных к аналитическому Agent

Администратор предоставляет MCP-подключение только для чтения, пользователь в 【Настройки】→【MCP】 проверяет, что сервер работает нормально, а затем привязывает его только к Agent «Анализ данных». Agent использует инструменты только для чтения, чтобы получить данные, и записывает отчёт в рабочую директорию; инструменты, изменяющие данные, не включаются. Таким образом, даже если в подсказке возникнет недоразумение, бизнес-база не будет напрямую изменена.

<details>

<summary>В чём разница между MCP и API-шлюзом?</summary>

MCP подключает внешние инструменты к Cherry Studio; API-шлюз предоставляет возможности модели Cherry Studio другим программам в формате, совместимом с API. Направление потока данных обратное.

</details>

<details>

<summary>Что делать, если сервер показывает, что подключён, а Agent всё равно не находит инструменты?</summary>

Проверьте, привязан ли Agent к этому серверу, не отключены ли инструменты и не ожидаются ли запросы на права. После изменения конфигурации Agent отправьте новое сообщение, чтобы среда выполнения загрузила новые инструменты.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/advanced-basic/extensions/mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.