Skip to content

Commit cd88015

Browse files
authored
Merge pull request #58 from github/update/copilot-mcp-command-docs-4d022b88c079b270
[bot] docs(ch06): document new `copilot mcp` command and session-persistent enable/disable
2 parents 37b9efb + dcc9b32 commit cd88015

File tree

1 file changed

+27
-6
lines changed

1 file changed

+27
-6
lines changed

06-mcp-servers/README.md

Lines changed: 27 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ MCP Servers:
7575

7676
> 💡 **Only seeing the GitHub server?** That's expected! If you haven't added any additional MCP servers yet, GitHub is the only one listed. You'll add more in the next section.
7777
78-
> 📚 **Want to see all `/mcp` commands?** There are additional commands for adding, editing, enabling, and deleting servers. See the [full command reference](#-additional-mcp-commands) at the end of this chapter.
78+
> 📚 **Want to see all MCP management commands?** You can manage servers with `/mcp` slash commands inside chat, or with `copilot mcp` directly from your terminal. See the [full command reference](#-additional-mcp-commands) at the end of this chapter.
7979
8080
<details>
8181
<summary>🎬 See it in action!</summary>
@@ -883,21 +883,42 @@ If a server is disabled, see the [additional `/mcp` commands](#-additional-mcp-c
883883
---
884884
885885
<details>
886-
<summary>📚 <strong>Additional <code>/mcp</code> Commands</strong> (click to expand)</summary>
886+
<summary>📚 <strong>Additional MCP Commands</strong> (click to expand)</summary>
887887
<a id="-additional-mcp-commands"></a>
888888
889-
Beyond `/mcp show`, there are several other commands for managing your MCP servers:
889+
You can manage MCP servers in two ways: using **slash commands inside a chat session**, or using the **`copilot mcp` command directly in your terminal** (no chat session needed).
890+
891+
### Option 1: Slash commands (inside a chat session)
892+
893+
These work when you're already inside `copilot`:
890894
891895
| Command | What It Does |
892896
|---------|--------------|
893897
| `/mcp show` | Show all configured MCP servers and their status |
894898
| `/mcp add` | Interactive setup for adding a new server |
895899
| `/mcp edit <server-name>` | Edit an existing server configuration |
896-
| `/mcp enable <server-name>` | Enable a disabled server |
897-
| `/mcp disable <server-name>` | Temporarily disable a server |
900+
| `/mcp enable <server-name>` | Enable a disabled server (persists across sessions) |
901+
| `/mcp disable <server-name>` | Disable a server (persists across sessions) |
898902
| `/mcp delete <server-name>` | Remove a server permanently |
899903
| `/mcp auth <server-name>` | Re-authenticate with an MCP server that uses OAuth (e.g., after switching accounts) |
900904
905+
### Option 2: `copilot mcp` command (from your terminal)
906+
907+
You can also manage MCP servers directly from your terminal without starting a chat session first:
908+
909+
```bash
910+
# List all configured MCP servers
911+
copilot mcp list
912+
913+
# Enable a server
914+
copilot mcp enable filesystem
915+
916+
# Disable a server
917+
copilot mcp disable context7
918+
```
919+
920+
> 💡 **When to use which?** Use `/mcp` slash commands when you're already in a chat session. Use `copilot mcp` from the terminal when you want to quickly check or change your server settings before starting a session.
921+
901922
For most of this course, `/mcp show` is all you need. The other commands become useful as you manage more servers over time.
902923
903924
</details>
@@ -912,7 +933,7 @@ For most of this course, `/mcp show` is all you need. The other commands become
912933
2. **GitHub MCP is built-in** - no configuration needed, just `/login`
913934
3. **Filesystem and Context7** are configured via `~/.copilot/mcp-config.json`
914935
4. **Multi-server workflows** combine data from multiple sources in a single session
915-
5. **Check server status** with `/mcp show` (additional commands available for managing servers)
936+
5. **Manage servers two ways**: use `/mcp` slash commands inside chat, or `copilot mcp` from the terminal
916937
6. **Custom servers** let you connect any API (optional, covered in the appendix guide)
917938
918939
> 📋 **Quick Reference**: See the [GitHub Copilot CLI command reference](https://docs.github.com/en/copilot/reference/cli-command-reference) for a complete list of commands and shortcuts.

0 commit comments

Comments
 (0)