Skip to content

Fix Azure MCP server configuration and resolve schema validation errors#39017

Merged
Sharra-writes merged 2 commits into
github:mainfrom
morihaya:patch-coding-agent-examples
Jun 23, 2025
Merged

Fix Azure MCP server configuration and resolve schema validation errors#39017
Sharra-writes merged 2 commits into
github:mainfrom
morihaya:patch-coding-agent-examples

Conversation

@morihaya

@morihaya morihaya commented Jun 23, 2025 •
edited
Loading

Copy link
Copy Markdown
Contributor

Why:

Closes: #39016

What's being changed (if available, include any code snippets, screenshots, or gifs):

This commit addresses multiple critical issues in the Azure MCP server setup example that were preventing successful configuration:

  • Change environment name from "Copilot" to "copilot" for consistency with lowercase naming convention used throughout the documentation
  • Update azure/login action to v2.3.0 (a457da9ea143d694b1b9c7c869ebb04ebe844ef5) which is the latest stable version and has been verified to work correctly
  • Add proper {% raw %} Liquid tags around GitHub Actions secret references to prevent Liquid template processing of the workflow syntax
  • Fix server name from "Azure MCP Server" to "Azure" to resolve schema validation error "Schema validation failed: /mcpServers must NOT have additional properties"
  • Add required "tools" configuration with ["*"] to prevent schema validation error "Schema validation failed: /mcpServers must NOT have additional properties"

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

@morihaya
Fix Azure MCP server configuration and resolve schema validation errors
dafa885 
This commit addresses multiple critical issues in the Azure MCP server setup example
that were preventing successful configuration:

* Change environment name from "Copilot" to "copilot" for consistency with
  lowercase naming convention used throughout the documentation
* Update azure/login action to v2.3.0 (a457da9ea143d694b1b9c7c869ebb04ebe844ef5)
  which is the latest stable version and has been verified to work correctly
* Add proper {% raw %} Liquid tags around GitHub Actions secret references
  to prevent Liquid template processing of the workflow syntax
* Fix server name from "Azure MCP Server" to "Azure" to resolve schema validation
  error "Schema validation failed: /mcpServers must NOT have additional properties"
* Add required "tools" configuration with ["*"] to prevent schema validation
  error "Schema validation failed: /mcpServers must NOT have additional properties"

These corrections address specific schema validation failures that were blocking
MCP server configuration and ensure the Azure example provides working,
copy-paste ready configuration that passes validation
@welcome

welcome Bot commented Jun 23, 2025

Copy link
Copy Markdown

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions github-actions Bot added the triage Do not begin working on this issue until triaged by the team label Jun 23, 2025
@github-actions

github-actions Bot commented Jun 23, 2025 •
edited
Loading

Copy link
Copy Markdown
Contributor

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp.md fpt
ghec
 fpt
ghec

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@Sharra-writes Sharra-writes added content This issue or pull request belongs to the Docs Content team and removed triage Do not begin working on this issue until triaged by the team labels Jun 23, 2025
@Sharra-writes

Sharra-writes commented Jun 23, 2025

Copy link
Copy Markdown
Contributor

@morihaya Thanks for these fixes! I've confirmed that they all make sense, so I'll merge this once checks are passing.

@Sharra-writes Sharra-writes added this pull request to the merge queue Jun 23, 2025
Merged via the queue into github:main with commit f81c417 Jun 23, 2025
41 checks passed
@github-actions

github-actions Bot commented Jun 23, 2025

Copy link
Copy Markdown
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues ⚡

@morihaya morihaya deleted the patch-coding-agent-examples branch June 24, 2025 00:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Sharra-writes Sharra-writes Sharra-writes approved these changes

Assignees

No one assigned

Labels

content This issue or pull request belongs to the Docs Content team

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Inaccurate Azure MCP server configuration example in "Extending Copilot coding agent with the Model Context Protocol (MCP)" documentation

2 participants

@morihaya @Sharra-writes