Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: '01 · First Steps'
description: 'Experience your first GitHub Copilot CLI demos and learn the three main interaction modes.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: 2026-03-20
lastUpdated: 2026-06-19
---

![Chapter 01: First Steps](/images/learning-hub/copilot-cli-for-beginners/01/chapter-header.png)
Expand Down Expand Up @@ -393,6 +393,7 @@ That's it for getting started! As you become comfortable, you can explore additi
| `/agent` | Browse and select from available agents |
| `/skills` | Manage skills for enhanced capabilities |
| `/mcp` | Manage MCP server configuration |
| `/settings` | Open an interactive dialog to browse and edit all user settings in one place |

> 💡 Skills are covered in detail in [Chapter 05](../05-skills/). MCP servers are covered in [Chapter 06](../06-mcp-servers/).

Expand Down Expand Up @@ -442,6 +443,7 @@ That's it for getting started! As you become comfortable, you can explore additi

| Command | What It Does |
|---------|--------------|
| `/app` | Open the GitHub app (or browser fallback) directly from the CLI |
| `/help` | Show all available commands |
| `/changelog` | Display changelog for CLI versions |
| `/feedback` | Submit feedback to GitHub |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: '04 · Create Specialized AI Assistants'
description: 'Mirror the source chapter on custom agents and custom instructions for GitHub Copilot CLI.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: 2026-05-08
lastUpdated: 2026-06-19
---

![Chapter 04: Agents and Custom Instructions](/images/learning-hub/copilot-cli-for-beginners/04/chapter-header.png)
Expand Down Expand Up @@ -430,6 +430,7 @@ Copilot will scan your project and create tailored instruction files. You can ed
| `AGENTS.md` | Project root or nested | **Cross-platform standard** - works with Copilot and other AI assistants |
| `.github/copilot-instructions.md` | Project | GitHub Copilot specific |
| `.github/instructions/*.instructions.md` | Project | Granular, topic-specific instructions |
| `~/.copilot/instructions/**/*.instructions.md` | User (all projects) | Personal instructions that apply everywhere, across all your repos |
| `CLAUDE.md`, `GEMINI.md` | Project root | Supported for compatibility |

> 🎯 **Just getting started?** Use `AGENTS.md` for project instructions. You can explore the other formats later as needed.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: '06 · Connect to GitHub, Databases & APIs'
description: 'Mirror the source chapter on MCP servers and external integrations for GitHub Copilot CLI.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: 2026-03-20
lastUpdated: 2026-06-19
---

![Chapter 06: MCP Servers](/images/learning-hub/copilot-cli-for-beginners/06/chapter-header.png)
Expand Down Expand Up @@ -133,7 +133,9 @@ Now that you've seen MCP in action, let's set up additional servers. This sectio

## MCP Configuration File

MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects) or `.vscode/mcp.json` (project-level, applies to just the current workspace).
MCP servers can be configured at the user level in `~/.copilot/mcp-config.json`, which applies across projects, at the project level in `.mcp.json`, or in the workspace config file `.github/mcp.json`. `.github/mcp.json` is auto-loaded alongside `.mcp.json`. If you used `/mcp search`, the CLI created or updated your user-level `~/.copilot/mcp-config.json`, but understanding the JSON format is useful when you want to customize or share project-level MCP configuration.

> ⚠️ **Note**: `.vscode/mcp.json` is no longer supported as an MCP config source. If you have an existing `.vscode/mcp.json`, migrate it to `.mcp.json` in your project root. The CLI will show a migration hint if it detects an old config file.

```json
{
Expand Down Expand Up @@ -341,7 +343,7 @@ Here's a full `mcp-config.json` with filesystem and Context7 servers:
}
```

Save this as `~/.copilot/mcp-config.json` for global access or `.vscode/mcp.json` for project-specific configuration.
Save this as `~/.copilot/mcp-config.json` for global access or `.mcp.json` in the project root for project-specific configuration.

---

Expand Down Expand Up @@ -848,7 +850,7 @@ Ready to go deeper? Follow the [Custom MCP Server Guide](https://github.com/gith
| Mistake | What Happens | Fix |
|---------|--------------|-----|
| Not knowing GitHub MCP is built-in | Trying to install/configure it manually | GitHub MCP is included by default. Just try: "List the recent commits in this repo" |
| Looking for config in wrong location | Can't find or edit MCP settings | User-level config is in `~/.copilot/mcp-config.json`, project-level is `.vscode/mcp.json` |
| Looking for config in wrong location | Can't find or edit MCP settings | User-level config is in `~/.copilot/mcp-config.json`, project-level is `.mcp.json` or `.github/mcp.json` |
| Invalid JSON in config file | MCP servers fail to load | Use `/mcp show` to check configuration; validate JSON syntax |
| Forgetting to authenticate MCP servers | "Authentication failed" errors | Some MCPs need separate auth. Check each server's requirements |

Expand Down