> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Руководства по MCP

> На этой странице представлено введение в Model Context Protocol (MCP), а также приведено оглавление руководств по MCP.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

[Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP) — это стандарт, разработанный Anthropic, который позволяет ИИ-ассистентам легко интегрироваться с внешними системами.
Этот протокол позволяет ИИ-ассистентам безопасно и единообразно подключаться к источникам данных, API, базам данных и другим системам.

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

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

<div id="mcp-architecture">
  ## Как устроена архитектура MCP?
</div>

MCP использует клиент-серверную архитектуру:

* Клиенты (например, Claude Desktop, Cursor или VS Code) устанавливают соединения с MCP-серверами. Подборку клиентов можно найти в GitHub-репозитории [awesome-mcp-clients](https://github.com/punkpeye/awesome-mcp-clients?tab=readme-ov-file#windsurf).
* Серверы предоставляют инструменты и возможности через стандартизированные интерфейсы. Подборку серверов можно найти в GitHub-репозитории [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers).
* Затем ИИ-модели могут использовать эти инструменты для доступа к внешним данным и функциональности по мере необходимости

Ниже показана схема архитектуры:

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/MCP/mcp_overview.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=5b034a203fb07ffbb26c2b5ef2cff1b8" alt="Обзор MCP" size="lg" width="1551" height="641" data-path="images/use-cases/AI_ML/MCP/mcp_overview.webp" />

<div id="clickhouse-mcp-server">
  ## Есть ли у ClickHouse MCP-сервер?
</div>

Да!
[MCP-сервер ClickHouse](https://github.com/ClickHouse/mcp-clickhouse) предоставляет следующие инструменты:

* `run_select_query` - Выполнение SQL-запросов к вашему кластеру ClickHouse.
* `list_databases` - Вывод списка всех баз данных в вашем кластере ClickHouse.
* `list_tables` - Вывод списка всех таблиц в базе данных.

Если вам нужен удалённый MCP-сервер в ClickHouse Cloud, см. страницу ["Удалённый MCP-сервер в Cloud"](/ru/products/cloud/features/ai-ml/remote-mcp)

<Tip>
  **Agent Skills**

  [Репозиторий ClickHouse Agent Skills](https://github.com/ClickHouse/agent-skills) содержит готовые инструкции, которые расширяют возможности ИИ-агентов для разработки (Claude Code, Cursor, Copilot и т. д.) за счёт экспертизы в предметной области. В этом репозитории собраны навыки для работы с базами данных ClickHouse, включая проектирование схем, оптимизацию запросов и шаблоны ингестии данных.
</Tip>

<div id="clickhouse-mcp-server-guides">
  ## Руководства по использованию MCP-сервера ClickHouse
</div>

Ниже приведено несколько руководств о том, как использовать MCP-сервер ClickHouse.

| Страница                                                                                                                                                         | Описание                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| [Как создать AI Agent на базе ClickHouse с помощью Streamlit](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit)                                       | Узнайте, как создать веб-приложение AI Agent с помощью Streamlit и MCP-сервера ClickHouse                                                |
| [Как создать ИИ-агента LangChain/LangGraph с использованием MCP-сервера ClickHouse.](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain)                | Узнайте, как создать ИИ-агента LangChain/LangGraph, который может взаимодействовать с Песочницей ClickHouse через MCP-сервер ClickHouse. |
| [Как создать AI Agent LlamaIndex с помощью MCP-сервера ClickHouse.](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex)                                | Узнайте, как создать AI Agent LlamaIndex, который может взаимодействовать с MCP-сервером ClickHouse.                                     |
| [Как создать AI-агент на PydanticAI с помощью MCP-сервера ClickHouse.](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai)                            | Узнайте, как создать AI-агент на PydanticAI, который может взаимодействовать с MCP-сервером ClickHouse.                                  |
| [Как создать AI-агент SlackBot с помощью MCP-сервера ClickHouse.](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot)                                    | Узнайте, как создать агент SlackBot, который может взаимодействовать с MCP-сервером ClickHouse.                                          |
| [Как создать AI Agent с Agno и MCP-сервером ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno)                                                  | Узнайте, как создать AI Agent с Agno и MCP-сервером ClickHouse                                                                           |
| [Как создать AI-агента с помощью Chainlit и MCP-сервера ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit)                                  | Узнайте, как использовать Chainlit для создания чат-приложений на базе LLM вместе с MCP-сервером ClickHouse                              |
| [Как создать ИИ-агента с помощью Claude Agent SDK и MCP-сервера ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk)                  | Узнайте, как создать ИИ-агента с помощью Claude Agent SDK и MCP-сервера ClickHouse                                                       |
| [Как создать ИИ-агента с помощью CopilotKit и MCP-сервера ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit)                              | Узнайте, как создать приложение с ИИ-агентом, используя данные, хранящиеся в ClickHouse, с помощью ClickHouse MCP и CopilotKit           |
| [Как создать ИИ-агента с CrewAI и MCP-сервером ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai)                                             | Узнайте, как создать ИИ-агента с CrewAI и MCP-сервером ClickHouse                                                                        |
| [Как создать ИИ-агента с DSPy и MCP-сервером ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy)                                                 | Узнайте, как создать AI-агента с помощью DSPy и MCP-сервера ClickHouse                                                                   |
| [Как создать AI-агента с помощью mcp-agent и MCP-сервера ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent)                                | Узнайте, как создать AI-агента с помощью mcp-agent и MCP-сервера ClickHouse                                                              |
| [Как создать AI Agent с помощью Microsoft Agent Framework и MCP-сервера ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | Узнайте, как создать AI Agent с помощью Microsoft Agent Framework и MCP-сервера ClickHouse                                               |
| [Как создать ИИ-агента с Upsonic и MCP-сервером ClickHouse](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic)                                           | Узнайте, как создать ИИ-агента с Upsonic и MCP-сервером ClickHouse                                                                       |
| [Как создать агента OpenAI с помощью MCP-сервера ClickHouse.](/ru/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents)                                   | Узнайте, как создать агента OpenAI, способного взаимодействовать с MCP-сервером ClickHouse.                                              |
| [Настройка MCP-сервера ClickHouse для работы с Ollama](/ru/guides/use-cases/ai-ml/MCP/ollama)                                                                    | В этом руководстве объясняется, как настроить Ollama для работы с MCP-сервером ClickHouse.                                               |
| [Использование MCP-сервера ClickHouse с AnythingLLM](/ru/guides/use-cases/ai-ml/MCP/anythingllm)                                                                 | В этом руководстве рассказывается, как настроить AnythingLLM для работы с MCP-сервером ClickHouse с помощью Docker.                      |
| [Использование MCP-сервера ClickHouse с Claude Desktop](/ru/guides/use-cases/ai-ml/MCP/claude-desktop)                                                           | В этом руководстве объясняется, как настроить Claude Desktop для работы с MCP-сервером ClickHouse.                                       |
| [Использование MCP-сервера ClickHouse с Jan.ai](/ru/guides/use-cases/ai-ml/MCP/janai)                                                                            | В этом руководстве объясняется, как настроить Jan.ai для работы с MCP-сервером ClickHouse.                                               |
| [Использование MCP-сервера ClickHouse с LibreChat](/ru/guides/use-cases/ai-ml/MCP/librechat)                                                                     | В этом руководстве объясняется, как настроить LibreChat для работы с MCP-сервером ClickHouse с помощью Docker.                           |
| [Использование MCP-сервера ClickHouse с Open WebUI](/ru/guides/use-cases/ai-ml/MCP/open-webui)                                                                   | В этом руководстве описано, как настроить Open WebUI для работы с MCP-сервером ClickHouse с помощью Docker.                              |
