Skip to content

Update file-based MCP server docs#10

Merged
hongyi-chen merged 4 commits intomainfrom
oz/update-file-based-mcp-docs
May 6, 2026
Merged

Update file-based MCP server docs#10
hongyi-chen merged 4 commits intomainfrom
oz/update-file-based-mcp-docs

Conversation

@vkodithala
Copy link
Copy Markdown
Contributor

@vkodithala vkodithala commented May 1, 2026

Summary

Restructure the file-based MCP docs on agent-platform/capabilities/mcp so the section is easier to scan and accurately reflects current behavior. The single dense section is split into focused subsections with tables where possible.

Motivated by feedback here from an enterprise user at Alto.

What changed

  • Intro - Calls out the two main benefits of file-based MCP servers: configurable directly with Warp's agent via the bundled /agent-add-mcp skill, and inheritable across providers and cloned repos.
  • Supported providers - Replaces the long bullet list with a table covering Warp, Claude Code, Codex, and other agents, including global/project-scoped paths and auto-spawn behavior.
  • Auto-spawn behavior - Documents the Settings > Agents > MCP servers > Auto-spawn toggle and explains how project-scoped servers are detected but never auto-spawned.
  • Using /agent-add-mcp - Adds a dedicated subsection with the new demo video showing how to use the bundled skill to create or update Warp-managed .warp/.mcp.json files.
  • Security mitigations - Documents the two main protections: MCP config edits require explicit user approval, and project-scoped servers from cloned repos never auto-spawn.
  • Settings reference - Aligns the file_based_mcp_enabled copy in the settings reference and settings schema.

Assets

  • Adds public/assets/agent-platform/file-based-mcp-demo.mp4 and a matching .poster.jpg for the local DemoVideo component.
  • Adds public/assets/agent-platform/file-based-mcp-setting.png for the Auto-spawn toggle screenshot.
  • Removes the now-unused public/assets/agent-platform/file-based-mcp-toggle.gif.

Validation

  • npm run build (passes; existing PromQL highlighter warnings on monitoring.mdx are unrelated)
  • python3 .warp/skills/style_lint/style_lint.py --changed

Co-Authored-By: Oz oz-agent@warp.dev

Conversation: https://staging.warp.dev/conversation/6e2c5cd1-4974-4b96-8bbd-9e0fac156140
This PR was generated with _Oz._

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label May 1, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 6, 2026 5:43pm

Request Review

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@vkodithala vkodithala marked this pull request as ready for review May 6, 2026 00:24
@vkodithala vkodithala requested review from hongyi-chen and rachaelrenk and removed request for hongyi-chen May 6, 2026 00:24
- Simplify intro sentence, remove word repetition, unbold Settings
- Extract auto-spawn procedure into numbered steps
- Replace 'allow' with direct language throughout
- Simplify providers table, move shared behavior to prose
- Tighten dense paragraphs and reduce noun repetition
- Make /agent-add-mcp intro more direct and actionable

Co-Authored-By: Oz <oz-agent@warp.dev>
Copy link
Copy Markdown
Contributor

@rachaelrenk rachaelrenk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made an editorial pass and approved 🛸 good to merge!

@hongyi-chen hongyi-chen merged commit eb5ed3d into main May 6, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants