Azure Wiki Search + GitHub Copilot (VS Code): Complete MCP Integration

Azure Wiki Search is a MCP server that An MCP server that enables AI to query and search Azure DevOps Wiki content with intelligent search capabilities..

When integrated with GitHub Copilot (VS Code), you can:

• Search Azure DevOps Wiki content with AI-powered queries
• Retrieve specific wiki pages by path or identifier

This guide provides step-by-step instructions to set up Azure Wiki Search in GitHub Copilot (VS Code), including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

• Azure Wiki Search will be fully integrated and operational
• You can use Azure Wiki Search tools directly in GitHub Copilot (VS Code)
• All Azure Wiki Search capabilities will be available for your workflows
• Access to 2 different tools

Prerequisites

Before starting, ensure you have:

• Azure DevOps organization name
• Azure DevOps project name
• GitHub Copilot (VS Code) installed and configured
• Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Azure Wiki Search

Configuration

Step 2: Configure GitHub Copilot (VS Code)

1. Locate your configuration file:

   • Windows: .vscode\\mcp.json in your project directory
   • macOS: .vscode/mcp.json in your project directory
   • Linux: .vscode/mcp.json in your project directory

2. Add server configuration:

{
  "mcpServers": {
    "azure-wiki-search": {
      "command": "azure wiki search",
      "args": [],
      "env": {
        "ORG": "microsoft",
        "PROJECT": "Edge",
        "AZURE_DEVOPS_PAT": "your-pat-token-here"
      }
    }
  }
}

3. Restart GitHub Copilot (VS Code)

Completely quit and restart GitHub Copilot (VS Code) to load the new configuration.

Examples

Once configured, you can use Azure Wiki Search in GitHub Copilot (VS Code):

Search Technical Documentation

Find relevant technical documentation in Azure Wiki

Ask GitHub Copilot (VS Code): "Search for API authentication documentation in the Edge project"

Expected Result: Relevant wiki pages containing authentication setup and API documentation

Retrieve Specific Wiki Page

Get content from a known wiki page path

Ask GitHub Copilot (VS Code): "Get the content from /docs/setup/installation.md"

Expected Result: Full content of the installation documentation page

Find Troubleshooting Guides

Search for problem-solving documentation

Ask GitHub Copilot (VS Code): "Find troubleshooting guides for deployment issues"

Expected Result: Wiki pages containing deployment troubleshooting information

Testing Your Setup

1. Start a new conversation in GitHub Copilot (VS Code)
2. Ask GitHub Copilot (VS Code) to list available tools
3. Try using Azure Wiki Search functionality

Test prompts:

• "What MCP tools are available?"
• "Use Azure Wiki Search to help with my code"
• "Show me what Azure Wiki Search can do"

Troubleshooting

Common Issues

Authentication Failed

Symptoms: Access denied to wiki, Unauthorized errors, PAT token rejected

Cause: Missing or invalid Azure DevOps Personal Access Token

Solution:

• Generate PAT in Azure DevOps with Wiki read permissions
• Set AZURE_DEVOPS_PAT environment variable
• Verify PAT has access to specified organization/project
• Check PAT expiration date

Organization/Project Not Found

Symptoms: Project not found errors, Organization does not exist

Cause: Invalid ORG or PROJECT configuration

Solution:

• Verify organization name matches Azure DevOps URL
• Confirm project exists and is accessible
• Check spelling and case sensitivity
• Use --org and --project parameters to override defaults

Wiki Content Not Found

Symptoms: No search results, Wiki path not found, Empty responses

Cause: Wiki not configured or content not available

Solution:

• Verify project has Wiki enabled
• Check wiki content exists in specified project
• Confirm search terms match available content
• Try broader search queries initially

uv Environment Issues

Symptoms: Command not found, Package installation fails, Virtual env errors

Cause: uv not installed or virtual environment not activated

Solution:

• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Activate virtual environment before running
• Ensure Python 3.10+ is available
• Reinstall dependencies if corruption occurred

MCP Configuration Not Loaded

Symptoms: MCP tools not appearing, Copilot does not recognize MCP server

Cause: Configuration file not in correct location or invalid JSON

Solution:

• Verify .vscode/mcp.json exists in project root directory
• Check JSON syntax is valid (no trailing commas, proper quotes)
• Reload VS Code window after making configuration changes
• Check VS Code Developer Tools (Help > Toggle Developer Tools) for errors

MCP Server Not Starting

Symptoms: Tools listed but not responding, Server connection errors

Cause: Server command path incorrect or dependencies missing

Solution:

• Test the MCP server command independently in terminal
• Verify all server prerequisites are installed
• Check that command path is correct (use absolute paths if needed)
• Ensure required environment variables are set in mcp.json
• Review VS Code Output panel for MCP server error messages

GitHub Copilot Subscription Required

Symptoms: Copilot features grayed out, Unable to access Copilot Chat

Cause: No active GitHub Copilot subscription

Solution:

• Sign up for GitHub Copilot subscription (Individual, Business, or Enterprise)
• Verify subscription is active in GitHub account settings
• Re-authenticate GitHub Copilot in VS Code
• Check that VS Code is using correct GitHub account

VS Code Version Too Old

Symptoms: MCP configuration ignored, No mcp.json recognition

Cause: VS Code version below 1.99 does not have native MCP support

Solution:

• Update VS Code to version 1.99 or later
• Check current version: Help > About
• Download latest version from code.visualstudio.com
• After updating, reload window and verify MCP support

{server_name} Tools Not Working

Symptoms: Server connected but tools fail, Error messages when invoking tools

Cause: Server-specific configuration or authentication issues

Solution:

• Verify all required environment variables for {server_name} are set
• Check {server_name} documentation for specific prerequisites
• Test {server_name} with another MCP client to isolate issue
• Review error messages in VS Code Output panel for specific failures

Azure Wiki Search not appearing in GitHub Copilot (VS Code)

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

• Verify configuration syntax
• Check Azure Wiki Search installation
• Restart GitHub Copilot (VS Code)
• Check logs for error messages

Next Steps

Now that Azure Wiki Search is integrated with GitHub Copilot (VS Code):

• Explore all Azure Wiki Search capabilities through GitHub Copilot (VS Code)
• Check out other MCP servers that work with GitHub Copilot (VS Code)
• Join the MCP community for tips and support
• Consider contributing to Azure Wiki Search development

Need Help?

• Search for Azure Wiki Search documentation
• Check the GitHub Copilot (VS Code) MCP guide
• Join the MCP community discussions