Skip to content

Add Microsoft Docs MCP shared workflow and import it in scout.md#1298

Merged
pelikhan merged 4 commits intomainfrom
copilot/add-shares-agentic-workflow
Oct 7, 2025
Merged

Add Microsoft Docs MCP shared workflow and import it in scout.md#1298
pelikhan merged 4 commits intomainfrom
copilot/add-shares-agentic-workflow

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Oct 7, 2025

This PR adds support for the Microsoft Docs MCP server to the Scout research agent workflow, enabling it to access Microsoft documentation during research tasks.

Changes

New Shared MCP Configuration

Created .github/workflows/shared/microsoftdocs-mcp.md containing the Microsoft Docs MCP server configuration:

---
mcp-servers:
  microsoftdocs:
    url: "https://learn.microsoft.com/api/mcp"
    allowed: ["*"]
---

This follows the same pattern as existing shared MCP configurations (tavily-mcp.md, markitdown-mcp.md) and configures an HTTP-based MCP server.

Updated Scout Workflow

Modified .github/workflows/scout.md to import the Microsoft Docs MCP server by adding it to the imports section:

imports:
  - shared/tavily-mcp.md
  - shared/microsoftdocs-mcp.md

Result

The Scout agent now has access to both Tavily (web search) and Microsoft Docs (documentation) MCP servers, enhancing its research capabilities with authoritative Microsoft technical documentation.

The compiled workflow (scout.lock.yml) correctly includes:

  • MCP server configuration for Microsoft Docs with type "http"
  • Tool allow-lists for microsoftdocs and microsoftdocs(*)
  • Proper integration with the Copilot CLI command

Testing

  • ✅ All unit tests pass
  • ✅ Workflow compiles successfully with gh aw compile scout
  • ✅ Both Tavily and Microsoft Docs MCP servers are present in the compiled scout.lock.yml
  • ✅ No breaking changes to existing functionality
Original prompt

Add shares agentic workflow for https://github.com/mcp/microsoftdocs/mcp and import it in scout.md .


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits October 7, 2025 12:09
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add shares agentic workflow for Microsoft Docs Add Microsoft Docs MCP shared workflow and import it in scout.md Oct 7, 2025
Copilot AI requested a review from pelikhan October 7, 2025 12:17
@pelikhan
Copy link
Copy Markdown
Collaborator

pelikhan commented Oct 7, 2025

@copilot the url is incorrect it should be https://learn.microsoft.com/api/mcp

Review Microsoft docs MCP docs

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Oct 7, 2025

@copilot the url is incorrect it should be https://learn.microsoft.com/api/mcp

Review Microsoft docs MCP docs

Fixed in commit 522ca0b. Updated the URL from https://github.com/mcp/microsoftdocs/mcp to https://learn.microsoft.com/api/mcp in the shared microsoftdocs-mcp.md file and recompiled the scout workflow.

@pelikhan pelikhan marked this pull request as ready for review October 7, 2025 12:45
@pelikhan pelikhan merged commit 4b6aaa5 into main Oct 7, 2025
14 checks passed
@pelikhan pelikhan deleted the copilot/add-shares-agentic-workflow branch October 7, 2025 12:45
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.

2 participants