From 80db8fda1de00250e2359b3d3558d0cc10d877d0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 2 Jun 2026 00:49:23 +0000 Subject: [PATCH] docs: add Notion Custom Agents partner integration page --- .../data-integrations/integrations/notion.mdx | 74 +++++++++++++++++++ integrations/connectors/navigation.json | 1 + .../tools/data-integration-index.mdx | 3 +- .../cloud/features/ai-ml/mcp/remote-mcp.mdx | 4 + 4 files changed, 81 insertions(+), 1 deletion(-) create mode 100644 integrations/connectors/data-integrations/integrations/notion.mdx diff --git a/integrations/connectors/data-integrations/integrations/notion.mdx b/integrations/connectors/data-integrations/integrations/notion.mdx new file mode 100644 index 000000000..ed79f81fa --- /dev/null +++ b/integrations/connectors/data-integrations/integrations/notion.mdx @@ -0,0 +1,74 @@ +--- +sidebarTitle: 'Notion' +slug: /integrations/notion +keywords: ['clickhouse', 'notion', 'mcp', 'custom agents', 'ai', 'integrate', 'connect'] +description: 'Connect ClickHouse Cloud to a Notion Custom Agent via the ClickHouse Remote MCP server.' +title: 'Connecting Notion to ClickHouse' +doc_type: 'guide' +integration: + - support_level: 'partner' + - category: 'data_integration' +--- + +import PartnerBadge from "/snippets/components/PartnerBadge/PartnerBadge.jsx"; + + + +[Notion](https://www.notion.com/) is a connected workspace for notes, docs, projects, and AI-powered Custom Agents. + +You can connect ClickHouse Cloud to a Notion [Custom Agent](https://www.notion.com/help/mcp-connections-for-custom-agents) as a custom MCP server. Once connected, the agent can explore your data, run read-only analytical queries, and surface service and cost information from ClickHouse Cloud without leaving Notion. + +## Prerequisites {#prerequisites} + +- A running [ClickHouse Cloud service](/getting-started/quick-start/cloud) with the [Remote MCP server enabled](/use-cases/AI/MCP/remote_mcp#enable-remote-mcp-server) +- A Notion workspace on the **Business** or **Enterprise** plan +- A workspace admin has enabled **Custom MCP servers** under **Settings** > **Notion AI** > **AI connectors** + +## Connect ClickHouse to a Notion Custom Agent {#connect-clickhouse-to-notion} + +1. In Notion, open the Custom Agent you want to extend and click **Settings**. +2. Under **Tools & Access**, click **Add connection** and choose **Custom MCP server**. + +{/* TODO(screenshot): the "Add connection" menu inside the agent's Tools & Access, showing the "Custom MCP server" option */} + +3. Enter the ClickHouse Cloud Remote MCP server URL and give the connection a display name like `ClickHouse`: + + ```text + https://mcp.clickhouse.cloud/mcp + ``` + +{/* TODO(screenshot): the Custom MCP server modal with the server URL and display name filled in */} + +4. Click **Save**, then complete the OAuth flow to authenticate with your ClickHouse Cloud credentials. Access is scoped to the organizations and services your account can already reach. + +{/* TODO(screenshot): the OAuth consent / "Connected" confirmation state */} + +5. Expand the new connection to review the [available ClickHouse tools](/cloud/features/ai-ml/remote-mcp#available-tools) and toggle on the ones you want this agent to use. All ClickHouse Remote MCP tools are read-only. + +{/* TODO(screenshot): the expanded ClickHouse connection showing the list of tool toggles */} + + +Each Custom Agent requires its own ClickHouse connection, and only the person who authenticated a connection can change its tool settings. See Notion's [security best practices for Agent connections](https://www.notion.com/help/security-best-practices-for-agent-connections) for more details. + + +## Example prompts {#example-prompts} + +Once connected, you can ask the Custom Agent questions in natural language. Some examples: + +| Prompt | Tool invoked | +|--------|--------------| +| "What databases are available on my ClickHouse service?" | `list_databases` | +| "Show me the top 10 rows from the `hits` table" | `run_select_query` | +| "What was my organization's ClickHouse cost last week?" | `get_organization_cost` | +| "List recent backups for this service" | `list_service_backups` | + +For the full set of natural-language patterns and tools, see the [Remote MCP example usage](/use-cases/AI/MCP/remote_mcp#example-usage) section. + +{/* TODO(screenshot): a Notion Custom Agent conversation showing a ClickHouse query result rendered in the Notion UI */} + +## Related content {#related-content} + +- [Enable and connect ClickHouse Cloud remote MCP server](/use-cases/AI/MCP/remote_mcp) +- [Remote MCP in Cloud — tool reference](/cloud/features/ai-ml/remote-mcp) +- Notion: [MCP connections for Custom Agents](https://www.notion.com/help/mcp-connections-for-custom-agents) +- Notion: [Connect Custom Agents to your tool stack with MCP integrations](https://www.notion.com/help/guides/connect-custom-agents-to-mcp-integrations) diff --git a/integrations/connectors/navigation.json b/integrations/connectors/navigation.json index d70b36370..b626fb8ed 100644 --- a/integrations/connectors/navigation.json +++ b/integrations/connectors/navigation.json @@ -214,6 +214,7 @@ "integrations/connectors/data-integrations/integrations/retool", "integrations/connectors/data-integrations/integrations/easypanel", "integrations/connectors/data-integrations/integrations/middleware", + "integrations/connectors/data-integrations/integrations/notion", "integrations/connectors/data-integrations/integrations/splunk", { "group": "pg_clickhouse", diff --git a/integrations/connectors/tools/data-integration-index.mdx b/integrations/connectors/tools/data-integration-index.mdx index e6fc3b86b..8f72942cb 100644 --- a/integrations/connectors/tools/data-integration-index.mdx +++ b/integrations/connectors/tools/data-integration-index.mdx @@ -1,6 +1,6 @@ --- slug: /integrations/tools/data-integrations -keywords: ['Retool', 'Easypanel', 'Splunk'] +keywords: ['Retool', 'Easypanel', 'Splunk', 'Notion'] title: 'Data integrations' description: 'Landing page for the data integrations section' doc_type: 'landing-page' @@ -10,5 +10,6 @@ doc_type: 'landing-page' |-----------|---------------------------------------------------------------------------------------------------------------------------------| | [Easypanel](/integrations/connectors/data-integrations/integrations/easypanel) | Easypanel allows you to deploy ClickHouse on your own server | | [Middleware](/integrations/connectors/data-integrations/integrations/middleware) | Connect ClickHouse with Middleware for observability and monitoring workflows. | +| [Notion](/integrations/notion) | Connect ClickHouse Cloud to a Notion Custom Agent via the ClickHouse Remote MCP server. | | [Retool](/integrations/connectors/data-integrations/integrations/retool) | Quickly build web and mobile apps with rich user interfaces, automate complex tasks, and integrate AI—all powered by your data. | | [Splunk](/integrations/connectors/data-integrations/integrations/splunk) | Store ClickHouse Cloud audit logs into Splunk. | diff --git a/products/cloud/features/ai-ml/mcp/remote-mcp.mdx b/products/cloud/features/ai-ml/mcp/remote-mcp.mdx index c79bd124e..d9a9868d3 100644 --- a/products/cloud/features/ai-ml/mcp/remote-mcp.mdx +++ b/products/cloud/features/ai-ml/mcp/remote-mcp.mdx @@ -69,6 +69,10 @@ Select `clickhouse-cloud` and authenticate via OAuth using your credentials for 4. Click the newly added `clickhouse-cloud` connector and click **Connect** 5. Authenticate using your ClickHouse Cloud credentials via OAuth +### Notion {#notion} + +See the dedicated [Connecting Notion to ClickHouse](/integrations/notion) integration guide for connecting the ClickHouse Cloud Remote MCP server to a Notion Custom Agent. + ### Cursor {#cursor} 1. Browse and install MCP servers from the [Cursor Marketplace](https://cursor.com/marketplace).