microsoft/hve-core
Publicmirrored fromhttps://github.com/microsoft/hve-coreAvailable
docs/getting-started/mcp-configuration.md
206lines · modecode
| 1 | --- |
| 2 | title: MCP Server Configuration |
| 3 | description: Optional configuration for Model Context Protocol servers used by HVE Core agents |
| 4 | sidebar_position: 7 |
| 5 | author: Microsoft |
| 6 | ms.date: 2026-03-10 |
| 7 | ms.topic: how-to |
| 8 | keywords: |
| 9 | - mcp |
| 10 | - configuration |
| 11 | - azure devops |
| 12 | - github |
| 13 | - context7 |
| 14 | - figma |
| 15 | - figjam |
| 16 | estimated_reading_time: 8 |
| 17 | --- |
| 18 | |
| 19 | Some HVE Core agents use Model Context Protocol (MCP) servers to integrate with external services. MCP configuration is optional; agents that depend on MCP tools indicate when the required server is unavailable. |
| 20 | |
| 21 | > [!TIP] |
| 22 | > The HVE Core installer skill auto-generates MCP configuration with curated servers and guides you through choosing the right installation method (peer clone, submodule, git-ignored, and others). Install the [HVE Core Installer](https://marketplace.visualstudio.com/items?itemName=ise-hve-essentials.hve-installer) extension and ask any agent "help me customize hve-core installation" for guided setup. The sections below cover manual MCP configuration. |
| 23 | |
| 24 | ## Overview |
| 25 | |
| 26 | MCP tools extend GitHub Copilot's capabilities by connecting to external services. HVE Core references five curated MCP servers. Configure only the servers relevant to your workflow. |
| 27 | |
| 28 | ## Choosing GitHub vs Azure DevOps |
| 29 | |
| 30 | Most teams use one primary platform for repository hosting and work item management: |
| 31 | |
| 32 | | Repository Hosted On | Configure | Do Not Configure | |
| 33 | |-------------------------|-----------------|------------------| |
| 34 | | GitHub | `github` server | `ado` server | |
| 35 | | Azure DevOps | `ado` server | `github` server | |
| 36 | | GitLab, Bitbucket, etc. | Neither | Both | |
| 37 | |
| 38 | Configuring both is unnecessary unless you work across platforms. If you use other Git hosting or work item systems (GitLab, Jira, etc.), configuration differs and is not documented here. |
| 39 | |
| 40 | ## Agent MCP Dependencies |
| 41 | |
| 42 | | Agent / Prompt | MCP Servers Used | Notes | |
| 43 | |------------------------|--------------------------|---------------------------------| |
| 44 | | ado-prd-to-wit | ado, microsoft-docs | ADO work item creation | |
| 45 | | github-backlog-manager | github | GitHub backlog management | |
| 46 | | task-researcher | context7, microsoft-docs | Documentation lookup (optional) | |
| 47 | | task-planner | context7, microsoft-docs | Documentation lookup (optional) | |
| 48 | | rpi-agent | Varies by subagent | Delegates to specialized agents | |
| 49 | | dt-figma-export | figma | DT artifact export to FigJam | |
| 50 | |
| 51 | Agents without MCP dependencies work without any MCP configuration. |
| 52 | |
| 53 | ## Curated MCP Servers |
| 54 | |
| 55 | HVE Core documents these five MCP servers: |
| 56 | |
| 57 | ### context7 |
| 58 | |
| 59 | Library and SDK documentation lookup. |
| 60 | |
| 61 | | Property | Value | |
| 62 | |----------|-------------------------| |
| 63 | | Type | stdio | |
| 64 | | Package | `@upstash/context7-mcp` | |
| 65 | |
| 66 | ### microsoft-docs |
| 67 | |
| 68 | Microsoft Learn documentation access. |
| 69 | |
| 70 | | Property | Value | |
| 71 | |----------|---------------------------------------| |
| 72 | | Type | http | |
| 73 | | URL | `https://learn.microsoft.com/api/mcp` | |
| 74 | |
| 75 | ### ado (Azure DevOps) |
| 76 | |
| 77 | Azure DevOps work items, pipelines, and repositories. |
| 78 | |
| 79 | | Property | Value | |
| 80 | |----------|---------------------------------------| |
| 81 | | Type | stdio | |
| 82 | | Package | `@azure-devops/mcp` | |
| 83 | | Requires | Organization name, optional tenant ID | |
| 84 | |
| 85 | ### github |
| 86 | |
| 87 | GitHub repository and issue management. |
| 88 | |
| 89 | | Property | Value | |
| 90 | |----------|--------------------------------------| |
| 91 | | Type | http | |
| 92 | | URL | `https://api.githubcopilot.com/mcp/` | |
| 93 | |
| 94 | ### figma |
| 95 | |
| 96 | Figma and FigJam board creation and reading. |
| 97 | |
| 98 | | Property | Value | |
| 99 | |---------------|-----------------------------------| |
| 100 | | Type | http | |
| 101 | | URL | `https://mcp.figma.com/mcp` | |
| 102 | | Auth | Browser-based OAuth on first call | |
| 103 | | Local install | None | |
| 104 | | Used by | `dt-figma-export` prompt | |
| 105 | |
| 106 | The Figma MCP server requires a Figma account with a Dev or Full seat on a Professional, Organization, or Enterprise plan for sustained usage. Starter plans are limited to 6 tool calls per month. Authentication happens automatically via browser OAuth on first use. |
| 107 | |
| 108 | ## Complete Configuration Template |
| 109 | |
| 110 | Copy this template to `.vscode/mcp.json` in your workspace root. Remove servers you do not need (typically keep either `github` or `ado`, not both). |
| 111 | |
| 112 | ```json |
| 113 | { |
| 114 | "inputs": [ |
| 115 | { |
| 116 | "id": "ado_org", |
| 117 | "type": "promptString", |
| 118 | "description": "Azure DevOps organization name (e.g. 'contoso')", |
| 119 | "default": "" |
| 120 | }, |
| 121 | { |
| 122 | "id": "ado_tenant", |
| 123 | "type": "promptString", |
| 124 | "description": "Azure tenant ID (required for multi-tenant scenarios)", |
| 125 | "default": "" |
| 126 | } |
| 127 | ], |
| 128 | "servers": { |
| 129 | "context7": { |
| 130 | "type": "stdio", |
| 131 | "command": "npx", |
| 132 | "args": ["-y", "@upstash/context7-mcp"] |
| 133 | }, |
| 134 | "microsoft-docs": { |
| 135 | "type": "http", |
| 136 | "url": "https://learn.microsoft.com/api/mcp" |
| 137 | }, |
| 138 | "ado": { |
| 139 | "type": "stdio", |
| 140 | "command": "npx", |
| 141 | "args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "--tenant", "${input:ado_tenant}", "-d", "core", "work", "work-items", "search", "repositories", "pipelines"] |
| 142 | }, |
| 143 | "github": { |
| 144 | "type": "http", |
| 145 | "url": "https://api.githubcopilot.com/mcp/" |
| 146 | }, |
| 147 | "figma": { |
| 148 | "type": "http", |
| 149 | "url": "https://mcp.figma.com/mcp" |
| 150 | } |
| 151 | } |
| 152 | } |
| 153 | ``` |
| 154 | |
| 155 | ## Method-Specific Notes |
| 156 | |
| 157 | ### Extension Users |
| 158 | |
| 159 | The VS Code extension provides agents without MCP configuration. Create `.vscode/mcp.json` in your project directory if you want to use MCP-dependent features. |
| 160 | |
| 161 | ### Peer Clone / Submodule / Git-Ignored Users |
| 162 | |
| 163 | Create `.vscode/mcp.json` in your workspace root (not inside the hve-core folder). VS Code reads MCP configuration only from the workspace root. |
| 164 | |
| 165 | ### Codespaces / Devcontainer Users |
| 166 | |
| 167 | Create `.vscode/mcp.json` in your repository's `.vscode/` folder. The file will be available inside the container at the workspace root. |
| 168 | |
| 169 | ### Multi-Root Workspace Users |
| 170 | |
| 171 | MCP configuration can be placed in the `.code-workspace` file under `settings` or in the `.vscode/mcp.json` of the primary workspace folder. Workspace-level settings in the `.code-workspace` file take precedence. |
| 172 | |
| 173 | ## Troubleshooting |
| 174 | |
| 175 | ### Agent Reports MCP Tool Unavailable |
| 176 | |
| 177 | 1. Verify `.vscode/mcp.json` exists in workspace root |
| 178 | 2. Check MCP server is running: View → Extensions → MCP SERVERS section |
| 179 | 3. Trust the server when prompted by VS Code |
| 180 | |
| 181 | ### Authentication Errors |
| 182 | |
| 183 | * GitHub: Uses VS Code's built-in GitHub authentication |
| 184 | * ADO: Verify organization name and tenant ID are correct |
| 185 | * Figma: OAuth launches in your browser on first tool call. Re-authenticate by restarting VS Code if the session expires |
| 186 | |
| 187 | ### MCP Server Not Starting |
| 188 | |
| 189 | 1. Ensure Node.js is installed and `npx` is available |
| 190 | 2. Check the Output panel (View → Output → MCP Servers) for error messages |
| 191 | 3. Verify network access to external URLs |
| 192 | |
| 193 | ## References |
| 194 | |
| 195 | * [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) |
| 196 | * [GitHub MCP Server](https://github.com/github/github-mcp-server) |
| 197 | * [Azure DevOps MCP Server](https://learn.microsoft.com/azure/devops/mcp-server/mcp-server-overview?view=azure-devops) |
| 198 | * [Microsoft Learn MCP Server](https://github.com/microsoftdocs/mcp) |
| 199 | * [Figma MCP Server](https://mcp.figma.com) |
| 200 | |
| 201 | --- |
| 202 | |
| 203 | <!-- markdownlint-disable MD036 --> |
| 204 | *🤖 Crafted with precision by ✨Copilot following brilliant human instruction, |
| 205 | then carefully refined by our team of discerning human reviewers.* |
| 206 | <!-- markdownlint-enable MD036 --> |
| 207 | |