Power Apps Canvas Authoring GA:Codex 全新安裝與 Preview 安全升級提示詞
Copyright Notice: This article is an original work licensed under the CC 4.0 BY-NC-ND license.
If you wish to repost this article, please include the original source link and this copyright notice.
Source link: https://v2know.com/article/1362
最後核對:2026-09-02
適用對象:使用 OpenAI Codex Desktop/Codex CLI 開發 Power Apps Canvas App 的使用者
Microsoft 已於 2026-09-01 宣布 Canvas authoring agent plugin 正式 GA。對 Codex 使用者來說,這次最重要的變化不只是 MCP Server 轉為正式版,而是 Microsoft 已經把 Canvas App 的開發規則、MCP 設定、驗證流程與 Studio 同步工作流整理成官方 canvas-apps@power-platform-skills Plugin。
這篇文章是原有「Codex 新專案如何使用 Microsoft 官方 canvas-apps」內容的 GA 更新版,並加入兩份可直接貼進 Codex 的完整提示詞:
- 全新的電腦,尚未配置 Canvas Authoring 環境。
- 已使用 Preview/直接 MCP 設定的舊專案,需要安全遷移。
先說結論
目前 Codex 已原生支援 Plugin Marketplace,不需要把 Claude Code 的 /plugin marketplace add 或 /plugin install 指令硬套進 Codex。
截至本文核對時,Codex CLI 0.152.0 提供的原生命令包括:
codex plugin marketplace add microsoft/power-platform-skills --ref main --json
codex plugin marketplace upgrade power-platform-skills --json
codex plugin list --marketplace power-platform-skills --json
codex plugin add canvas-apps@power-platform-skills --json
Codex Desktop 也可以透過 /plugins 介面管理 Plugin。安裝或更新後,通常要開啟新的 Codex session,才能讓新加入的 Skills、MCP tools、Agents 或 Hooks 完整生效。
Microsoft Learn 目前仍會顯示通用的 /plugin ... 安裝範例;那是 Plugin 相容主機的通用說明。使用 Codex 時,應改用 Codex 自己的 /plugins 或 codex plugin ... 機制。
GA 後的官方架構
現在推薦的結構是:
Codex
↓
canvas-apps@power-platform-skills
├─ Skills/instructions/references
├─ Planner/Screen Builder Agents
├─ Hooks
└─ bundled .mcp.json
↓
Canvas App Authoring MCP Server
↓
.pa.yaml discovery/validation/compile
↓
Power Apps Studio live coauthoring session
這幾層的用途並不相同:
- Plugin 告訴 Codex應使用哪些 Skills、Agents、Hooks 與 MCP。
- Skill 告訴 Codex Canvas App 應如何規劃、建立、修改與驗證。
- Canvas Authoring MCP 提供 controls、APIs、data sources、schema、validation、compile 與 Studio coauthoring 等實際能力。
AGENTS.md是選用的專案長期規則,不是 Plugin 或 MCP 的替代品。
截至 2026-09-02,Microsoft 官方 repository 的 Canvas Apps Plugin manifest 版本為 3.0.3,內容包括:
canvas-appconfigure-canvas-mcpadd-data-sourcereport-issuecanvas-app-plannercanvas-screen-builder- Canvas App 設計、Power Fx、YAML、驗證與 QA references
- sync reminder hook
- bundled
.mcp.json
官方 Plugin 的 .mcp.json 仍使用:
{
"mcpServers": {
"canvas-authoring": {
"command": "dnx",
"args": [
"Microsoft.PowerApps.CanvasAuthoring.McpServer",
"--yes",
"--prerelease"
]
}
}
}
這裡的 --prerelease 是 Microsoft 官方 Plugin 目前自帶的設定,不應手動修改 Plugin cache 裡的 .mcp.json。本文核對時實際解析到的是 Microsoft.PowerApps.CanvasAuthoring.McpServer.win-x64 1.1.5 Stable/GA;未來套件解析結果可能改變,所以每次安裝或升級後都應查明「實際載入版本」,不要只看命令列參數猜測。
使用前需要什麼
若只是安裝與驗證 Plugin/MCP infrastructure,至少要有:
- 可使用 Plugin 功能的新版 Codex Desktop 或 Codex CLI。
- .NET 10 SDK;
dnx必須可以正常執行。 - 可連線到 Microsoft 官方 GitHub repository 與 NuGet。
若要真的連接和修改 Canvas App,還需要:
- 已建立並儲存的 Canvas App。
- App 已啟用 coauthoring。
- Power Apps Studio 中開啟該 App 的 Designer URL。
- 可存取該 Environment/App 的 Microsoft 帳號。
安裝環境本身不需要先執行 connect、sync_canvas 或 compile_canvas。將 infrastructure 安裝和 live App 操作分開,是最安全也最容易排錯的做法。
應該使用哪一份提示詞?
| 情況 | 使用提示詞 |
|---|---|
| 新電腦,Codex 已安裝,但沒有 .NET 10、Canvas MCP 或 Power Platform Skills | 提示詞一 |
舊專案已有 [mcp_servers.canvas-authoring]、--prerelease、--source 或其他手動 MCP 設定 |
提示詞二 |
| 不確定自己是哪一種 | 先用提示詞二;它會先做只讀盤點,再決定是否需要遷移 |
提示詞一:全新電腦/全新環境安裝
使用方法:先用 Codex Desktop 開啟準備用來開發 Canvas App 的 workspace,再把以下整段原樣貼進 Codex。這份提示詞會授權 Codex安裝必要的官方元件,但不會連接或修改任何 Canvas App。
我要你現在為「目前這個 Codex workspace」實際建立 Microsoft 2026-09-01 GA 後最新的 Power Apps Canvas Authoring 開發環境。
這是一台尚未配置 Canvas Authoring 的電腦。請使用 Microsoft 官方:
microsoft/power-platform-skills
→ canvas-apps@power-platform-skills
→ Plugin bundled Canvas App Authoring MCP Server
這次可以實際安裝必要的官方元件,但只能做 Plugin/MCP infrastructure 安裝與驗證;不要連接、讀取或修改任何 live Canvas App。
==================================================
一、安全邊界
==================================================
本次禁止執行:
- connect
- sync_canvas
- compile_canvas
- save/publish Canvas App
- 修改 .pa.yaml、Power Fx、controls、data sources
- 開啟或操作 Power Apps Studio coauthoring session
- 清除或刪除任何既有 Microsoft account/auth cache
如果需要登入 Microsoft、系統管理員權限或重新啟動電腦/Codex,請先完成不需要互動的部分,然後停下來清楚告訴我需要做什麼。不要使用非官方 workaround。
==================================================
二、先只讀檢查目前環境
==================================================
請先確認並記錄:
1. 作業系統與 CPU architecture。
2. Codex Desktop/Codex CLI 版本。
3. 此版本 Codex 是否原生支援 Plugins;實際檢查 `/plugins` 或 `codex plugin --help`,不要假定 Claude Code 的 `/plugin` 指令適用。
4. .NET SDK 是否已安裝 10.x。
5. `dnx` 是否可用。
6. Git/GitHub 與 NuGet 存取是否正常。
7. 目前 user、workspace、project config 與 Plugin 是否已存在任何 `canvas-authoring` MCP registration。
如果已存在同名 MCP,不要直接安裝第二套。先報告來源、command、args、enabled 狀態與是否可能重複,再採取安全方案。
==================================================
三、核對最新官方來源
==================================================
只使用以下一手來源判斷目前推薦方式:
- Microsoft Learn
- Microsoft 官方 power-platform-skills GitHub repository
- Microsoft 官方 Power Platform Blog
- NuGet 官方頁面
- OpenAI 官方 Codex Plugin 文件
請確認:
1. microsoft/power-platform-skills 仍提供 `canvas-apps@power-platform-skills`。
2. 最新 Canvas Apps Plugin 的 manifest version/Git revision。
3. Plugin 實際包含哪些 Skills、Agents、Hooks、References 與 `.mcp.json`。
4. `.mcp.json` 中 Canvas Authoring MCP 的實際 command/args。
5. Microsoft 最新文件要求的 .NET SDK 版本。
不要安裝第三方 fork,也不要自行重寫官方 Skill。
==================================================
四、安裝缺少的必要元件
==================================================
如果缺少 .NET 10 SDK,請使用 Microsoft 官方來源或作業系統的可信套件管理器安裝最新 10.x SDK,完成後驗證 `dotnet --list-sdks` 與 `dnx`。
如果安裝需要系統管理員確認、GUI 安裝程式或重新啟動,請停在該步驟並告訴我;不要繞過安全提示。
如果目前 Codex 不支援 Plugin,請不要模擬 Claude/Copilot 的 Plugin 安裝方式,也不要手工複製 Plugin 當作已安裝。請停止並報告需要升級哪個 Codex 元件。
如果 Codex 支援 Plugin,使用 Codex 自己的正式機制,例如目前版本實際支援的:
codex plugin marketplace add microsoft/power-platform-skills --ref main --json
codex plugin list --marketplace power-platform-skills --json
codex plugin add canvas-apps@power-platform-skills --json
執行前仍要以 `codex plugin --help` 的實際輸出確認語法。
要求:
- 只加入 Microsoft 官方 marketplace。
- 只安裝 `canvas-apps` Plugin;不要順便安裝 Power Pages、Power Automate、Model Apps 等其他 Plugins。
- 允許 Codex 把正式 Plugin cache、marketplace registration 與 enable state 寫入 `~/.codex` 或 Codex 規定的位置。
- Power Apps 專案的暫存、診斷或產出檔案必須留在目前 workspace。
- 不要另外在 project `.codex/config.toml` 手工新增第二個 `canvas-authoring` registration。
- 不要修改 Plugin cache 裡由 Microsoft 提供的 `.mcp.json`,包括不要自行刪除其中的 `--prerelease`。
==================================================
五、只做 infrastructure 驗證
==================================================
安裝完成後,在不連接 Power Apps Studio 的前提下驗證:
1. `canvas-apps@power-platform-skills` 已安裝並 enabled。
2. 實際 Plugin version、source revision 與 cache location。
3. Codex 實際發現的 Skills、Agents、Hooks 與 References;區分「檔案存在」和「Codex host 已載入」。
4. 最終只有一個有效的 `canvas-authoring` MCP registration。
5. registration 來源是官方 Canvas Apps Plugin bundled `.mcp.json`。
6. MCP Server 可以啟動、NuGet package 可以解析、stdio handshake 與 tool discovery 正常。
7. 實際載入的 MCP package 名稱與版本,並判斷是 Stable 還是 Prerelease。
8. 列出實際 MCP tools,不要自己假設工具名稱。
以 2026-09-02 的 GA baseline 作交叉檢查時,曾有以下 13 個 tools:
compile_canvas
connect
describe_api
describe_control
get_accessibility_errors
get_appchecker_errors
get_data_source_schema
list_accounts
list_apis
list_controls
list_data_sources
remove_account
sync_canvas
如果最新版工具數量增加或減少,不要立即判定失敗;請與最新官方 manifest/server schema 比較並說明原因。
驗證 tool discovery 時不得呼叫任何 tool,尤其不得呼叫 connect、sync_canvas 或 compile_canvas。
==================================================
六、重啟與失敗處理
==================================================
如果新 Plugin 必須在新的 Codex session 才能載入:
1. 完成所有可安全完成的安裝。
2. 不要假裝當前 session 已經載入新能力。
3. 明確告訴我「現在需要重新啟動 Codex」。
4. 提供一段重啟後可直接貼上的「只讀驗證提示詞」。
如果安裝失敗:
- 不要刪除 auth/account state。
- 只回滾本次新增且確定由本次任務建立的 Plugin/marketplace 變更。
- 不要刪除其他 Codex Plugins 或設定。
- 清楚列出失敗點與可恢復方式。
==================================================
七、最後報告格式
==================================================
請用繁體中文回答:
【安裝結果】
成功/部分成功需重啟/未安裝並說明原因
【前置條件】
Codex version:
.NET SDK:
dnx:
【Canvas Apps Plugin】
Plugin:
Version:
Source/revision:
Location:
Skills:
Agents:
Hooks:
References:
【Canvas Authoring MCP】
Registration source:
Command:
Args:
Package version:
Stable/Prerelease:
是否只有一個 registration:
Tools:
【安全確認】
是否呼叫 connect:否
是否呼叫 sync_canvas:否
是否呼叫 compile_canvas:否
是否修改任何 Canvas App:否
是否清除 auth:否
【需要我做什麼】
是否需要重新啟動 Codex:
是否需要登入:
是否需要 Power Apps Studio Designer URL:
下一句應輸入什麼:
【最終結論】
用一句話說明這台電腦是否已完成 Microsoft GA 官方 Canvas Apps Plugin + Canvas Authoring MCP infrastructure 安裝。
提示詞二:Preview/舊版直接 MCP 的安全升級
這份提示詞適合已經能使用 Canvas Authoring MCP 的專案,例如 .codex/config.toml 中已有:
[mcp_servers.canvas-authoring]
command = "dnx"
args = [
"Microsoft.PowerApps.CanvasAuthoring.McpServer",
"--yes",
"--prerelease",
"--source",
"https://api.nuget.org/v3/index.json"
]
它會先備份和盤點,再安裝官方 Plugin;只有確認 Plugin bundled MCP 可用後,才移除舊的重複 registration。整段可以直接貼進已用 Codex 開啟的舊 workspace。
我要你現在實際把「目前這個 Codex workspace」從舊的直接 Canvas Authoring MCP 設定,安全升級到 Microsoft 2026-09-01 GA 後最新的:
microsoft/power-platform-skills
→ canvas-apps@power-platform-skills
→ Plugin bundled Canvas App Authoring MCP Server
這不是從零安裝。舊環境可能已經使用:
- project `.codex/config.toml`
- `[mcp_servers.canvas-authoring]`
- `dnx Microsoft.PowerApps.CanvasAuthoring.McpServer`
- `--prerelease`
- `--source https://api.nuget.org/v3/index.json`
- 過去已存在的 Microsoft account/auth/coauthoring 使用紀錄
目標是保留可工作的 authentication 與 Power Apps 狀態,安全切換到 Microsoft 官方 Canvas Apps Plugin,而且最終不能同時存在兩個有效的 `canvas-authoring` registration。
==================================================
一、安全邊界
==================================================
本次只升級 Codex Plugin/MCP infrastructure。
禁止執行:
- connect
- sync_canvas
- compile_canvas
- remove_account/logout
- 清除任何 auth、credential、NuGet cache 或 Canvas Authoring account state
- save/publish Canvas App
- 修改 .pa.yaml、Power Fx、controls 或 data sources
- 操作 live Power Apps Studio draft
允許:
- 只讀檢查設定、logs、Plugin、MCP 與 package version
- 備份 project config
- 使用 Codex 官方 Plugin 機制加入 Microsoft marketplace 與安裝/更新 `canvas-apps`
- 在 Plugin 確認可用後,只移除舊 project config 中重複的 `canvas-authoring` section
- 啟動 MCP Server 做 stdio handshake/tool discovery,但不得呼叫任何 Canvas tool
Codex 正式 Plugin cache、marketplace registration 與 enable state 可以寫入 `~/.codex` 或 Codex 規定的位置。專案自己的 backup、prestate、diagnostic 與 migration artifacts 應保留在目前 workspace。
==================================================
二、先只讀盤點,任何修改前先報告
==================================================
請先查明:
1. 目前 workspace 絕對路徑與 project `.codex/config.toml` 的實際位置。
2. Codex Desktop/CLI 版本與 `codex plugin --help` 支援的真實命令。
3. user、global、workspace、project 與 Plugin 各層所有 MCP registrations。
4. 每個 `canvas-authoring` registration 的來源、command、args、enabled 狀態與有效優先順序。
5. 現有 Canvas Authoring MCP 實際 package 名稱、版本與 Stable/Prerelease 狀態。
6. 現有 tool inventory。
7. 是否已經安裝任何版本的 `canvas-apps@power-platform-skills`。
8. 是否有重複 registration 或同名遮蔽。
敏感 token、account identifier、environment ID 與 app ID 必須遮罩;不要把秘密值輸出到報告或 migration artifact。
只使用 Microsoft Learn、Microsoft 官方 GitHub、Microsoft 官方 Power Platform Blog、NuGet 與 OpenAI 官方 Codex 文件核對最新架構。不要使用第三方 fork。
確認官方 repository 目前實際提供的:
- Plugin manifest version/Git revision
- Skills
- Agents
- Hooks
- References
- `.mcp.json`
- bundled `canvas-authoring` command/args
不要假定舊文件裡的檔案名稱與版本仍然正確。
==================================================
三、修改前建立可驗證備份
==================================================
在任何設定修改之前:
1. 備份目前 project `.codex/config.toml` 到同一個 `.codex` 目錄。
2. 檔名使用 `config.toml.backup-before-canvas-plugin-YYYYMMDD-HHMMSS`。
3. 不得覆蓋任何既有備份。
4. 在 workspace 的 `.codex` 目錄建立一份 prestate 記錄,包含:
- 原 config 的 SHA-256 hash
- canvas-authoring command/args
- MCP package version
- tool inventory
- 當時有效 registration 的來源
5. prestate 不得包含敏感 token 或完整 account/environment/app identifiers。
如果找不到 project config,或舊 registration 其實來自 global config,不要猜測;停止自動移除並清楚報告實際來源。
==================================================
四、使用 Codex 原生方式安裝或更新官方 Plugin
==================================================
不要執行 Claude Code/Copilot 專用的:
/plugin marketplace add
/plugin install
請先以目前 Codex 的 `codex plugin --help` 或 Desktop `/plugins` 確認原生機制。
對目前支援的 Codex,可使用相當於:
codex plugin marketplace add microsoft/power-platform-skills --ref main --json
codex plugin marketplace upgrade power-platform-skills --json
codex plugin list --marketplace power-platform-skills --json
codex plugin add canvas-apps@power-platform-skills --json
處理方式:
- 如果 marketplace 尚未存在:加入 Microsoft 官方 repository。
- 如果已存在:使用 Codex 原生 marketplace upgrade 更新 snapshot,不要建立第二個同源 marketplace。
- 如果 canvas-apps 尚未安裝:只安裝 `canvas-apps`。
- 如果已安裝舊版:先比較版本,使用 Codex 當前正式支援的更新流程;不要手動修改 cache 假裝升級。
- 不要安裝其他不需要的 Power Platform Plugins。
- 不要手動修改 Microsoft Plugin 的 `.mcp.json`。
- 官方 `.mcp.json` 即使仍有 `--prerelease` 也要保留;改以「實際解析的 package version」判斷載入的是 Stable 或 Prerelease。
==================================================
五、先驗證 Plugin bundled MCP,再移除舊 registration
==================================================
這個順序不能顛倒。
1. 確認 Plugin 已安裝並 enabled。
2. 確認 Plugin cache 中的 manifest、Skills、Agents、Hooks、References 與 `.mcp.json` 完整。
3. 區分「檔案存在」與「Codex host 實際載入」。
4. 在不受舊 project registration 影響的安全環境中,確認 Plugin bundled `canvas-authoring` 可以被 Codex 識別。
5. 允許做 MCP stdio handshake 與 tool discovery,但不得呼叫任何 MCP tool。
6. 確認 package resolution、實際 package version、transport 與 tool discovery 正常。
只有上述項目確認成功後,才可編輯 project `.codex/config.toml`:
- 只移除舊的 `[mcp_servers.canvas-authoring]` section 及屬於該 section 的 command/args/env。
- 保留其他 MCP servers、permissions、features、comments 與所有無關設定。
- 不要刪除整個 config.toml。
- 修改後再次計算 SHA-256,並檢查 TOML 可解析。
最終架構必須是:
Codex
→ canvas-apps@power-platform-skills
→ Plugin bundled canvas-authoring
→ Microsoft.PowerApps.CanvasAuthoring.McpServer
不能是:
Codex
├─ project config canvas-authoring
└─ Plugin bundled canvas-authoring
==================================================
六、升級後只做 infrastructure 驗證
==================================================
請驗證並列出實際結果:
A. Plugin
- Plugin name
- Version
- Microsoft source/revision
- Cache location
- Enabled state
- Skills
- Agents
- Hooks
- References
- 哪些能力已由 Codex host 載入,哪些只是檔案存在
B. MCP
- 最終是否只有一個有效 `canvas-authoring`
- registration 的實際來源
- command/args/env(敏感值遮罩)
- MCP Server 是否可啟動
- stdio handshake 是否正常
- 實際 package 名稱/版本
- Stable/Prerelease
C. Tools
列出實際 tool inventory,不要自行假設名稱。
以 2026-09-02 GA baseline 交叉檢查時,曾有以下 13 個 tools:
compile_canvas
connect
describe_api
describe_control
get_accessibility_errors
get_appchecker_errors
get_data_source_schema
list_accounts
list_apis
list_controls
list_data_sources
remove_account
sync_canvas
如果工具數量改變,請與最新官方 server schema 比較,判斷是正常版本差異還是安裝問題。
不得為了驗證而呼叫 connect、sync_canvas、compile_canvas 或其他 Canvas tool。
==================================================
七、重啟與真實驗證邊界
==================================================
如果 Plugin/MCP 變更需要新的 Codex session:
1. 完成可以安全完成的安裝、備份與設定去重。
2. 確認檔案已保存且可回滾。
3. 停止後續 session-level 驗證。
4. 不要聲稱 Skills/tools 已在舊 session 載入。
5. 明確告訴我「現在需要重新啟動 Codex」。
6. 提供重啟後可直接貼上的只讀驗證提示詞。
重啟後仍然不得 connect Power Apps Studio。等 infrastructure 驗證完成後,才由我另外決定是否連接 App。
==================================================
八、失敗時自動回滾
==================================================
若發生以下任一情況,請回滾本次遷移:
- Plugin 安裝失敗
- Plugin 格式不被目前 Codex 支援
- Plugin bundled MCP 無法被識別或啟動
- package resolution/stdio handshake/tool discovery 失敗
- 無法安全消除重複 registration
- 舊 registration 移除後 Canvas Authoring tools 全部消失
回滾方式:
1. 用本次建立的 backup 恢復原 project config。
2. 驗證恢復後 SHA-256 與 prestate 一致。
3. 若本次新增的 canvas-apps Plugin 本身造成問題,可用 Codex 官方機制停用或移除該 Plugin;不要刪除其他 Plugins。
4. 不要清除 auth/account state。
5. 只做原 MCP 的啟動與 tool discovery;仍不得 connect、sync_canvas 或 compile_canvas。
以下不應單獨視為失敗:
- Plugin cache 位於 `~/.codex`
- Plugin enable state 位於 Codex 正式設定位置
- Microsoft Plugin 使用自己的 `.mcp.json`
- 新 Plugin 不再使用舊 project config 的 `--source`
- tool list 因新版本正常增加
- Skill/Agent/Hook 名稱有官方版本更新
==================================================
九、最後報告格式
==================================================
請用繁體中文回答:
【升級結果】
成功/部分成功需重啟/已回滾
【升級前】
Plugin:
MCP registration source:
Command/Args:
MCP package:
Tools:
【升級後】
Plugin:
Plugin version:
Plugin source/revision:
Plugin location:
Skills:
Agents:
Hooks:
References:
Codex 實際已載入的能力:
【Canvas Authoring MCP】
Registration source:
Command/Args:
MCP package version:
Stable/Prerelease:
是否只有一個 canvas-authoring:
Tools:
【舊 project MCP 設定】
是否已移除:
修改檔案:
備份位置:
Prestate 位置:
【Authentication】
是否保留原帳號:
是否重新登入:
是否清除任何 auth:否
【Power Apps 安全確認】
是否呼叫 connect:否
是否呼叫 sync_canvas:否
是否呼叫 compile_canvas:否
是否修改 App:否
【需要我做什麼】
是否要重啟 Codex:
重啟後應輸入什麼:
【回滾方式】
列出精確 backup 與恢復步驟。
【最終結論】
用一句話說明目前 workspace 是否已從「直接 Canvas Authoring MCP」成功升級為「Microsoft canvas-apps Plugin + Canvas Authoring MCP」官方工作流。
為什麼第二份提示詞不能只說「幫我升級」?
舊環境最大的風險不是版本號,而是重複 registration。
如果 project .codex/config.toml 已註冊 canvas-authoring,官方 Plugin 又帶了一份同名 .mcp.json,就可能出現遮蔽、啟動來源不明或不同 session 行為不一致。安全順序必須是:
盤點
↓
備份與 prestate
↓
安裝/更新官方 Plugin
↓
隔離驗證 Plugin bundled MCP
↓
只移除舊的重複 MCP section
↓
新 session 驗證唯一 registration 與 tools
同樣重要的是,不要因為看到官方 .mcp.json 還有 --prerelease 就直接改掉。Plugin 裡的設定應由 Microsoft 維護;使用者應驗證實際解析版本,而不是修改 cache 來製造一個難以更新的自訂版本。
安裝完成後,真正開始使用 App
上述兩份提示詞都刻意不連接 Power Apps Studio。等 Plugin、MCP 與 tools 在新 session 確認正常後,再開啟已儲存且已啟用 coauthoring 的 Canvas App,並提供 Power Apps Studio Designer URL。
日常開發提示詞可以很短,例如:
請使用本專案已安裝的 Microsoft 官方 canvas-apps workflow。
先讀取官方 Canvas App Skill,然後連接我目前在 Power Apps Studio 開啟的 App。先分析現有 screens、controls、data sources 與可用 schema,提出修改方案;得到我確認後才修改。修改時不要猜測 control property,完成後依官方 validation/compile workflow 驗證,再告訴我是否適合同步回 Studio。
Power Apps Studio Designer URL:
<在這裡貼上 URL>
這時才會進入 live coauthoring 工作流;如果只是安裝或升級環境,不應提前做這一步。
常見問題
Codex 可以直接使用 canvas-apps@power-platform-skills 嗎?
可以。新版 Codex 已有原生 Plugin 機制。使用 Desktop 的 /plugins,或 Codex CLI 的 codex plugin marketplace ... 與 codex plugin add ...。安裝後請開新的 session。
是否還要自己在 .codex/config.toml 加 Canvas MCP?
採用官方 Canvas Apps Plugin 時,通常不需要。Plugin 已包含 bundled .mcp.json。若舊 project config 已有同名 registration,應先備份並驗證 Plugin,再移除舊的重複 section。
為什麼 GA Plugin 還有 --prerelease?
因為這是 Microsoft 官方 Plugin 目前的 bundled 設定。不要直接改 cache。應檢查 dnx 實際解析到的 package version,並在每次 marketplace/Plugin 更新後重新確認。
安裝 Plugin 會刪除原本登入嗎?
正常安裝不應要求清除帳號或 auth cache。Preview 升級提示詞特別禁止 remove_account、logout 與清除 credentials,並要求優先沿用既有狀態。
安裝後一定要立即 connect Studio 嗎?
不用。先完成 MCP 啟動、stdio handshake 與 tool discovery,確認只有一個 registration;之後才在另一個明確任務中連接 Studio。
官方參考資料
- Microsoft Learn:Create and edit canvas apps with AI code generation tools
- Microsoft GitHub:power-platform-skills
- Microsoft Power Platform Blog:Canvas authoring agent plugin GA
- OpenAI:Codex Plugins
- OpenAI Developers:Build plugins for Codex
- NuGet:Microsoft.PowerApps.CanvasAuthoring.McpServer
最後整理
全新環境應直接從 Microsoft 官方 canvas-apps@power-platform-skills 開始,不再複製舊專案的手工 MCP 設定;舊環境則不要推倒重來,先保存原狀、確認官方 Plugin 可用,再移除重複 registration。
真正需要避免的不是「舊」本身,而是未經驗證就覆蓋設定、同時啟動兩套 MCP,或為了測試安裝而提前操作 live Canvas App。只要把安裝、遷移與 Studio coauthoring 分成清楚的階段,GA 升級可以既保守又完整。
This article was last edited at