diff --git a/06-mcp-servers/README.md b/06-mcp-servers/README.md index 6545496..6ae2859 100644 --- a/06-mcp-servers/README.md +++ b/06-mcp-servers/README.md @@ -75,7 +75,7 @@ MCP Servers: > 💡 **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. -> 📚 **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. +> 📚 **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.
🎬 See it in action! @@ -883,21 +883,42 @@ If a server is disabled, see the [additional `/mcp` commands](#-additional-mcp-c ---
-📚 Additional /mcp Commands (click to expand) +📚 Additional MCP Commands (click to expand) -Beyond `/mcp show`, there are several other commands for managing your MCP servers: +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). + +### Option 1: Slash commands (inside a chat session) + +These work when you're already inside `copilot`: | Command | What It Does | |---------|--------------| | `/mcp show` | Show all configured MCP servers and their status | | `/mcp add` | Interactive setup for adding a new server | | `/mcp edit ` | Edit an existing server configuration | -| `/mcp enable ` | Enable a disabled server | -| `/mcp disable ` | Temporarily disable a server | +| `/mcp enable ` | Enable a disabled server (persists across sessions) | +| `/mcp disable ` | Disable a server (persists across sessions) | | `/mcp delete ` | Remove a server permanently | | `/mcp auth ` | Re-authenticate with an MCP server that uses OAuth (e.g., after switching accounts) | +### Option 2: `copilot mcp` command (from your terminal) + +You can also manage MCP servers directly from your terminal without starting a chat session first: + +```bash +# List all configured MCP servers +copilot mcp list + +# Enable a server +copilot mcp enable filesystem + +# Disable a server +copilot mcp disable context7 +``` + +> 💡 **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. + For most of this course, `/mcp show` is all you need. The other commands become useful as you manage more servers over time.
@@ -912,7 +933,7 @@ For most of this course, `/mcp show` is all you need. The other commands become 2. **GitHub MCP is built-in** - no configuration needed, just `/login` 3. **Filesystem and Context7** are configured via `~/.copilot/mcp-config.json` 4. **Multi-server workflows** combine data from multiple sources in a single session -5. **Check server status** with `/mcp show` (additional commands available for managing servers) +5. **Manage servers two ways**: use `/mcp` slash commands inside chat, or `copilot mcp` from the terminal 6. **Custom servers** let you connect any API (optional, covered in the appendix guide) > 📋 **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.