Skip to content

[WIP] Add MCP install instructions to skills#111

Open
TianqiZhang wants to merge 1 commit intoMicrosoftDocs:mainfrom
TianqiZhang:main
Open

[WIP] Add MCP install instructions to skills#111
TianqiZhang wants to merge 1 commit intoMicrosoftDocs:mainfrom
TianqiZhang:main

Conversation

@TianqiZhang
Copy link
Collaborator

If user only installed our skills but not our MCP, their agent needs to know how to install our MCP.

Copilot AI review requested due to automatic review settings February 14, 2026 02:02
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This pull request adds MCP installation instructions to all three skill documentation files to help users who have installed the skills but not the Microsoft Learn MCP Server. The changes ensure agents understand how to guide users through MCP installation when needed.

Changes:

  • Added "Prerequisites: Connect to the Microsoft Learn MCP Server" section to all three skill files
  • Included remote MCP endpoint URL, sample JSON configuration, and a link to the full installation guide
  • Placed the prerequisites section immediately after the title and before main content sections

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
skills/microsoft-skill-creator/SKILL.md Added prerequisites section with MCP installation instructions after the skill title
skills/microsoft-docs/SKILL.md Added prerequisites section with MCP installation instructions after the skill title
skills/microsoft-code-reference/SKILL.md Added prerequisites section with MCP installation instructions after the skill title

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +19 to +27
```json
{
"mcpServers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}
Copy link

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

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

The JSON configuration format uses "mcpServers" as the top-level key, but the README.md shows "servers" as the standard config format (line 67). This inconsistency could confuse users. Consider using "servers" to match the documented standard, or add a note that different MCP clients may use different configuration keys (e.g., "mcpServers", "servers", etc.).

Copilot uses AI. Check for mistakes.
Comment on lines +17 to +26
```json
{
"mcpServers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}
```
Copy link

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

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

The JSON configuration format uses "mcpServers" as the top-level key, but the README.md shows "servers" as the standard config format (line 67). This inconsistency could confuse users. Consider using "servers" to match the documented standard, or add a note that different MCP clients may use different configuration keys (e.g., "mcpServers", "servers", etc.).

Copilot uses AI. Check for mistakes.
Comment on lines +17 to +26
```json
{
"mcpServers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}
```
Copy link

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

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

The JSON configuration format uses "mcpServers" as the top-level key, but the README.md shows "servers" as the standard config format (line 67). This inconsistency could confuse users. Consider using "servers" to match the documented standard, or add a note that different MCP clients may use different configuration keys (e.g., "mcpServers", "servers", etc.).

Copilot uses AI. Check for mistakes.
@TianqiZhang TianqiZhang changed the title Add MCP install instructions to skills [WIP] Add MCP install instructions to skills Feb 14, 2026
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.

1 participant