Learning Outcomes
- Install the Foundry Connect plugin in Copilot CLI.
- Point it at your own instance.
- Confirm the connection before you rely on it.
GitHub Copilot CLI
Copilot CLI reads the Foundry Connect plugin repository as a marketplace and installs the same plugin
Claude Code uses. One install gives you the foundry-pipelines skill, the three /foundry-*
commands, and the foundry MCP connection.
New here? Do Getting Started first.
Measured against GitHub Copilot CLI 1.0.83.
Step 1 — install the plugin
Run these at the Copilot prompt:
copilot plugin marketplace add UMMS-Biocore/foundry-connect-plugin
copilot plugin install foundry-connect@foundry-connect
Step 2 — point it at your instance
Copilot has no per-plugin settings dialog, so you supply your instance as an environment variable.
Set instance_host to your hostname only:
export instance_host=foundry.your-org.edu
No https://, no trailing slash, and no /mcp. The plugin builds https://<instance_host>/mcp
itself, and adding any of those pieces yourself produces an address that cannot connect.
Put that export in your shell profile. A new terminal without the variable set cannot reach your
instance, and the failure is quiet rather than loud.
Step 3 — restart Copilot
MCP servers are read once, when a session starts. The plugin you just installed is not connected until you start a new session.
Step 4 — check it worked
copilot mcp list
You should see:
Plugin servers:
foundry (http)
For the fuller picture, copilot plugins list (plural) is the real inspector: it shows plugins, MCP
servers and skills together with their scope.
Signing in
The plugin's connection carries no token, so it uses OAuth. Copilot handles this properly: when Foundry Connect refuses an unauthenticated request, Copilot reads the sign-in address out of that response and follows it. Approve access once and you are connected.
Copilot CLI has no copilot mcp login command, so sign-in happens inside an interactive session
rather than as a separate step you run first. If you would rather not use OAuth, supply a
Personal Access Token as a header instead; Copilot expands
environment variables inside header values, so the token does not have to sit in the file as literal
text.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
No Plugin servers section in copilot mcp list |
The address was rejected, and Copilot drops an invalid entry silently | Check instance_host is set, and is a bare hostname |
| Server listed but never connects | Session started before the variable was set | Set the variable, then start a new session |
| Tools missing after install | MCP config is read at session start | Start a new session |
The silence is the thing to watch for. An invalid entry in ~/.copilot/mcp-config.json is dropped
with no error printed anywhere, so a missing server is far more likely than a broken one.
See also
- Copilot in VS Code — the extension reads a different file and needs its own setup.
- Using Foundry Connect with Copilot, Codex and ChatGPT
- MCP Integration