Add --mcp flag to init command for Copilot Agent MCP configuration by Copilot · Pull Request #2733 · github/gh-aw

Copilot · 2025-10-29T12:24:32Z

Implementation Complete: --mcp Flag for Init Command

Problem Statement

The issue requested adding support for configuring the gh-aw MCP server in GitHub Copilot Agent workflows by:

Researching how to create action YAML files for Copilot Agent custom setup steps
Adding a --mcp flag to the init command to configure MCP integration

Solution Implemented

Added --mcp flag to gh aw init command that automatically configures:

.github/workflows/copilot-setup-steps.yml - GitHub Copilot Agent setup workflow
.vscode/mcp.json - VS Code MCP server configuration

Usage:

gh aw init --mcp

Recent Updates (addressing PR feedback)

✅ Removed "Install gh CLI" step (gh CLI is pre-installed in GitHub Actions runners)
✅ Simplified extension installation to gh extension install githubnext/gh-aw (no upgrade check for fresh installs)
✅ Refactored step injection to use YAML unmarshalling/marshalling instead of string manipulation
✅ Updated tests to match new behavior

Implementation Checklist

Files Created

pkg/cli/copilot_setup.go - Generates copilot-setup-steps.yml with YAML-based injection logic
pkg/cli/mcp_config_file.go - Generates/updates .vscode/mcp.json
pkg/cli/init_mcp_test.go - Comprehensive test suite

Files Modified

pkg/cli/init_command.go - Added --mcp flag
pkg/cli/init.go - Updated InitRepository function
pkg/cli/init_test.go - Updated tests
docs/src/content/docs/tools/cli.md - CLI documentation
docs/src/content/docs/tools/mcp-server.md - MCP server documentation

Key Features

✅ Idempotent: Won't overwrite existing customized files
✅ Smart Injection: Adds extension install step to existing files if missing using proper YAML parsing
✅ Preserves Config: Merges with existing mcp.json servers
✅ Simplified Setup: Removes unnecessary steps (gh CLI pre-installed)
✅ Proper YAML Handling: Uses unmarshalling/marshalling for reliable file updates
✅ Complete Testing: All unit tests pass
✅ Well-Documented: Complete documentation with examples
✅ Backward Compatible: No breaking changes

Generated copilot-setup-steps.yml

name: "Copilot Setup Steps"jobs:
copilot-setup-steps:
runs-on: ubuntu-latestpermissions:
contents: readsteps:
- name: Checkout codeuses: actions/checkout@v5
- name: Set up Gouses: actions/setup-go@v5with:
go-version-file: go.modcache: true
- name: Install gh-aw extensionrun: gh extension install githubnext/gh-awenv:
GH_TOKEN: ${{ github.token }}
- name: Build gh-aw from sourcerun: make buildcontinue-on-error: true
- name: Verify gh-aw installationrun: gh aw version || ./gh-aw version

Testing

✅ All unit tests pass
✅ Manual testing verified
✅ Code review passed
✅ Backward compatibility verified
✅ Documentation reviewed
✅ PR feedback addressed (YAML parsing approach)

Original prompt

This section details on the original issue you should resolve
<issue_title>Configuring copilot agent MCP</issue_title>
<issue_description>/scout
research how to create a action yml file to configuration custom steps to run in the github copilot agent job. Collects docs url + critical information to leverage this feature
add a "--mcp" flag to the "init" command that configures copilot agent with the gh-aw mcp: add gh-aw mcp server definition to mcps.json, add steps to install the extension in copilot steps</issue_description>
Comments on the Issue (you are @copilot in this section)
@pelikhan Use the information above to create a command to adds or update the steps to install the gh aw extension and create/update the MCP configuration to add the MCP-server command as MCP server

FixesConfiguring copilot agent MCP #2728

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2025-10-29T13:31:04Z

+ go-version-file: go.mod
+ cache: true
+
+ - name: Install gh CLI


@copilot pre-installed, remove step

Removed the "Install gh CLI" step in commit 22ff732. The gh CLI is pre-installed in GitHub Actions runners, so this step is unnecessary.

pelikhan · 2025-10-29T13:31:32Z

+ echo "GitHub CLI already installed"
+ fi
+
+ - name: Install gh-aw extension


@copilot always a fresh install so don't check for updates

Simplified the extension installation to just gh extension install githubnext/gh-aw in commit 22ff732. Removed the upgrade check since it's always a fresh install in the setup steps.

pelikhan · 2025-10-29T13:32:10Z

+	if _, err := os.Stat(setupStepsPath); err == nil {
+ copilotSetupLog.Printf("File already exists: %s", setupStepsPath)
+ // File exists, skip creation to avoid overwriting user customizations
+ if verbose {


@copilot inject extension install step if not found

Added injection logic in commit 22ff732. The function now reads existing copilot-setup-steps.yml files and injects the extension install step after the "Set up Go" step if it's not already present. The injection is idempotent - it won't inject if the step already exists.

…l, add step injection - Remove "Install gh CLI" step (pre-installed in GitHub Actions) - Simplify extension installation to just install (no upgrade check) - Add logic to inject extension install step into existing files - Update tests to match new behavior Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2025-10-29T16:20:20Z

@copilot to inject steps, unmarshall yml, add steps, Marshall yml

- Replace string manipulation with proper YAML parsing - Add WorkflowStep, WorkflowJob, and Workflow structs - Use goccy/go-yaml for unmarshalling and marshalling - Improves reliability and maintainability of step injection Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-10-29T16:28:47Z

@copilot to inject steps, unmarshall yml, add steps, Marshall yml

Refactored to use YAML unmarshalling/marshalling in commit f14b821. The code now:

Unmarshals the existing YAML workflow into structs
Adds the extension install step at the correct position
Marshals back to YAML

This approach is more reliable and maintainable than string manipulation.

github-actions · 2025-10-29T16:47:58Z

Agentic Changeset Generator triggered by this pull request.

Copilot

Pull Request Overview

This PR adds MCP (Model Context Protocol) server configuration support to the init command, enabling automatic setup of GitHub Copilot Agent integration.

Added --mcp flag to the init command to configure GitHub Copilot Agent MCP server integration
Created new functionality to generate .vscode/mcp.json and .github/workflows/copilot-setup-steps.yml files
Updated all test cases to accommodate the new parameter signature

Reviewed Changes

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

Show a summary per file

File	Description
pkg/cli/mcp_config_file.go	New file implementing MCP configuration file creation and management for .vscode/mcp.json
pkg/cli/copilot_setup.go	New file implementing GitHub Actions workflow generation for Copilot setup steps
pkg/cli/init_command.go	Added --mcp flag and updated command documentation
pkg/cli/init.go	Added MCP configuration logic when --mcp flag is enabled
pkg/cli/init_test.go	Updated test calls to include new mcp parameter
pkg/cli/init_mcp_test.go	New comprehensive test suite for MCP integration functionality
docs/src/content/docs/tools/mcp-server.md	Added documentation for GitHub Copilot Agent configuration
docs/src/content/docs/tools/cli.md	Added documentation for --mcp flag usage

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

Copilot · 2025-10-29T16:50:32Z

+ Name: "Install gh-aw extension",
+ Run: "gh extension install githubnext/gh-aw",
+ Env: map[string]any{
+ "GH_TOKEN": "${{ github.token }}",


The environment variable uses a Go template syntax in a YAML constant that will be marshaled. Consider whether this syntax will be preserved correctly when marshaling the Env map[string]any field. The string literal ${{ github.token }} should remain as-is in the output YAML.
Suggested change
"GH_TOKEN": "${{ github.token }}",
"GH_TOKEN": yaml.String("${{ github.token }}"),

Copilot · 2025-10-29T16:50:33Z

+ existingJSON, _ := json.Marshal(existingConfig)
+ newJSON, _ := json.Marshal(ghAwConfig)


Marshal errors are silently ignored. While unlikely to fail for these simple structs, the error handling should be consistent with the rest of the function. Consider handling these errors or adding a comment explaining why they can be safely ignored.
Suggested change
existingJSON, _:=json.Marshal(existingConfig)
newJSON, _:=json.Marshal(ghAwConfig)
existingJSON, err:=json.Marshal(existingConfig)
iferr!=nil {
returnfmt.Errorf("failed to marshal existing MCP server config: %w", err)
}
newJSON, err:=json.Marshal(ghAwConfig)
iferr!=nil {
returnfmt.Errorf("failed to marshal new MCP server config: %w", err)
}

Copilot · 2025-10-29T16:50:33Z

+**With `--mcp` flag:**
+- Creates `.github/workflows/copilot-setup-steps.yml` with steps to install the gh-aw extension
+- Creates `.vscode/mcp.json` with gh-aw MCP server configuration
+- Enables the gh-aw MCP server in GitHub Copilot Agent, providing tools like `status`, `compile`, `logs`, and `audit`


[nitpick] The documentation mentions 'Enables the gh-aw MCP server in GitHub Copilot Agent' but the workflow created is copilot-setup-steps.yml which sets up the environment. Consider clarifying that this configures the environment for the MCP server rather than enabling it directly in the agent.
Suggested change
-Enables the gh-aw MCP server in GitHub Copilot Agent, providing tools like `status`, `compile`, `logs`, and `audit`
-Configures the environment for the gh-aw MCP server in GitHub Copilot Agent, providing tools like `status`, `compile`, `logs`, and `audit`

Initial plan
a4d0cfa

CopilotAI assigned Copilot and pelikhan Oct 29, 2025

Copilotstarted work on behalf of pelikhan October 29, 2025 12:25 View session

CopilotAIand others added 3 commits October 29, 2025 12:31

Initial exploration: understand copilot agent MCP configuration
b88fbb3
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Add --mcp flag to init command for Copilot Agent MCP configuration
d632411
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Update documentation for --mcp flag in init command
88e7591
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

CopilotAI changed the title ~~[WIP] Add configuration for Copilot Agent MCP~~Add --mcp flag to init command for Copilot Agent MCP configurationOct 29, 2025

CopilotAI requested a review from pelikhan October 29, 2025 12:47

Copilotfinished work on behalf of pelikhan October 29, 2025 12:47

pelikhan reviewed Oct 29, 2025
View reviewed changes

Copilotstarted work on behalf of pelikhan October 29, 2025 13:33 View session

Copilotstarted work on behalf of pelikhan October 29, 2025 16:20 View session

CopilotAI requested a review from pelikhan October 29, 2025 16:29

Copilotfinished work on behalf of pelikhan October 29, 2025 16:29

pelikhan approved these changes Oct 29, 2025
View reviewed changes

pelikhan marked this pull request as ready for review October 29, 2025 16:47

CopilotAI review requested due to automatic review settings October 29, 2025 16:47

CopilotAI reviewed Oct 29, 2025
View reviewed changes

Add changeset for --mcp flag feature [skip-ci]
11e92bc

pelikhan merged commit 36aa429 into mainOct 29, 2025
4 checks passed

pelikhan deleted the copilot/configure-copilot-agent-mcp branch October 29, 2025 21:25

This was referenced Mar 12, 2026
[P1] Lockdown token failures: Issue Monster, PR Triage Agent, Daily Issues Report, Org Health Report #20643
Closed
Workflow Health Dashboard — 2026-03-12 #20645
Closed

	"GH_TOKEN": "${{ github.token }}",
	"GH_TOKEN": yaml.String("${{ github.token }}"),

		existingJSON, _ := json.Marshal(existingConfig)
		newJSON, _ := json.Marshal(ghAwConfig)

-existingJSON, _:=json.Marshal(existingConfig)
-newJSON, _:=json.Marshal(ghAwConfig)
+existingJSON, err:=json.Marshal(existingConfig)
+iferr!=nil {
+returnfmt.Errorf("failed to marshal existing MCP server config: %w", err)
+ }
+newJSON, err:=json.Marshal(ghAwConfig)
+iferr!=nil {
+returnfmt.Errorf("failed to marshal new MCP server config: %w", err)
+ }

	-Enables the gh-aw MCP server in GitHub Copilot Agent, providing tools like `status`, `compile`, `logs`, and `audit`
	-Configures the environment for the gh-aw MCP server in GitHub Copilot Agent, providing tools like `status`, `compile`, `logs`, and `audit`

Uh oh!

Conversation

CopilotAI commented Oct 29, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Implementation Complete: --mcp Flag for Init Command

Problem Statement

Solution Implemented

Recent Updates (addressing PR feedback)

Implementation Checklist

Files Created

Files Modified

Key Features

Generated copilot-setup-steps.yml

Testing

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

Uh oh!

pelikhanOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

pelikhanOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

pelikhanOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

pelikhan commented Oct 29, 2025

Uh oh!

CopilotAI commented Oct 29, 2025

Uh oh!

github-actionsBot commented Oct 29, 2025

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

CopilotAIOct 29, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

CopilotAI commented Oct 29, 2025•
edited
Loading