Skip to content

Add Warp configuration to README.md - #41

Closed
Marco S. Casalaina (mcasalaina) wants to merge 2 commits into
MicrosoftDocs:mainfrom
mcasalaina:add-warp-configuration
Closed

Add Warp configuration to README.md#41
Marco S. Casalaina (mcasalaina) wants to merge 2 commits into
MicrosoftDocs:mainfrom
mcasalaina:add-warp-configuration

Conversation

@mcasalaina

Copy link
Copy Markdown

This PR adds Warp MCP configuration instructions to the README.md file.

Changes

  • Added Warp to the alternative installation table in the README.md
  • Includes manual configuration with npx mcp-remote proxy
  • Added link to official Warp MCP guide
  • Provides complete configuration example with environment settings

Why this change?

This addition provides users with clear instructions on how to configure the Microsoft Learn Docs MCP Server with Warp, completing the coverage of major MCP-compatible development environments.

Testing

  • Verified the configuration format matches other entries in the table
  • Confirmed the Warp MCP guide link is valid and accessible

Related

This enhances the user experience by providing comprehensive setup instructions for Warp users who want to integrate with the Microsoft Learn Docs MCP Server.

- Added Warp MCP configuration instructions to the alternative installation table
- Includes manual configuration with npx mcp-remote proxy
- Added link to official Warp MCP guide
Copilot AI review requested due to automatic review settings July 6, 2025 22:16

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull Request Overview

Adds Warp as an alternative MCP configuration option in the README, aligning it with existing entries and linking to official Warp documentation.

  • Inserted a new table row for Warp with full config example
  • Included env, working_directory, and start_on_launch keys
  • Linked to the official Warp MCP guide
Comments suppressed due to low confidence (2)

README.md:76

  • The new table row is missing a trailing |, which will break the Markdown table formatting. Please add a | at the end of the line.
| **Warp** | <details><summary>View Config</summary><pre>{<br/>  "microsoft.docs.mcp": {<br/>    "command": "npx",<br/>    "args": [<br/>      "-y",<br/>      "mcp-remote",<br/>      "https://learn.microsoft.com/api/mcp"<br/>    ],<br/>    "env": { },<br/>    "working_directory": null,<br/>    "start_on_launch": true<br/>  }<br/>}</pre></details> | [Warp MCP Official Guide](https://docs.warp.dev/knowledge-and-collaboration/mcp) 

README.md:76

  • [nitpick] An empty env object might confuse users. Consider providing an example placeholder or a brief note that no environment variables are required by default.
| **Warp** | <details><summary>View Config</summary><pre>{<br/>  "microsoft.docs.mcp": {<br/>    "command": "npx",<br/>    "args": [<br/>      "-y",<br/>      "mcp-remote",<br/>      "https://learn.microsoft.com/api/mcp"<br/>    ],<br/>    "env": { },<br/>    "working_directory": null,<br/>    "start_on_launch": true<br/>  }<br/>}</pre></details> | [Warp MCP Official Guide](https://docs.warp.dev/knowledge-and-collaboration/mcp) 

@pdebruin

Copy link
Copy Markdown
Collaborator

Hi Marco S. Casalaina (@mcasalaina) thanks for adding, as we want to enable all clients.
I just tested this config with Warp on Windows and it worked. For completeness I also tested the MCP Server directly, but Warp doesn't like streamable http yet. warpdotdev/warp#6572
Finally, it looks like Warp doesn't need the env workingdir and startonlaunch placeholders to connect to the MCP Server but adds them automatically anyway.

@pdebruin

Copy link
Copy Markdown
Collaborator

Hi Marco S. Casalaina (@mcasalaina), thank you for this contribution, and apologies it sat open for so long.

Closing this one, as the situation has changed since July 2025 in a way that makes the change no longer applicable:

Warp has added Streamable HTTP support (warpdotdev/warp#6572, closed 2025-09-04), so the npx mcp-remote proxy this PR documents is no longer needed. Warp can now connect to https://learn.microsoft.com/api/mcp directly with a URL-based server config.

The README has also been restructured since. The "clients that don't support native remote MCP servers" table this PR adds a row to no longer exists, and mcp-remote no longer appears in the README at all, so the change conflicts with main.

Your underlying point still stands: Warp is not yet listed in the installation table, and it should be. That is now a direct URL entry alongside Windsurf and Kiro rather than a proxy config, so it is cleaner as a fresh change than a rebase of this one.

Thanks again for flagging the gap, and for the original testing notes.

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.

3 participants