Skip to content

Commit 43364f3

Browse files
authored
feat: add getting started guide for Claude desktop (#441)
adding guidance on using mcp server with Claude Desktop ## GitHub issue number #390 ## **Associated Risks** N/A ## ✅ **PR Checklist** - [x] **I have read the [contribution guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md)** - [x] **I have read the [code of conduct guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CODE_OF_CONDUCT.md)** - [x] Title of the pull request is clear and informative. - [x] 👌 Code hygiene - [x] 🔭 Telemetry added, updated, or N/A - [x] 📄 Documentation added, updated, or N/A - [x] 🛡️ Automated tests added, or N/A ## 🧪 **How did you test it?** Copilot polish and manual review
1 parent ff94eac commit 43364f3

File tree

3 files changed

+37
-1
lines changed

3 files changed

+37
-1
lines changed

docs/GETTINGSTARTED.md

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ This guide will help you get started with the Azure DevOps MCP Server in differe
66
- [Getting started with Visual Studio Code & GitHub Copilot](#️-visual-studio-code--github-copilot)
77
- [Getting started with Visual Studio 2022 & GitHub Copilot](#-visual-studio-2022--github-copilot-1)
88
- [Getting started with Claude Code](#-using-mcp-server-with-claude-code)
9+
- [Getting started with Claude Desktop](#️-using-mcp-server-with-claude-desktop)
910
- [Getting started with Cursor](#-using-mcp-server-with-cursor)
1011
- [Optimizing Your Experience](#-optimizing-your-experience)
1112

@@ -28,7 +29,7 @@ Before you begin, make sure you have:
2829
2. Install [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)
2930
3. Open a project in Visual Studio
3031

31-
### Azure Login
32+
### Azure CLI Login
3233

3334
Ensure you are logged in to Azure DevOps via the Azure CLI:
3435

@@ -216,6 +217,41 @@ claude mcp add azure-devops -- npx -y @azure-devops/mcp Contoso
216217

217218
Replace `Contoso` with your own organization name
218219

220+
### ✴️ Using MCP Server with Claude Desktop
221+
222+
Ensure you are logged in to Azure DevOps using the Azure CLI:
223+
224+
```sh
225+
az login
226+
```
227+
228+
Open Claude Desktop and navigate to **File > Settings > Developer**. Click **Edit Config**.
229+
230+
![Configuring MCP servers in Claude Desktop](../docs/media/claude-desktop-getting-started-1.png)
231+
232+
Open the configuration file in your preferred editor (e.g., VS Code) and add the following JSON:
233+
234+
```json
235+
{
236+
"mcpServers": {
237+
"ado": {
238+
"command": "npx",
239+
"args": ["-y", "@azure-devops/mcp", "{Contoso}"]
240+
}
241+
}
242+
}
243+
```
244+
245+
Replace `{Contoso}` with your Azure DevOps organization name. Save the file and perform a hard restart of the Claude app.
246+
247+
Start a new chat, then click the **Search and Tools** icon. The `ado` toolset should now be available.
248+
249+
![ADO tools in Claude Desktop](../docs/media/claude-desktop-getting-started-2.png)
250+
251+
You’re ready to start using the Azure DevOps MCP Server in Claude Desktop. Try a simple request such as: `get list of ado projects`.
252+
253+
For additional guidance on Claude Desktop, see the [Quickstart](https://modelcontextprotocol.io/quickstart/user#installing-the-filesystem-server).
254+
219255
### 🍇 Using MCP Server with Cursor
220256

221257
To integrate the Azure DevOps MCP Server with Cursor, create a `.cursor\mcp.json` file and add your Azure DevOps organization to the `mcpServers` list.
149 KB
Loading
128 KB
Loading

0 commit comments

Comments
 (0)