Document MCP configuration and fix deprecated workflow flag

[Copilot]

Commit 593425b introduced Model Context Protocol (MCP) for GitHub Copilot integration but left copilot.generate-tests.yml using deprecated flags and lacked documentation for the dual-token authentication pattern.

Critical Fix

.github/workflows/copilot.generate-tests.yml

• Replaced deprecated --enable-all-github-mcp-tools with --mcp-config .github/mcp.json
• Added missing GITHUB_MCP_TOKEN environment variable
• Now consistent with copilot.generate-docs.yml pattern

# Before (deprecated)
copilot -p "$PROMPT" --enable-all-github-mcp-tools --allow-all-tools

# After
env:
  GH_TOKEN: ${{ secrets.COPILOT_CLI_TOKEN }}           # Copilot API auth
  GITHUB_MCP_TOKEN: ${{ secrets.GITHUB_TOKEN }}        # GitHub operations via MCP
run: |
  copilot -p "$PROMPT" \
    --mcp-config .github/mcp.json \
    --allow-all-tools

Documentation Added

Dual-Token Pattern (docs/github-deployment.md)

• COPILOT_CLI_TOKEN: Personal PAT for Copilot API authentication (scope: copilot)
• GITHUB_TOKEN: Workflow token for MCP operations (permissions: contents: read, issues: write)

MCP Configuration (.github/mcp.json)

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_MCP_TOKEN}"
      }
    }
  }
}

Workflow Documentation (labs/agentic-ci-workflows/)

• MCP server capabilities (read repos, create issues, assign tasks)
• Workflow permissions requirements
• Troubleshooting authentication failures, configuration errors, token expiration

Local Development (docs/development.md)

• Setup instructions for using MCP with Copilot CLI locally
• Example prompts for analyzing commits, generating docs, checking test coverage
• Local troubleshooting scenarios

Coverage

• 4 documentation files updated
• 680 lines added
• All MCP-enabled workflows now documented consistently

Original prompt

---

This section details on the original issue you should resolve

<issue_title>📚 Documentation needed for commit 593425b (MCP Configuration)</issue_title>
<issue_description>## Documentation Required for Commit 593425b

Summary

Commit 593425b introduces MCP (Model Context Protocol) configuration for GitHub Copilot integration and updates workflow authentication patterns.

What Changed

1. New File: .github/mcp.json - MCP server configuration for GitHub API access
2. Workflow Update: .github/workflows/copilot.generate-docs.yml now uses:
   • GH_TOKEN for Copilot CLI authentication
   • GITHUB_MCP_TOKEN for MCP GitHub operations
   • --mcp-config flag (replaces deprecated --enable-all-github-mcp-tools)

Documentation Needed

1. Update docs/github-deployment.md

• Add section explaining MCP configuration requirements
• Document the dual-token authentication pattern:
  • COPILOT_CLI_TOKEN: Personal PAT for Copilot API
  • GITHUB_TOKEN: Workflow token for MCP operations (issues, PRs, etc.)
• Explain token scopes needed for each

2. Create/Update Workflow Documentation

• Document the .github/mcp.json configuration format
• Explain how MCP enables Copilot to interact with GitHub (create issues, assign tasks)
• Provide troubleshooting guidance for MCP authentication failures

3. Update docs/development.md or Create New MCP Guide

• Explain what MCP is and why it's used
• Document local development setup with MCP
• Provide examples of MCP-enabled Copilot capabilities

Breaking Changes

⚠️ Workflow now requires two secrets:

• COPILOT_CLI_TOKEN (existing)
• Workflow must have access to GITHUB_TOKEN with issue write permissions

Related Files

• .github/mcp.json
• .github/workflows/copilot.generate-docs.yml
• docs/github-deployment.md
• docs/development.md

---

This issue was automatically created by analyzing commit 593425b</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes 📚 Documentation needed for commit 593425b (MCP Configuration) #5

---

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