Skip to content

Commit 08287fe

Browse files
authored
Update connect skill for auth_flow and login_hint (#175)
1 parent ff0d191 commit 08287fe

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

  • plugins/canvas-apps/skills/configure-canvas-mcp

plugins/canvas-apps/skills/configure-canvas-mcp/SKILL.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: configure-canvas-mcp
3-
version: 2.0.0
3+
version: 2.1.0
44
description: Configure the Canvas Authoring MCP server for the current coauthoring session. 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". DO NOT USE WHEN prerequisites are missing — direct the user to install .NET 10 SDK first.
55
author: Microsoft Corporation
66
user-invocable: true
@@ -77,14 +77,24 @@ Call the `connect` MCP tool to connect the server to the user's coauthoring sess
7777
mcp__canvas-authoring__connect(
7878
environment_id: ENV_ID,
7979
app_id: APP_ID,
80-
cluster_category: CLUSTER_CATEGORY
80+
cluster_category: CLUSTER_CATEGORY,
81+
// Optional — include only if the user has expressed a preference (see below):
82+
auth_flow: "broker" | "browser",
83+
login_hint: "user@contoso.com"
8184
)
8285
```
8386

87+
**Optional parameters — do NOT prompt the user for these.** Only include them if the user has already expressed a preference earlier in the conversation:
88+
89+
- `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 alice@contoso.com"). These values cannot be derived from the maker portal URL — never guess. Omit otherwise to use the first signed-in user.
90+
- `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.
91+
8492
If the call fails, report the error to the user and suggest checking that:
93+
8594
1. The studio URL is correct and the browser tab is still open
8695
2. Coauthoring is enabled in the app settings
8796
3. .NET 10 SDK is correctly installed
97+
4. If sign-in failed, the user may need to specify `auth_flow` (`broker` vs. `browser`) or a `login_hint` (UPN/email) to authenticate as the correct account
8898

8999
### 4. Confirm
90100

0 commit comments

Comments
 (0)