Skip to content

Commit 66a61c6

Browse files
authored
Add configuration instructions specifically for VSCode Copilot (#79)
* VSCode Config * servers entry * version bump * configure complete
1 parent ef30f4f commit 66a61c6

2 files changed

Lines changed: 34 additions & 15 deletions

File tree

plugins/canvas-apps/.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "canvas-apps",
3-
"version": "1.0.2",
3+
"version": "1.0.3",
44
"description": "Build Power Apps Canvas Apps using the Canvas Authoring MCP server.",
55
"author": {
66
"name": "Microsoft",

plugins/canvas-apps/skills/configure-canvas-mcp/SKILL.md

Lines changed: 33 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
name: configure-canvas-mcp
33
version: 1.0.0
4-
description: Configure the Canvas Authoring MCP server for Claude Code or GitHub Copilot. USE WHEN "configure MCP", "set up MCP server", "MCP not working", "connect Canvas Apps MCP", "canvas-authoring not available", "MCP not configured", "set up canvas apps". DO NOT USE WHEN prerequisites are missing — direct the user to install .NET 10 SDK first.
4+
description: Configure the Canvas Authoring MCP server for Claude Code, VS Code Copilot, or GitHub Copilot CLI. USE WHEN "configure MCP", "set up MCP server", "MCP not working", "connect Canvas Apps MCP", "canvas-authoring not available", "MCP not configured", "set up canvas apps". DO NOT USE WHEN prerequisites are missing — direct the user to install .NET 10 SDK first.
55
author: Microsoft Corporation
66
user-invocable: true
77
allowed-tools: Bash, AskUserQuestion, Read, Edit, Write
88
---
99

1010
# Configure the Canvas Authoring MCP Server
1111

12-
This skill registers the Canvas Authoring MCP server with either Claude Code or GitHub Copilot using the user's Power Platform environment ID.
12+
This skill registers the Canvas Authoring MCP server with Claude Code, VS Code Copilot, or GitHub Copilot CLI using the user's Power Platform environment ID.
1313

1414
## Instructions
1515

@@ -29,21 +29,30 @@ Then wait for the user to install it before continuing. If they say it's install
2929

3030
### 1. Determine which tool to configure
3131

32-
Determine whether the user needs to configure MCP for GitHub Copilot or for Claude Code:
32+
Determine whether the user needs to configure MCP for VS Code Copilot, GitHub Copilot CLI, or Claude Code:
3333
- If explicitly mentioned in prompt, use that.
3434
- Otherwise, determine which tool the user is running from the context.
3535
- Only if choosing based on the context is impossible, ask the user:
3636

3737
> Which tool would you like to configure the Canvas Authoring (canvas-authoring) MCP server for?
38-
> 1. **GitHub Copilot**
39-
> 2. **Claude**
38+
> 1. **VS Code Copilot**
39+
> 2. **GitHub Copilot CLI**
40+
> 3. **Claude**
4041
41-
Based on the result, set the `TOOL_TYPE` variable to either `copilot` or `claude`. Store this for use in all subsequent steps.
42+
Based on the result, set the `TOOL_TYPE` variable to `vscode-copilot`, `copilot`, or `claude`. Store this for use in all subsequent steps.
4243

4344
### 2. Determine the MCP scope
4445

4546
Choose the configuration scope based on the tool. Use the scope explicitly mentioned by the user, or ask the user to choose.
4647

48+
**If TOOL_TYPE is `vscode-copilot`:**
49+
50+
There is only one configuration path: `.vscode/mcp.json` (relative to the current working directory).
51+
52+
Set `CONFIG_PATH` = `.vscode/mcp.json`. No scope selection is needed.
53+
54+
Store this path for use in steps 4 and 5.
55+
4756
**If TOOL_TYPE is `copilot`:**
4857

4958
The options are:
@@ -129,25 +138,25 @@ claude mcp add --scope {CLAUDE_SCOPE} canvas-authoring \
129138
-- dnx Microsoft.PowerApps.CanvasAuthoring.McpServer --yes --prerelease --source https://api.nuget.org/v3/index.json
130139
```
131140

132-
**If TOOL_TYPE is `copilot`:**
133-
1. If `CONFIG_PATH` is for a **project-scoped** configuration (`.mcp/copilot/mcp.json`), ensure the directory exists first:
134-
```bash
135-
mkdir -p .mcp/copilot
136-
```
141+
**If TOOL_TYPE is `vscode-copilot` or `copilot`:**
142+
1. Ensure the parent directory exists:
143+
- If `CONFIG_PATH` is `.vscode/mcp.json`, run: `mkdir -p .vscode`
144+
- If `CONFIG_PATH` is `.mcp/copilot/mcp.json`, run: `mkdir -p .mcp/copilot`
145+
- If `CONFIG_PATH` is the global `~/.copilot/mcp-config.json`, no directory creation is needed.
137146

138147
2. Read the existing configuration file at `CONFIG_PATH`, or create a new empty config if it doesn't exist:
139148
```json
140149
{}
141150
```
142151

143152
3. Determine which top-level key to use:
144-
- If the config already has `"servers"`, use that
153+
- If the config already has `"servers"`, or if the TOOL_TYPE is `vscode-copilot`, use that
145154
- Otherwise, use `"mcpServers"`
146155

147156
4. Add or update the server entry:
148157
```json
149158
{
150-
"mcpServers": { // or "servers", depending on existing config
159+
"mcpServers": {
151160
"canvas-authoring": {
152161
"type": "stdio",
153162
"command": "dnx",
@@ -188,13 +197,23 @@ Tell the user:
188197
> - `canvas-authoring` should appear in the MCP server list
189198
> - Ask Claude: "List available Canvas App controls" — should invoke `list_controls`
190199
200+
If TOOL_TYPE is `vscode-copilot`:
201+
202+
Tell the user:
203+
204+
> ✅ Canvas Authoring MCP server configured (`canvas-authoring`, configPath: `{CONFIG_PATH}`).
205+
>
206+
> After saving, verify the setup:
207+
> - `canvas-authoring` should appear in the MCP server list
208+
> - Ask Copilot: "List available Canvas App controls" — should invoke `list_controls`
209+
191210
If TOOL_TYPE is `copilot`:
192211

193212
Tell the user:
194213

195214
> ✅ Canvas Authoring MCP server configured (`canvas-authoring`, configPath: `{CONFIG_PATH}`).
196215
>
197-
> **Restart Copilot to activate it.**
216+
> **Restart GitHub Copilot CLI to activate it.**
198217
>
199218
> After restarting, verify the setup:
200219
> - `canvas-authoring` should appear in the MCP server list

0 commit comments

Comments
 (0)