$ ~/registry/skill/microsoft-plugins-canvas-apps-skills-configure-canvas-mcp

SKILL

configure-canvas-mcp

Set up the Canvas Authoring MCP server and fix connection issues.

Stars

★ 440

Source

GitHub

Updated

2026-07-11

// securityLow risk

Prompt only, no code
Open source
Community-trusted· 440

Running security audit…

Credentials
Network egress
Code execution
Data access
Supply chain

// install

Copy the install command and let the AI configure it · recommended for beginners

Please install the "configure-canvas-mcp" skill from askskill:
1. Download https://raw.githubusercontent.com/microsoft/power-platform-skills/main/plugins/canvas-apps/skills/configure-canvas-mcp/SKILL.md
2. Save it as ~/.claude/skills/configure-canvas-mcp/SKILL.md
3. Reload skills and tell me it's ready

// download

Download SKILL.mdInstall manifest ↗

// examples

Configure Canvas MCP

Prompt

Please configure the Canvas Authoring MCP server for the current coauthoring session and tell me the required steps and final configuration status.

Expected

Returns the Canvas MCP setup result for the session, key steps taken, and whether it is ready to use.

Troubleshoot MCP Not Configured

Prompt

Canvas Authoring MCP shows as not configured. Please check it and complete the connection; if prerequisites are missing, clearly point that out first.

Expected

Provides diagnosis and setup fixes; if a dependency is missing, it tells the user to install the .NET 10 SDK first.

Connect Canvas Apps MCP

Prompt

Help me connect Canvas Apps MCP and confirm whether canvas-authoring is available in the current coauthoring session.

Expected

Outputs the connection and availability check results, stating whether canvas-authoring is enabled and working.

// docs

Configure the Canvas Authoring MCP Server

This skill configures the Canvas Authoring MCP server for the user's current Power Apps coauthoring session. The MCP server is auto-registered by the plugin — this skill connects it to a specific app session.

Instructions

0. Check prerequisites

Verify that .NET 10 SDK or higher is installed:

dotnet --list-sdks

If a version 10.x.y or higher is not listed, tell the user:

⚠️ .NET 10 SDK is required to run the Canvas Authoring MCP server. It looks like you don't have it installed. Please install it first to use this skill. https://dotnet.microsoft.com/download/dotnet/10.0

Then wait for the user to install it before continuing. If they say it's installed, run the command again to confirm. If it's still not found, repeat the message until they have it installed.

1. Ask for the studio URL

Ask the user:

What is the URL of your canvas app studio session?

Copy the URL from the browser address bar while your app is open in Power Apps Designer (it should look like https://make.powerapps.com/e/Default-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/canvas/?action=edit&app-id=...).

Make sure coauthoring is enabled in the app (Settings → Updates → Coauthoring).

Keep this browser tab open for the entire session. The MCP server communicates with Power Apps through the coauthoring session tied to that tab. Closing the tab ends the coauthoring session, which prevents compile_canvas and sync_canvas from working and means you can't see or save generated changes.

2. Extract parameters from the URL

Parse the following from the studio URL:

ENV_ID: the path segment between /e/ and the next / (e.g. Default-91bee3d9-0c15-4f17-8624-c92bb8b36ead).
APP_ID: URL-decode the app-id query parameter value, then take the last segment after the final / (e.g. 6fc3e3d1-292b-4281-8826-577f78512e56)
MAKER_HOSTNAME: the hostname of the URL (e.g. make.powerapps.com)
CLUSTER_CATEGORY: determined from MAKER_HOSTNAME (see table below)

Determine CLUSTER_CATEGORY from MAKER_HOSTNAME:

MAKER_HOSTNAME	CLUSTER_CATEGORY
`make.powerapps.com`	`prod`
`make.preview.powerapps.com`	`prod`
`make.gov.powerapps.us`	`gov`
`make.high.powerapps.us`	`high`
`make.apps.appsplatform.us`	`dod`
`make.powerapps.cn`	`china`
Any other hostname	`test`

Example:

Example URL: https://make.powerapps.com/e/Default-91bee3d9-0c15-4f17-8624-c92bb8b36ead/canvas/?action=edit&app-id=%2Fproviders%2FMicrosoft.PowerApps%2Fapps%2F6fc3e3d1-292b-4281-8826-577f78512e56

ENV_ID → Default-91bee3d9-0c15-4f17-8624-c92bb8b36ead
APP_ID → 6fc3e3d1-292b-4281-8826-577f78512e56
MAKER_HOSTNAME → make.powerapps.com
CLUSTER_CATEGORY → prod

3. Configure the MCP server

Call the connect MCP tool to connect the server to the user's coauthoring session:

mcp__canvas-authoring__connect(
  environment_id: ENV_ID,
  app_id: APP_ID,
  cluster_category: CLUSTER_CATEGORY,
  // Optional — include only if the user has expressed a preference (see below):
  auth_flow: "broker" | "browser",
  login_hint: "[email protected]"
)

Optional parameters — do NOT prompt the user for these. Only include them if the user has already expressed a preference earlier in the conversation:

login_hint: Pass the user's UPN or email only if they have indicated they want to connect as a specific/different user (e.g. "log in as [email protected]"). These values cannot be derived from the maker portal URL — never guess. Omit otherwise to use the first signed-in user.
auth_flow: Pass "browser" or "broker" only if the user has explicitly stated a preferred auth flow (e.g. "use browser sign-in"). Omit otherwise to use the default.

…

View full docs ↗