configure-canvas-mcp — скилл для Claude Code: настройка и установка
Скилл configure-canvas-mcp подключает Canvas Authoring MCP к текущей сессии совместной работы в Power Apps. Запустите его перед редактированием canvas-приложения, если сервер ещё не подключён.
MIT ★ 1 167 обновлён 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install canvas-apps@power-platform-skillsЧто делает configure-canvas-mcp
Скилл просит ссылку на открытую сессию Power Apps Designer, извлекает из неё идентификаторы среды и приложения, а также определяет категорию среды по адресу. Затем он вызывает инструмент connect на сервере canvas-authoring. Вкладку браузера с приложением нужно оставить открытой, а совместную работу включить в настройках приложения.
Если подключение завершается ошибкой 404, скилл предлагает повторить вход с выбором учётной записи, а затем — через браузер. При недоступности инструмента он проверяет список версий .NET SDK: для запуска MCP-сервера нужна версия 10 или выше. Без открытой вкладки сессия совместной работы завершается, поэтому compile_canvas и sync_canvas работать не будут.
Какие задачи решает
- подключить MCP-сервер к сессии Power Apps
- передать серверу идентификаторы среды и приложения
- повторить подключение с нужной учётной записью после ошибки 404
- проверить наличие .NET SDK, если инструмент подключения недоступен
Примеры запросов агенту
- Настрой MCP для открытой сессии canvas-приложения в Power Apps.
- Подключи Canvas Authoring MCP к приложению, открытому в Power Apps Designer.
- Помоги подключить MCP: получаю ошибку 404 при входе в Power Apps.
Как установить configure-canvas-mcp
1Через маркетплейс плагинов
/plugin marketplace add microsoft/power-platform-skills/plugin install canvas-apps@power-platform-skillsКоманда ставит плагин canvas-apps целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill configure-canvas-mcp -a claude-code3Вручную: положить файлы
~/.claude/skills/configure-canvas-mcp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/configure-canvas-mcp/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill configure-canvas-mcp -a codex2Вручную: положить файлы
.agents/skills/configure-canvas-mcp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill configure-canvas-mcp -a cursor2Вручную: положить файлы
.cursor/skills/configure-canvas-mcp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/power-platform-skills plugins/canvas-apps/skills/configure-canvas-mcp2Вручную: положить файлы
.github/skills/configure-canvas-mcp/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill configure-canvas-mcp -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/canvas-apps/skills/configure-canvas-mcpВручную: положить файлы
.devin/skills/configure-canvas-mcp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о configure-canvas-mcp
Как установить configure-canvas-mcp в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add microsoft/power-platform-skills, затем установите плагин командой /plugin install canvas-apps@power-platform-skills.
Что делает configure-canvas-mcp?
Скилл подключает Canvas Authoring MCP к сессии совместной работы с приложением Power Apps. Для подключения он берёт параметры из ссылки на открытую сессию Designer.
Зачем оставлять вкладку Power Apps открытой?
MCP-сервер взаимодействует с Power Apps через сессию совместной работы в этой вкладке. Если её закрыть, compile_canvas и sync_canvas перестанут работать.
Исходный текст
SKILL.md · MIT
--- name: configure-canvas-mcp version: 2.1.0 description: Configure the Canvas Authoring MCP server for the current coauthoring session. Use before starting to edit a canvas app with the /canvas-app skill if not already connected. 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". author: Microsoft Corporation user-invocable: true allowed-tools: Bash, AskUserQuestion, mcp__canvas-authoring__connect, canvas-authoring/connect --- # 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 ### 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`) - **ENVIRONMENT_CATEGORY**: determined from MAKER_HOSTNAME (see table below) **Determine ENVIRONMENT_CATEGORY from MAKER_HOSTNAME:** | MAKER_HOSTNAME | ENVIRONMENT_CATEGORY | | ---------------------------- | -------------------- | | `make.powerapps.com` | `prod` | | `make.preview.powerapps.com` | `prod` | | `make.preprod.powerapps.com` | `preprod` | | `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` - ENVIRONMENT_CATEGORY → `prod` ### 3. Configure the MCP server Call the `connect` MCP tool on the `canvas-authoring` server to connect to the user's coauthoring session. ``` connect( environment_id: ENV_ID, app_id: APP_ID, environment_category: ENVIRONMENT_CATEGORY, // Optional — include only if the user has expressed a preference or a prior sign-in failed (see below): auth_flow: "broker" | "browser" | "devicecode", login_hint: "[email protected]", tenant_id: "00000000-0000-0000-0000-000000000000", force_account_select: true ) ``` **Optional parameters — do NOT prompt the user for these.** Only include them if the user has already expressed a preference earlier in the conversation, or if a prior connect attempt failed: - `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. When reconnecting to switch environment/app, reuse the same `login_hint` value as the previous successful connect (if known) so the same user is reused without re-prompting. - `auth_flow`: Pass `"browser"`, `"broker"`, or `"devicecode"` if the user has explicitly stated a preferred auth flow (e.g. "use browser sign-in"), or use `"browser"` for the 404 recovery below. Use `"devicecode"` on headless/SSH hosts where neither broker nor browser flow can pop a UI — the verification URL and user code are surfaced via an MCP elicitation request and require a client that supports elicitation. Omit otherwise to use the default. - `tenant_id`: Pass a tenant GUID **only** for Entra B2B guest access — set it to the host/resource tenant where the user is a guest so the token is issued by that tenant rather than the user's home tenant. Combine with `login_hint` (the guest's home UPN) to pre-fill the account. Omit for normal same-tenant sign-in. - `force_account_select`: Pass `true` **only** to force the account picker instead of silently reusing a cached account — set this for the 404 recovery below, or when a previous connect failed with a 401/403 and no `login_hint` was given, so the user can pick the correct account. Omit otherwise. If the Canvas Authoring `connect` tool is **not available** under the current host's name, run the following command to check whether the server failed to launch due to a missing .NET 10 SDK. Do not treat the absence of the other host's tool name as a server failure. ```bash 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 from https://dotnet.microsoft.com/download/dotnet/10.0 and then try again. **If `connect` fails with HTTP 404**, a likely cause is signing in with a different account from the one used for the Studio session. Report the error and recover in this order: 1. Remind the user to sign in with the **same account they used for the Power Apps Studio browser session**. 2. Run `connect` again with the same environment/app parameters and `force_account_select: true` so the user can select that account. 3. If that retry fails, run `connect` once more with `auth_flow: "browser"` and `force_account_select: true`, keeping the same environment/app parameters. Remind the user to select their Studio account in the browser sign-in. On a headless/SSH host where browser sign-in is unavailable, use `auth_flow: "devicecode"` instead as described above. Stop retrying after a successful connection. If both recovery attempts fail, report the final error and follow the checks below; do not claim the server is configured. For other connection errors, or if 404 recovery fails, report the error and suggest checking that: 1. The studio URL is correct and the browser tab is still open 2. Coauthoring is enabled in the app settings 3. If sign-in failed, the user may need to specify `auth_flow` (`broker`, `browser`, or `devicecode`) or a `login_hint` (UPN/email) to authenticate as the correct account. On a headless/SSH host, use `auth_flow: "devicecode"`. If a cached account keeps getting picked, retry with `force_account_select: true`. For Entra B2B guest access, set `tenant_id` to the host tenant. ### 4. Confirm Only after `connect` succeeds, tell the user: > ✅ Canvas Authoring MCP server configured for your coauthoring session. > > You can now use Canvas App skills like `/canvas-app` to create or edit your app.
© Microsoft Corporation · MIT · microsoft/power-platform-skills