[docs] docs: unbloat guides/mcps.md

[github-actions]

Reduces docs/src/content/docs/guides/mcps.md from 202 to 162 lines (-19.8%) while preserving all essential technical content.

What was removed

• Redundant intro (3 paragraphs → 1): Removed restatement of the title, MCP's 4-item use-case list, and duplicated "built-in GitHub MCP" sentence
• Verbose Important note (3 paragraphs → 1): Condensed the read-only design rationale to a single actionable sentence; also fixed typo afe outputs → safe outputs
• Duplicate HTTP example: microsoftdocs server appeared in both the "Manually Configuring" section and the "HTTP MCP Servers" section; removed the duplicate from the latter
• mcp add code block: Replaced 5 separate commands (each with a blank line + comment above) with an inline-commented single block (saves ~9 lines)
• Standalone "Use ["*"]..." paragraph: Integrated into the code comment in the MCP Tool Filtering section
• Separate "External Resources" section: Merged into Related Documentation (saves heading + blank lines)
• Verbose Shared MCP description: Condensed "are available in the GitHub Agentics Workflow repository … for common tools and services. These can be copied into your own workflows or imported directly." to one short clause

Screenshots

Screenshots could not be captured: Playwright runs with --network host (Docker host perspective) but the agent container's bridge IP (172.30.0.20) is on a separate subnet not routable from the Docker host. The curl check confirms the page returns HTTP 200.

References:

• §23523547204

🗜️ Compressed by Documentation Unbloat · ◷

• expires on Mar 27, 2026, 3:46 AM UTC

[Copilot]

Pull request overview

This PR streamlines the “Using Custom MCP Servers” guide by removing redundant explanations and consolidating examples while keeping the core configuration guidance intact.

Changes:

• Condensed the introductory and IMPORTANT sections to reduce repetition and improve readability.
• Removed duplicate/verbose examples (notably the repeated HTTP example) and tightened CLI usage snippets.
• Merged the “External Resources” links into the existing “Related Documentation” section.

---

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

[Copilot]

The default MCP registry URL here is documented as https://api.mcp.github.com/v0, but the CLI/codebase defaults to https://api.mcp.github.com/v0.1 (see pkg/constants/constants.go and pkg/cli/mcp_add.go). Please update the docs to match the actual default to avoid users pointing at the wrong registry endpoint.

Suggested change

	Use `gh aw mcp add` to browse and add servers from the GitHub MCP registry (default: `https://api.mcp.github.com/v0`):
	Use `gh aw mcp add` to browse and add servers from the GitHub MCP registry (default: `https://api.mcp.github.com/v0.1`):