Skip to content

Add a Linear MCP tab alongside Linear API on the Linear setup page#419

Closed
socialyadept wants to merge 1 commit into
mainfrom
muhammad.kumail/linear-mcp-tab
Closed

Add a Linear MCP tab alongside Linear API on the Linear setup page#419
socialyadept wants to merge 1 commit into
mainfrom
muhammad.kumail/linear-mcp-tab

Conversation

@socialyadept

Copy link
Copy Markdown
Contributor

Summary

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

  • Linear MCP (default tab) — connects to Linear's own hosted MCP server. The recommended authentication method is per-user OAuth with dynamic client registration (DCR) — nothing to register in Linear first. Linear's hosted server also accepts a personal API key sent as a bearer token, so that's documented as a secondary option on this tab. Listed as plain Linear in the MCP server catalog.
  • Linear API (existing content, lightly reorganized) — C1's own MCP server that translates the Linear REST API into tools, supporting per-user OAuth (via a Linear OAuth application) or a personal API key. Listed as Linear 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 ("Linear" vs "Linear API") each option maps to. The literal in-product instructions ("select Linear from the catalog") are left as-is to match the real UI label.

All external Linear reference links were checked and are live.

Test plan

  • Verified all reference links (linear.app/docs/*, linear.app/developers/*) resolve live
  • Verified internal doc links/anchors (/product/admin/mcp-servers#..., /product/admin/enable-ai-access-management#..., etc.) already exist on main
  • Checked MDX component tags (Tabs/Tab/Steps/Step/Note) are balanced
  • Confirmed the nav (docs.json) needs no changes — same single page entry, now with tabs

🤖 Generated with Claude Code

Documents C1 registering Linear's own hosted MCP server as a downstream
server, with per-user OAuth (dynamic client registration) as the primary
auth method and a personal API key as a bearer-token alternative, matching
the two-tab pattern already used for other native MCP integrations.

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

mintlify Bot commented Jul 24, 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 24, 2026, 10:03 PM

Copy link
Copy Markdown
Contributor Author

Superseded by #427 — combining all the native-MCP-tab PRs into a single PR per request.

@socialyadept
socialyadept deleted the muhammad.kumail/linear-mcp-tab branch July 24, 2026 22:27
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