Skip to content

Conversation

@joshfree
Copy link
Member

@joshfree joshfree commented Sep 26, 2025

What does this PR do?

  1. Start adding entries to the Manual IDE Setup section
  • Amazon Q, Claude, Cursor, Windsurf
image image
  1. Cleaned up the Docker section to match the other 2 package sections (which will have extra steps added by their owners in the future)
image

GitHub issue number?

N/A

Pre-merge Checklist

  • Required for All PRs
    • Read contribution guidelines
    • PR title clearly describes the change
    • Commit history is clean with descriptive messages (cleanup guide)
    • Added comprehensive tests for new/modified functionality
    • Updated servers/Azure.Mcp.Server/CHANGELOG.md and/or servers/Fabric.Mcp.Server/CHANGELOG.md for product changes (features, bug fixes, UI/UX, updated dependencies)
  • For MCP tool changes:
    • One tool per PR: This PR adds or modifies only one MCP tool for faster review cycles
    • Updated servers/Azure.Mcp.Server/README.md and/or servers/Fabric.Mcp.Server/README.md documentation
    • Updated command list in /docs/azmcp-commands.md and/or /docs/fabric-commands.md
    • For new or modified tool descriptions, ran ToolDescriptionEvaluator and obtained a score of 0.4 or more and a top 3 ranking for all related test prompts
    • For new tools associated with Azure services or publicly available tools/APIs/products, add URL to documentation in the PR description
  • Extra steps for Azure MCP Server tool changes:
    • Updated test prompts in /docs/e2eTestPrompts.md
    • 👉 For Community (non-Microsoft team member) PRs:
      • Security review: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (crypto mining, spam, data exfiltration, etc.)
      • Manual tests run: added comment /azp run mcp - pullrequest - live to run Live Test Pipeline

Fix Docker instructions, Add Manual IDE Setup
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR improves the Docker setup instructions and enhances the IDE setup documentation by providing more comprehensive guidance for manual configuration across different development environments.

  • Replaces generic "Additional IDEs" section with detailed "Manual IDE Setup" section
  • Fixes Docker instructions to provide clearer, step-by-step guidance with proper formatting
  • Adds comprehensive IDE-specific configuration table with file locations and documentation links

@joshfree joshfree self-assigned this Sep 26, 2025
@joshfree joshfree added documentation Improvements or additions to documentation server-Azure.Mcp Azure.Mcp.Server labels Sep 26, 2025
Updated instructions for running the Azure MCP Server with Docker, replacing the bash command with a JSON configuration format.
tweak docker mcp.json root node
Updated instructions for running MCP client with .env file.
@joshfree joshfree enabled auto-merge (squash) September 26, 2025 19:19
Updated instructions for configuring MCP client to include mcp.json.
Clarified instructions for configuring MCP client with Docker.
Clarify configuration instructions for Visual Studio and Visual Studio Code.
@joshfree joshfree moved this from Untriaged to In Progress in Azure MCP Server Sep 26, 2025
Updated section titles and descriptions for clarity.
Copy link
Contributor

@charris-msft charris-msft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@joshfree joshfree merged commit c785a02 into main Sep 26, 2025
23 checks passed
@joshfree joshfree deleted the joshfree-patch-1 branch September 26, 2025 21:02
@github-project-automation github-project-automation bot moved this from In Progress to Done in Azure MCP Server Sep 26, 2025
colbytimm pushed a commit to colbytimm/microsoft-mcp that referenced this pull request Sep 27, 2025
* Fix Docker instructions, Add Manual IDE Setup

Fix Docker instructions, Add Manual IDE Setup

* Update servers/Azure.Mcp.Server/README.md

Co-authored-by: Copilot <[email protected]>

* Revise Docker run instructions in README.md

Updated instructions for running the Azure MCP Server with Docker, replacing the bash command with a JSON configuration format.

* tweak docker mcp.json root node

tweak docker mcp.json root node

* Fix formatting in README for MCP client setup

Updated instructions for running MCP client with .env file.

---------

Co-authored-by: Copilot <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation server-Azure.Mcp Azure.Mcp.Server

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

8 participants