Skip to content

Commit 99de235

Browse files
fix: remove --validate flag and add enterprise MCP guidance in step 17 (#1400)
1 parent 929ad3c commit 99de235

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

workshop/17-add-mcp-tools.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,20 @@ tools:
5454
> [!NOTE]
5555
> The `github` tool entry tells gh-aw to start the GitHub MCP server in proxy mode. The agent can then call GitHub tools — listing issues, fetching commits, reading file contents — scoped to the permissions you've declared above.
5656
57+
<!-- -->
58+
59+
> [!NOTE]
60+
> <details>
61+
> <summary><b>Enterprise users (GHEC, GHES, EMU): confirm MCP proxy availability before continuing.</b></summary>
62+
>
63+
> `mode: gh-proxy` routes all GitHub tool calls through the `GITHUB_TOKEN` that Actions provides automatically — no extra credentials or setup needed on github.com or GHEC.
64+
>
65+
> On GHES, the GitHub MCP server is supported from GHES 3.16+. If your instance is older, the `tools:` block will compile without errors but the agent's tool calls will fail at runtime. Verify your GHES version and confirm with your admin that the Copilot MCP proxy feature is enabled for your organization.
66+
>
67+
> If MCP is unavailable in your environment, the [Connect a Live Data Source](16-connect-data-source.md) step covers an alternative approach using deterministic shell steps that only require `GITHUB_TOKEN` and the `gh` CLI — no MCP server needed.
68+
>
69+
> </details>
70+
5771
### Reference the tools in your task brief
5872

5973
Below the frontmatter, update the task brief to tell the agent it can use the MCP tools:
@@ -73,7 +87,7 @@ The agent will read this brief, decide which MCP tool calls to make, and weave t
7387
If you're working locally, compile before pushing:
7488

7589
```bash
76-
gh aw compile --validate
90+
gh aw compile
7791
```
7892

7993
<details>

0 commit comments

Comments
 (0)