Skip to content

Add a Notion MCP tab alongside Notion API on the Notion setup page#397

Open
socialyadept wants to merge 1 commit into
mainfrom
muhammad.kumail/notion-mcp-api-tabs
Open

Add a Notion MCP tab alongside Notion API on the Notion setup page#397
socialyadept wants to merge 1 commit into
mainfrom
muhammad.kumail/notion-mcp-api-tabs

Conversation

@socialyadept

Copy link
Copy Markdown
Contributor

Summary

Notion ships its own hosted MCP server (mcp.notion.com) in addition to the REST API C1 already wraps as an MCP server. This adds a second tab to the Notion setup page so admins can tell the two apart and set up either one:

  • Notion MCP (default tab) — connects to Notion's own hosted MCP server. Authentication is per-user OAuth with dynamic client registration (DCR) only — Notion's hosted server doesn't offer a bearer token or API key mode, so there's nothing to create in Notion first. Listed as plain Notion in the MCP server catalog.
  • Notion API (existing content, lightly reorganized) — C1's own MCP server that translates Notion's REST API into tools, supporting per-user OAuth or a shared internal integration secret (bearer token). Listed as Notion API in the catalog.

A comparison table above the tabs explains the difference up front (who hosts the server, authentication, access scoping, tool surface, setup effort), and the intro/recommendation prose is explicit about which catalog entry ("Notion" vs "Notion API") each option maps to, since the two names are easy to conflate. The literal in-product instructions ("select Notion from the catalog") are left as-is to match the real UI label.

All external Notion reference links were checked and are live.

Test plan

  • Verified all reference links (notion.com/help pages, developers.notion.com pages) resolve live
  • Verified internal doc links/anchors (/product/admin/mcp-servers#..., /product/admin/enable-ai-access-management#..., etc.) exist on main
  • Built a full static export of the site with this change and rendered the page locally — tabs, table, and steps render correctly, "Notion MCP" shows as the default tab
  • Checked MDX component tags (Tabs/Tab/Steps/Step/Note) are balanced

🤖 Generated with Claude Code

Notion ships its own hosted MCP server in addition to the REST API C1
already wraps. Add a "Notion MCP" tab (native hosted server, per-user
OAuth with dynamic client registration only) next to the existing
"Notion API" tab (REST-API-backed, per-user OAuth or a shared internal
integration secret), with Notion MCP as the default tab and a
comparison table up top explaining how the two differ (hosting, auth,
access scoping, tool surface, setup effort).

Co-authored-by: c1-squire-dev[bot] <c1-squire-dev[bot]@users.noreply.github.com>
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jul 17, 2026, 12:45 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant