AGENT SKILL

configure-canvas-mcp

Configure the Canvas Authoring MCP server for Codex CLI. USE WHEN the user says "configure MCP", "set up MCP server", "MCP not working", "connect Canvas Apps MCP", "canvas-authoring not available", "set up canvas apps". DO NOT USE WHEN prerequisites are missing — direct the user to install .NET 10 SDK first.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
configure-canvas-mcp
author
Microsoft Corporation (adapted for Codex by setup plan)
version
1.0.0-codex
description
Configure the Canvas Authoring MCP server for Codex CLI. USE WHEN the user says "configure MCP", "set up MCP server", "MCP not working", "connect Canvas Apps MCP", "canvas-authoring not available", "set up canvas apps". DO NOT USE WHEN prerequisites are missing — direct the user to install .NET 10 SDK first.

03 SKILL.md 正文

Configure the Canvas Authoring MCP Server for Codex

This skill registers the Canvas Authoring MCP server with Codex CLI by writing to ~/.codex/config.toml.

Step 0 — Check Prerequisites

Run:

dotnet --list-sdks

If no SDK version starting with 10. is listed, tell the user:

⚠️ .NET 10 SDK is required to run the Canvas Authoring MCP server. Please install it from https://dotnet.microsoft.com/download/dotnet/10.0 before continuing.

Wait for the user to install it. Re-run the check to confirm before proceeding.

Step 1 — Ask for the Studio URL

Ask the user:

What is the URL of your Power Apps Studio session?

Copy the full URL from your browser while your canvas 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=...

Also confirm that coauthoring is enabled: Settings → Updates → Coauthoring → ON.

Step 2 — Extract Parameters from the URL

From the URL the user provides, extract:

  • ENV_ID: the path segment between /e/ and the next /
    • Example: Default-91bee3d9-0c15-4f17-8624-c92bb8b36ead
  • APP_ID: URL-decode the app-id query parameter, then take the last segment after the final /
    • Example from %2Fproviders%2FMicrosoft.PowerApps%2Fapps%2F6fc3e3d1-292b-4281-8826-577f78512e56 → 6fc3e3d1-292b-4281-8826-577f78512e56
  • MAKER_HOSTNAME: the hostname portion of the URL (e.g., make.powerapps.com)
  • CLUSTER_CATEGORY: derive from MAKER_HOSTNAME:
    • make.powerapps.com → prod
    • make.preview.powerapps.com → prod
    • Any other hostname → test

Echo the extracted values to the user for confirmation before writing anything:

Extracted:

  • ENV_ID: <value>
  • APP_ID: <value>
  • CLUSTER_CATEGORY: <value>

Shall I write these to ~/.codex/config.toml? (yes/no)

Step 3 — Write to ~/.codex/config.toml

After user confirms, read the existing ~/.codex/config.toml if it exists. Preserve all existing content. Add or replace only the [mcp_servers.canvas-authoring] block.

The block to add (substituting the actual extracted values):

[mcp_servers.canvas-authoring]
command = "dnx"
args = [
  "Microsoft.PowerApps.CanvasAuthoring.McpServer",
  "--yes",
  "--prerelease",
  "--source",
  "https://api.nuget.org/v3/index.json"
]

[mcp_servers.canvas-authoring.env]
CANVAS_ENVIRONMENT_ID = "<ENV_ID>"
CANVAS_APP_ID = "<APP_ID>"
CANVAS_CLUSTER_CATEGORY = "<CLUSTER_CATEGORY>"

Write the full updated file back to ~/.codex/config.toml.

Step 4 — Confirm and Give Next Steps

Tell the user:

✅ Canvas Authoring MCP server configured in ~/.codex/config.toml.

You must restart Codex for the MCP server to activate.

After restarting, verify the setup by asking: "List available Canvas App controls"

This should invoke list_controls via the canvas-authoring MCP server. If it does not respond, ensure your Power Apps Studio session is still open with coauthoring enabled, then run $configure-canvas-mcp again with a fresh URL.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k