ClickHouse · Blargian · Dec 30, 2025 · Dec 30, 2025 · Dec 30, 2025 · Dec 30, 2025
@@ -0,0 +1,19 @@
+---
+sidebar_label: 'Ask AI agent'
+slug: /cloud/features/ai-ml/ask-ai
+title: 'Ask AI agent in Cloud'
+description: 'Description of the Ask AI chat functionality in ClickHouse Cloud'
+doc_type: 'reference'
+---
+
+# Ask AI agent in Cloud
+
+The “Ask AI” agent is a turn-key experience that allows users to trigger complex analysis tasks on top of the data hosted in their ClickHouse Cloud service.
+Instead of writing SQL or navigating dashboards, users can describe what they are looking for in natural language.
+The assistant responds with generated queries, visualizations, or summaries, and can incorporate context like active tabs, saved queries, schema details, and dashboards to improve accuracy.
+It’s designed to work as an embedded assistant, helping users move quickly from questions to insights, and from prompts to working dashboards or APIs.
+
+The experience also embeds a "Docs AI" sub-agent that can be used to ask specific questions about the ClickHouse documentation straight from the console.
+Instead of searching through hundreds of pages, users can ask direct questions like "How do I configure materialized views?" or "What's the difference between ReplacingMergeTree and AggregatingMergeTree?" and receive precise answers with relevant code examples and links to source documentation.
+
+See the [guides](/use-cases/AI_ML/AIChat) section for more details.
@@ -0,0 +1,5 @@
+{
+  "label": "AI/ML",
+  "collapsible": true,
+  "collapsed": true
+}
@@ -0,0 +1,17 @@
+---
+sidebar_label: 'Overview'
+slug: /cloud/features/ai-ml
+title: 'AI/ML features in Cloud'
+description: 'Overview of what AI/ML features are offered in ClickHouse Cloud'
+doc_type: 'reference'
+---
+
+# AI/ML in ClickHouse Cloud
+
+Traditional analytics workflows often involve multiple handoffs between data engineers writing queries, analysts building dashboards, and business users interpreting results.
+Each step introduces latency measured in hours or days.
+ClickHouse Cloud offers the following agentic capabilities to collapse that timeline to seconds or minutes,
+making it possible for a product manager to ask "What's driving the spike in churn last week?" and immediately receive not just the answer, but the underlying query, a visualization, and potential next questions to explore.
+
+- [Ask AI agent](/cloud/features/ai-ml/ask-ai)
+- [Remote MCP server](/cloud/features/ai-ml/remote-mcp)
@@ -0,0 +1,22 @@
+---
+sidebar_label: 'Remote MCP server'
+slug: /cloud/features/ai-ml/remote-mcp
+title: 'Remote MCP in Cloud'
+description: 'Description of the remote MCP functionality in ClickHouse Cloud'
+doc_type: 'reference'
+---
+
+# Remote MCP server in Cloud
+
+Not all users interact with ClickHouse through the Cloud console.
+For example, many developers work directly from their preferred code editors, CLI agents, or connect to the database via custom setups, while others rely on general-purpose AI assistants such as Anthropic Claude for most of their explorations.
+These users, and the agentic workloads acting on their behalf, need a way to securely access and query ClickHouse Cloud without complex setups or custom infrastructure.
+
+The remote MCP server capability in ClickHouse Cloud addresses this by exposing a standard interface that external agents can use to retrieve analytical context.
+MCP, or Model Context Protocol, is a standard for structured data access by AI applications powered by LLMs.
+With this integration, external agents can list databases and tables, inspect schemas, and run scoped, read-only SELECT queries.
+Authentication is handled via OAuth, and the server is fully managed on ClickHouse Cloud, so no setup or maintenance is required.
+
+This makes it easier for agentic tools to plug into ClickHouse and retrieve the data they need, whether for analysis, summarization, code generation, or exploration.
+
+See the [guides](/use-cases/AI/MCP/remote_mcp) section for more details.
@@ -0,0 +1,5 @@
+{
+  "label": "Ask AI",
+  "collapsible": true,
+  "collapsed": true
+}
@@ -1,17 +1,16 @@
 ---
 slug: /use-cases/AI_ML/AIChat/semantic-layer
-sidebar_label: 'Semantic layer'
+sidebar_label: 'Customizing Ask AI chat with a semantic layer'
 title: 'Optimizing Ask AI Agent Conversations with a Semantic Layer'
 pagination_prev: null
 pagination_next: null
 description: 'Guide to using AGENTS.md to provide custom business logic and data-specific instructions to the Ask AI chat agent'
 keywords: ['AI', 'ClickHouse Cloud', 'Agent', 'AGENTS.md', 'Semantic Layer', 'Custom Instructions', 'System Prompt']
 show_related_blogs: true
-sidebar_position: 1
 doc_type: 'guide'
 ---
 
-# Customizing Ask AI chat with a semantic layer
+# Customize Ask AI chat with a semantic layer
 
 The Ask AI chat agent can be customized to understand your specific business logic, data structures, and domain knowledge through **AGENTS.md**—a special saved query that acts as a semantic layer over the agent's system prompt.
 

@@ -1,7 +1,7 @@
 ---
 slug: /use-cases/AI_ML/AIChat
-sidebar_label: 'AI chat'
-title: 'Using AI Chat in ClickHouse Cloud'
+sidebar_label: 'Use Ask AI chat in ClickHouse Cloud'
+title: 'Use Ask AI chat in ClickHouse Cloud'
 pagination_prev: null
 pagination_next: null
 description: 'Guide to enabling and using the AI Chat feature in ClickHouse Cloud Console'
@@ -21,7 +21,7 @@ import img_history from '@site/static/images/use-cases/AI_ML/AIChat/5_history.pn
 import img_result_actions from '@site/static/images/use-cases/AI_ML/AIChat/6_result_actions.png';
 import img_new_tab from '@site/static/images/use-cases/AI_ML/AIChat/7_open_in_editor.png';
 
-# Using AI Chat in ClickHouse Cloud
+# Use Ask AI chat in ClickHouse Cloud
 
 > This guide explains how to enable and use the AI Chat feature in the ClickHouse Cloud Console.
 

@@ -0,0 +1,5 @@
+{
+  "label": "AI/ML",
+  "collapsible": true,
+  "collapsed": true
+}
@@ -1,6 +1,6 @@
 ---
 slug: /use-cases/AI/MCP/remote_mcp
-sidebar_label: 'ClickHouse Cloud remote MCP'
+sidebar_label: 'Enable remote MCP server'
 title: 'Enabling the ClickHouse Cloud Remote MCP Server'
 pagination_prev: null
 pagination_next: null

@@ -43,14 +43,15 @@ The [ClickHouse MCP Server](https://github.com/ClickHouse/mcp-clickhouse) offers
 * `list_databases` - List all databases on your ClickHouse cluster.
 * `list_tables` - List all tables in a database.
 
+If you're looking for a remote MCP server in ClickHouse Cloud, see page ["Remote MCP server in Cloud"](/cloud/features/ai-ml/remote-mcp)
+
 ## Guides for using the ClickHouse MCP Server {#clickhouse-mcp-server-guides}
 
 Below are some guides showing how to use the ClickHouse MCP Server.
 
 <!--AUTOGENERATED_START-->
 | Page | Description |
 |-----|-----|
-| [Enabling the ClickHouse Cloud Remote MCP Server](/use-cases/AI/MCP/remote_mcp) | This guide explains how to enable and use the ClickHouse Cloud Remote MCP |
 | [How to build a ClickHouse-backed AI Agent with Streamlit](/use-cases/AI/MCP/ai-agent-libraries/streamlit-agent) | Learn how to build a web-based AI Agent with Streamlit and the ClickHouse MCP Server |
 | [How to build a LangChain/LangGraph AI agent using ClickHouse MCP Server.](/use-cases/AI/MCP/ai-agent-libraries/langchain) | Learn how to build a LangChain/LangGraph AI agent that can interact with ClickHouse's SQL playground using ClickHouse's MCP Server. |
 | [How to build a LlamaIndex AI agent using ClickHouse MCP Server.](/use-cases/AI/MCP/ai-agent-libraries/llamaindex) | Learn how to build a LlamaIndex AI agent that can interact with ClickHouse MCP Server. |