К основному содержанию
скилл CX Codex

configure-canvas-mcp — скилл для Claude Code: настройка и установка

Скилл configure-canvas-mcp подключает Canvas Authoring MCP к текущей сессии совместной работы в Power Apps. Запустите его перед редактированием canvas-приложения, если сервер ещё не подключён.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install canvas-apps@power-platform-skills
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/configure-canvas-mcp/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/configure-canvas-mcp/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
canvas-apps-plugin-codex Ratnam Mishra Плагин canvas-apps-plugin-codex портирует официальный плагин canvas-apps от Microsoft на Codex CLI: приложение Power Apps Canvas собирается и правится обычным текстовым запросом, а изменения уезжают в открытую студию. CX Codex ★ 1 596звёзд репо pcf-canvas-apps официальный github Правило pcf-canvas-apps задаёт контекст GitHub Copilot при создании PCF-компонентов для canvas apps. Помогает учесть безопасность токенов, версионирование манифестов и требования к среде. CX Codex +1 ★ 41 430звёзд репо pcf-limitations официальный github Правило pcf-limitations напоминает GitHub Copilot об ограничениях Power Apps Component Framework в коде компонентов. Помогает вовремя учесть запреты Canvas Apps и правила бандлинга. CX Codex +1 ★ 41 430звёзд репо dx-pkg-post-install-configure forcedotcom Скилл dx-pkg-post-install-configure для Claude Code автоматизирует настройку Salesforce после установки управляемого пакета. Он подключается, когда нужно применить права доступа, настройки страниц или другие шаги из инструкции пакета. CX Codex +1 3 600установок sales-agentforce-pipeline-management-configure forcedotcom Скилл sales-agentforce-pipeline-management-configure настраивает и восстанавливает Agentforce Pipeline Management и Sales Management agent в Salesforce org. Нужен для настройки предложений по полям Opportunity и источников данных. CX Codex +1 2 900установок canvas-lms-mcp bruchris Подключает Canvas LMS к ИИ-агенту: чтение курсов и заданий, выставление оценок, работа с файлами и админ-сценариями. CX Codex +1 ★ 10звёзд репо

Из того же набора157

Весь набор →
check-updates Скилл check-updates для Claude Code пошагово проверяет и обновляет прямые зависимости мобильных проектов Power Apps, проверяя сборки и автоматически откатывая изменения при ошибках. CX Codex +1 ★ 1 167звёзд репо report-issue Скилл report-issue для Claude Code собирает контекст проекта и диагностику, чтобы подготовить текст GitHub issue для плагина mobile-app при сбое или запросе к документации. CX Codex +1 ★ 1 167звёзд репо setup Скилл setup ведёт агента через настройку Process Intelligence: проверяет зависимости, выбирает облако и окружение, привязывает сессию az login и активирует профиль. CX Codex +1 ★ 1 167звёзд репо debug-flow Скилл debug-flow разбирает ошибки в запусках Power Automate. Находит сбойные действия, выявляет причину по цепочке зависимостей и помогает внести точечный фикс. CX Codex +1 ★ 1 167звёзд репо add-sharepoint Скилл add-sharepoint подключает SharePoint Online к Power Apps code app: читает списки, управляет документами, создаёт новые списки через Graph API. CX Codex +1 ★ 1 167звёзд репо preview-offline-scope Скилл preview-offline-scope оценивает объём загрузки и частоту синхронизации офлайн-профиля Power Platform до отправки пользователям. Работает только в режиме чтения. CX Codex +1 ★ 1 167звёзд репо canvas-screen-builder Субагент canvas-screen-builder для Claude Code добавляет или изменяет один экран в существующем Canvas App по общему контракту и заданию. Он выполняет локальную проверку без компиляции. CX Codex ★ 1 167звёзд репо code-app-architect Субагент code-app-architect помогает проектировать Power Apps код-приложения на React и Vite, интегрировать Dataverse, выбирать коннекторы и отлаживать сборку. CX Codex ★ 1 167звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой