docs(mcp): document well-known managed integration ids - #599
Draft
hongyi-chen wants to merge 1 commit into
Draft
Conversation
Warp now accepts short managed-integration ids (linear, slack, jira) wherever an MCP server UUID is accepted: bare `--mcp` arguments and `warp_id` values in cloud agent MCP configs. This shipped with the WellKnownMcpIds flag going GA. Co-Authored-By: Warp <agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Collaborator
Author
|
This PR was generated with Warp. Comment |
Contributor
|
Your GitHub account is not connected to Warp. Connect it here. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Warp now accepts short managed integration ids wherever an MCP server UUID is accepted, so agents can reach the Warp-hosted Linear, Slack, and Jira MCP servers without looking up a UUID. This shipped when the
WellKnownMcpIdsflag was promoted dogfood → GA.Found by the
missing_docsdrift-watch audit (surface change:flag_status_changed: WellKnownMcpIds dogfood -> ga; coverage finding: "GA feature with no doc mentions found").Changes
reference/cli/mcp-servers.mdx—--mcpnow documents four formats and gains a Passing Warp-managed integration servers by id section with an example and the recognized ids.platform/mcp.mdx—warp_idnow documents managed integration ids, plus a resolution note in Requirements and defaults.Verification
crates/warp_cli/src/mcp.rs(MCPSpec::WellKnown,is_well_known_mcp_id) and the server-side well-known id set, whose ids are enabled in production config.npm run buildpasses;style_lint --changedreports no new issues.Deferred findings from this audit run
linear_agent_sessionis also a recognized id, but it exists so Linear-triggered runs can write their own agent-session activities rather than as a user-facing choice, so it is intentionally left undocumented.internalin the companion bookkeeping PR rather than hand-documented.style_lintskill and were not touched here.