Skip to content

Commit e66086b

Browse files
JamesJBarnettJamesJBarnett
authored
Merge pull request #8297 from MicrosoftDocs/users/chcomley/mcp-server-formatting-new
Reformatting MCP Server example tables
2 parents ec44d6e + f856e91 commit e66086b

File tree

1 file changed

+203
-98
lines changed

1 file changed

+203
-98
lines changed

‎docs/mcp-server/mcp-server-overview.md‎

Lines changed: 203 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: overview
88
ms.author: chcomley
99
author: chcomley
1010
monikerRange: 'azure-devops'
11-
ms.date: 09/08/2025
11+
ms.date: 09/11/2025
1212
#customer intent: As a project member, I want to understand what the Azure DevOps MCP Server is and how it can enhance my AI assistant with real-time Azure DevOps context to improve my productivity and decision-making.
1313
---
1414

@@ -83,106 +83,211 @@ For more examples, see [Example usage](https://github.com/microsoft/azure-devops
8383

8484
### Daily standup preparation
8585

86-
| Component | Description |
87-
|-----------|-------------|
88-
| **MCP Server provides** | Access to your assigned work items and recent updates |
89-
| **AI assistant does** | Analyzes the data to help you prepare for standup |
90-
| **Example prompt** | "Get my work items for project MyProject and help me prepare for standup - what did I complete, what am I working on, and what's blocked?" |
91-
| **Query translation** | WIQL query to retrieve your assigned work items, filtered by project and excluding removed items, ordered by most recent changes |
92-
| **Raw data result** | Six work items including bugs, tasks, user stories, and features with their current states (Resolved, Done, Active, New, Blocked) |
93-
94-
**AI assistant standup summary:**
95-
96-
| Status | Work Items |
97-
|--------|------------|
98-
| ✅ **Completed** | Bug #4521: "Sign in page crashes on mobile Safari" - Resolved yesterday<br>Task #4498: "Update API documentation for v2.1" - Completed 2 days ago |
99-
| 🔄 **In Progress** | User Story #4456: "Implement two-factor authentication" - In Progress (three days)<br>└── Subtasks: Database schema (Done), UI components (In Progress), Testing (Not Started)<br><br>Bug #4534: "Performance issue with large datasets" - Active (one day) |
100-
| ⚠️ **Blocked** | Feature #4423: "Integration with external payment gateway" - Blocked<br>└── Waiting for: Security team approval (blocked five days)<br>└── Action needed: Follow up with Sarah from InfoSec team<br><br>Task #4467: "Deploy to staging environment" - Impediment<br>└── Issue: Staging server maintenance scheduled today 2-4 PM |
101-
102-
**Summary for standup**: Yesterday: Resolved mobile Safari sign-in issue, completed API docs. Today: Continue 2FA implementation, investigate dataset performance issue. Blockers: Need security approval for payment integration, staging deployment delayed due to maintenance.
86+
:::row:::
87+
:::column span="1":::
88+
**Component**
89+
:::column-end:::
90+
:::column span="2":::
91+
**Description**
92+
:::column-end:::
93+
:::row-end:::
94+
---
95+
:::row:::
96+
:::column span="1":::
97+
**MCP Server provides**
98+
:::column-end:::
99+
:::column span="2":::
100+
Access to your assigned work items and recent updates
101+
:::column-end:::
102+
:::row-end:::
103+
---
104+
:::row:::
105+
:::column span="1":::
106+
**AI assistant action**
107+
:::column-end:::
108+
:::column span="2":::
109+
Analyzes the data to help you prepare for standup
110+
:::column-end:::
111+
:::row-end:::
112+
---
113+
:::row:::
114+
:::column span="1":::
115+
**Example prompt**
116+
:::column-end:::
117+
:::column span="2":::
118+
"Get my work items for project MyProject and help me prepare for standup - what did I complete, what am I working on, and what's blocked?"
119+
:::column-end:::
120+
:::row-end:::
121+
---
122+
:::row:::
123+
:::column span="1":::
124+
**Query translation**
125+
:::column-end:::
126+
:::column span="2":::
127+
WIQL query to retrieve your assigned work items, filtered by project and excluding removed items, ordered by most recent changes
128+
:::column-end:::
129+
:::row-end:::
130+
---
131+
:::row:::
132+
:::column span="1":::
133+
**Raw data result**
134+
:::column-end:::
135+
:::column span="2":::
136+
Six work items including bugs, tasks, user stories, and features with their current states (Resolved, Done, Active, New, Blocked)
137+
:::column-end:::
138+
:::row-end:::
139+
---
140+
:::row:::
141+
:::column span="1":::
142+
**AI assistant output**
143+
:::column-end:::
144+
:::column span="2":::
145+
| Status | Work Items |
146+
|--------|------------|
147+
| ✅ **Completed** | Bug #4521: "Sign in page crashes on mobile Safari" - Resolved yesterday<br>Task #4498: "Update API documentation for v2.1" - Completed 2 days ago |
148+
| 🔄 **In Progress** | User Story #4456: "Implement two-factor authentication" - In Progress (three days)<br>└── Subtasks: Database schema (Done), UI components (In Progress), Testing (Not Started)<br><br>Bug #4534: "Performance issue with large datasets" - Active (one day) |
149+
| ⚠️ **Blocked** | Feature #4423: "Integration with external payment gateway" - Blocked<br>└── Waiting for: Security team approval (blocked five days)<br>└── Action needed: Follow up with Sarah from InfoSec team<br>Task #4467: "Deploy to staging environment" - Impediment<br>└── Issue: Staging server maintenance scheduled today 2-4 PM |
150+
|**Summary for standup**| - Yesterday: Resolved mobile Safari sign-in issue, completed API docs.<br>- Today: Continue 2FA implementation, investigate dataset performance issue.<br>- Blockers: Need security approval for payment integration, staging deployment delayed due to maintenance.|
151+
:::column-end:::
152+
:::row-end:::
153+
---
103154

104155
### Sprint planning support
105156

106-
| Component | Description |
107-
|-----------|-------------|
108-
| **MCP Server provides** | Access to backlog items, team data, and work item details |
109-
| **AI assistant does** | Helps analyze capacity and plan the sprint |
110-
| **Example prompt** | "Get all work items in the product backlog for MyProject and prioritize them for a two-week sprint with three developers" |
111-
| **Query translation** | WIQL query to retrieve backlog items with story points, priority, and state information, ordered by priority and stack rank |
112-
| **Raw data result** | Nine backlog items including epics, features, user stories, bugs, and tasks with story points and dependencies, plus team metrics (three developers, 14-day sprint, 60-point velocity) |
113-
114-
**AI assistant sprint planning analysis:**
115-
116-
| Category | Work Items | Points |
117-
|----------|------------|--------|
118-
| ✅ **Recommended** | Epic #3401: "User Profile Enhancement" - High business value, no dependencies<br>Bug #3456: "Search results time out on large datasets" - Critical user impact<br>Feature #3378: "Export dashboard to PDF" - Frequently requested<br>Story #3489: "Implement password reset flow" - Security priority<br>Task #3512: "Upgrade React components to v18" - Technical debt<br>Story #3467: "Add dark mode toggle" - Quick win | **60 total**<br>(13 + 8 + 13 + 8 + 13 + 5) |
119-
| ⏳ **Deferred** | Epic #3234: "Mobile app rewrite" - Too large for single sprint<br>Feature #3445: "AI-powered recommendations" - Waiting for data science team<br>Story #3523: "Integration with external CRM" - Blocked by vendor API | 34, 21, 13 |
120-
121-
**Planning recommendations:**
122-
- **Balance**: Mix of features (3), bugs (1), technical debt (1), quick wins (1)
123-
- **Risk level**: Low-medium risk items for predictable delivery
124-
- **Dependencies**: All selected items have resolved dependencies
125-
- **Skills**: Work distribution matches current team expertise
126-
- **Business value**: Prioritized customer-facing features and critical fixes
157+
:::row:::
158+
:::column span="1":::
159+
**Component**
160+
:::column-end:::
161+
:::column span="2":::
162+
**Description**
163+
:::column-end:::
164+
:::row-end:::
165+
---
166+
:::row:::
167+
:::column span="1":::
168+
**MCP Server provides**
169+
:::column-end:::
170+
:::column span="2":::
171+
Access to backlog items, team data, and work item details
172+
:::column-end:::
173+
:::row-end:::
174+
---
175+
:::row:::
176+
:::column span="1":::
177+
**AI assistant action**
178+
:::column-end:::
179+
:::column span="2":::
180+
Helps analyze capacity and plan the sprint
181+
:::column-end:::
182+
:::row-end:::
183+
---
184+
:::row:::
185+
:::column span="1":::
186+
**Example prompt**
187+
:::column-end:::
188+
:::column span="2":::
189+
"Get all work items in the product backlog for MyProject and prioritize them for a two-week sprint with three developers"
190+
:::column-end:::
191+
:::row-end:::
192+
---
193+
:::row:::
194+
:::column span="1":::
195+
**Query translation**
196+
:::column-end:::
197+
:::column span="2":::
198+
WIQL query to retrieve backlog items with story points, priority, and state information, ordered by priority and stack rank
199+
:::column-end:::
200+
:::row-end:::
201+
---
202+
:::row:::
203+
:::column span="1":::
204+
**Raw data result**
205+
:::column-end:::
206+
:::column span="2":::
207+
Nine backlog items including epics, features, user stories, bugs, and tasks with story points and dependencies, plus team metrics (three developers, 14-day sprint, 60-point velocity)
208+
:::column-end:::
209+
:::row-end:::
210+
---
211+
:::row:::
212+
:::column span="1":::
213+
**AI assistant output**
214+
:::column-end:::
215+
:::column span="2":::
216+
|Category | Work Items | Points |
217+
|----------|------------|--------|
218+
| ✅ **Recommended** | Epic #3401: "User Profile Enhancement" - High business value, no dependencies<br>Bug #3456: "Search results time out on large datasets" - Critical user impact<br>Feature #3378: "Export dashboard to PDF" - Frequently requested<br>Story #3489: "Implement password reset flow" - Security priority<br>Task #3512: "Upgrade React components to v18" - Technical debt<br>Story #3467: "Add dark mode toggle" - Quick win | **60 total**<br>(13 + 8 + 13 + 8 + 13 + 5) |
219+
| ⏳ **Deferred** | Epic #3234: "Mobile app rewrite" - Too large for single sprint<br>Feature #3445: "AI-powered recommendations" - Waiting for data science team<br>Story #3523: "Integration with external CRM" - Blocked by vendor API | 34, 21, 13 |
220+
**Planning recommendations**|- **Balance**: Mix of features (3), bugs (1), technical debt (1), quick wins (1)<br>- **Risk level**: Low-medium risk items for predictable delivery<br>- **Dependencies**: All selected items have resolved dependencies<br>- **Skills**: Work distribution matches current team expertise<br>- **Business value**: Prioritized customer-facing features and critical fixes|
221+
:::column-end:::
222+
:::row-end:::
223+
---
127224

128225
### Code review workflow
129226

130-
| Component | Description |
131-
|-----------|-------------|
132-
| **MCP Server provides** | Pull request details and linked work item information |
133-
| **AI assistant does** | Provides business context for technical changes |
134-
| **Example prompt** | "Get details for pull request #67 and its linked work items and help me understand the business effect of these code changes" |
135-
| **API translation** | REST API calls to retrieve pull request details and linked work item information with expanded relations |
136-
| **Raw data result** | Pull request #67 (caching layer implementation, eight files changed, +156/-42 lines) and two linked work items (performance user story and settings bug) |
137-
138-
**AI assistant business context analysis:**
139-
140-
| Component | Details |
141-
|-----------|---------|
142-
| **Pull Request** | PR #67: "Implement caching layer for user preferences"<br>Author: Sarah Chen, Status: Active (awaiting review)<br>Files: 8 changed (+156, -42 lines), Created: Two days ago |
143-
| **Linked Work Items** | 🎯 User Story #2847: "Improve app performance for returning users" (High priority)<br>└── Target: Page load time < 2 seconds for logged-in users<br><br>🐛 Bug #2901: "Settings page loads slowly for users with many preferences" (Medium severity)<br>└── Impact: Affects 15% of premium users, causing support tickets |
144-
145-
**Business impact summary:**
146-
147-
| Category | Analysis |
148-
|----------|----------|
149-
| 💼 **Strategic Alignment** | Supports Q3 user retention goal (20% improvement)<br>Addresses premium user experience issues affecting revenue<br>Enables future personalization features |
150-
| 📊 **Expected Outcomes** | Performance: 60% reduction in preference loading time (2.5s → 1.0s)<br>User Experience: Eliminates loading delays in settings and profile pages<br>Support Impact: Expected 40% reduction in performance-related tickets |
151-
| 🔍 **Review Focus Areas** | Cache invalidation logic (data consistency)<br>Error handling for cache unavailability<br>Performance monitoring implementation<br>Security considerations for cached user data |
152-
153-
### Project reporting
154-
155-
| Component | Description |
156-
|-----------|-------------|
157-
| **MCP Server provides** | Access to work items, builds, and project data |
158-
| **AI assistant does** | Creates summaries and identifies trends |
159-
| **Example prompt** | "Get all completed work items from the last sprint and create a summary report for stakeholders highlighting key accomplishments and metrics" |
160-
| **Query translation** | WIQL query to retrieve completed work items from current iteration with story points and completion dates, ordered by most recent |
161-
| **Raw data result** | Six work items from last sprint including bugs, tasks, user stories, and features with completion states and story points |
162-
163-
**AI assistant stakeholder report:**
164-
165-
| Metric | Results |
166-
|--------|---------|
167-
| **Sprint Summary** | Sprint completed with two items finished, 2 in progress, 2 blocked<br>Team: MyProject, Sprint period: Last two weeks |
168-
| ✅ **Completed Work** | Bug #4521: "Sign-in page crashes on mobile Safari" - Resolved (Critical fix)<br>Task #4498: "Update API documentation for v2.1" - Done (Documentation update) |
169-
| 🔄 **In Progress** | User Story #4456: "Implement two-factor authentication" - 60% complete<br>└── Database schemas complete, UI in progress, testing pending<br><br>Bug #4534: "Performance issue with large datasets" - Investigation phase |
170-
| ⚠️ **Blocked Items** | Feature #4423: "Integration with external payment gateway"<br>└── Blocked: Waiting for security team approval (five days)<br><br>Task #4467: "Deploy to staging environment"<br>└── Impediment: Server maintenance conflict |
171-
172-
**Key accomplishments:**
173-
- **Critical bug resolved**: Mobile Safari sign-in issue affecting user access
174-
- **Documentation updated**: API v2.1 documentation completed for developer onboarding
175-
- **Security progress**: Two-factor authentication implementation 60% complete
176-
- **Performance investigation**: Dataset performance issue analysis underway
177-
178-
**Next sprint focus:**
179-
- **Complete**: Two-factor authentication implementation and testing
180-
- **Resolve**: Payment gateway integration pending security approval
181-
- **Address**: Staging deployment scheduling conflicts
182-
- **Continue**: Dataset performance optimization efforts
183-
184-
## Related content
185-
186-
- [Example prompts for Azure DevOps MCP Server](https://github.com/microsoft/azure-devops-mcp/blob/main/docs/EXAMPLES.md)
187-
- [Troubleshoot Azure DevOps MCP Server](https://github.com/microsoft/azure-devops-mcp/blob/main/docs/TROUBLESHOOTING.md)
188-
- [Frequently asked questions about Azure DevOps MCP Server](https://github.com/microsoft/azure-devops-mcp/blob/main/docs/FAQ.md)
227+
:::row:::
228+
:::column span="1":::
229+
**Component**
230+
:::column-end:::
231+
:::column span="2":::
232+
**Description**
233+
:::column-end:::
234+
:::row-end:::
235+
---
236+
:::row:::
237+
:::column span="1":::
238+
**MCP Server provides**
239+
:::column-end:::
240+
:::column span="2":::
241+
Pull request details and linked work item information
242+
:::column-end:::
243+
:::row-end:::
244+
---
245+
:::row:::
246+
:::column span="1":::
247+
**AI assistant action**
248+
:::column-end:::
249+
:::column span="2":::
250+
Provides business context for technical changes
251+
:::column-end:::
252+
:::row-end:::
253+
---
254+
:::row:::
255+
:::column span="1":::
256+
**Example prompt**
257+
:::column-end:::
258+
:::column span="2":::
259+
"Get details for pull request #67 and its linked work items and help me understand the business effect of these code changes"
260+
:::column-end:::
261+
:::row-end:::
262+
---
263+
:::row:::
264+
:::column span="1":::
265+
**API translation**
266+
:::column-end:::
267+
:::column span="2":::
268+
REST API calls to retrieve pull request details and linked work item information with expanded relations
269+
:::column-end:::
270+
:::row-end:::
271+
---
272+
:::row:::
273+
:::column span="1":::
274+
**Raw data result**
275+
:::column-end:::
276+
:::column span="2":::
277+
Pull request #67 (caching layer implementation, eight files changed, +156/-42 lines) and two linked work items (performance user story and settings bug)
278+
:::column-end:::
279+
:::row-end:::
280+
---
281+
:::row:::
282+
:::column span="1":::
283+
**AI assistant output**
284+
:::column-end:::
285+
:::column span="2":::
286+
| Component | Details |
287+
|-----------|---------|
288+
| **Pull Request** | PR #67: "Implement caching layer for user preferences"<br>Author: Sarah Chen, Status: Active (awaiting review)<br>Files: 8 changed (+156, -42 lines), Created: Two days ago |
289+
| **Linked Work Items** | 🎯 User Story #2847: "Improve app performance for returning users" (High priority)<br>└── Target: Page load time < 2 seconds for logged-in users<br><br>🐛 Bug #2901: "Settings page loads slowly for users with many preferences" (Medium severity)<br>└── Impact: Affects 15% of premium users, causing support tickets |
290+
|**Business impact summary**| - 💼 **Strategic Alignment**: Supports Q3 user retention goal (20% improvement)<br>Addresses premium user experience issues affecting revenue<br>Enables future personalization features<br>- 📊 **Expected Outcomes**: Performance: 60% reduction in preference loading time (2.5s → 1.0s)<br>User Experience: Eliminates loading delays in settings and profile pages<br>Support Impact: Expected 40% reduction in performance-related tickets<br>- 🔍 **Review Focus Areas**: Cache invalidation logic (data consistency)<br>Error handling for cache unavailability<br>Performance monitoring implementation<br>Security considerations for cached user data |
291+
:::column-end:::
292+
:::row-end:::
293+
---

0 commit comments

Comments
 (0)