Skip to content

docs: update README and TOOLSET documentation for Remote MCP Server m… #1463

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
danhellem wants to merge 3 commits into
base: main
Choose a base branch
from
+2 −381
Open

docs: update README and TOOLSET documentation for Remote MCP Server m… #1463

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
787628f
docs: update README and TOOLSET documentation for Remote MCP Server m…
danhellem Jul 27, 2026
6ae44d1
docs: update recommendation for migrating to Remote MCP Server in README
danhellem Jul 27, 2026
0b98732
Merge branch 'main' into users/danhellem/doc-updates-1
danhellem Jul 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 2 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# ⭐ Azure DevOps MCP Server

> [!IMPORTANT]
> The Azure DevOps Remote MCP Server is now available in public preview for all organizations. We recommend migrating to the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) going forward.
> We recommend using the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) instead of this local server. It requires no installation and gets new features first.
>
> [Learn more](#-remote-mcp-server-recommended)

Expand Down Expand Up @@ -44,19 +44,14 @@ The Azure DevOps MCP Server is built around tools that are concise, simple, focu

## 🚀 Remote MCP Server (Recommended)

The Azure DevOps **Remote MCP Server** is now available in [public preview](https://devblogs.microsoft.com/devops/azure-devops-remote-mcp-server-public-preview).
For complete instructions, see the [Remote MCP Server onboarding documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops).

Over time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.

We encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.

If you encounter issues with tools, need support, or have a feature request, you can report an issue using the [Remote MCP Server issue template](https://github.com/microsoft/azure-devops-mcp/issues/new?template=remote-mcp-server-issue.md). During the preview period, we will track Remote MCP Server issues through this repository.

> [!WARNING]
> Internal Microsoft users of the Remote MCP Server should **not** create issues in this repository. Please use the dedicated Teams channel instead.

For complete instructions, see the [Remote MCP Server onboarding documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server?view=azure-devops).

### Quick start with `.vscode/mcp.json`

Use this configuration to connect directly to the Azure DevOps-hosted endpoint using streamable HTTP transport:
Expand Down
Loading
Loading