Skip to content

Commit 99a99a4

Browse files
docs: update Learning Hub for MCP config locations, folder trust, and CLI settings (v1.0.6-v1.0.10) (#1137)
- understanding-mcp-servers.md: document multiple config file locations (.mcp.json, .vscode/mcp.json, devcontainer.json), folder trust security requirement for workspace MCP servers, and experimental MCP_ALLOWLIST - copilot-configuration-basics.md: document new camelCase CLI config settings (includeCoAuthoredBy, effortLevel, autoUpdatesChannel, statusLine), plus include_gitignored and extension_mode options Sources: github/copilot-cli releases v1.0.6 through v1.0.10 (2026-03-16 to 2026-03-20) Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent b1537c6 commit 99a99a4

2 files changed

Lines changed: 28 additions & 4 deletions

File tree

website/src/content/docs/learning-hub/copilot-configuration-basics.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Copilot Configuration Basics'
33
description: 'Learn how to configure GitHub Copilot at user, workspace, and repository levels to optimize your AI-assisted development experience.'
44
authors:
55
- GitHub Copilot Learning Hub Team
6-
lastUpdated: 2025-11-28
6+
lastUpdated: 2026-03-23
77
estimatedReadingTime: '10 minutes'
88
tags:
99
- configuration
@@ -344,6 +344,19 @@ Configuration file: `~/.copilot-cli/config.json`
344344
}
345345
```
346346

347+
CLI settings use **camelCase** naming. Key settings added in recent releases:
348+
349+
| Setting | Description |
350+
|---------|-------------|
351+
| `includeCoAuthoredBy` | Include Co-authored-by trailer in commits |
352+
| `effortLevel` | Default reasoning effort level (`low`, `medium`, `high`) |
353+
| `autoUpdatesChannel` | Update channel (`stable`, `preview`) |
354+
| `statusLine` | Show status line in the terminal UI |
355+
| `include_gitignored` | Include gitignored files in `@` file search |
356+
| `extension_mode` | Control extensibility (agent tools and plugins) |
357+
358+
> **Note**: Older snake_case names (e.g., `include_gitignored`, `auto_updates_channel`) are still accepted for backward compatibility, but camelCase is now the preferred format.
359+
347360
## Common Questions
348361

349362
**Q: How do I disable Copilot for specific files?**

website/src/content/docs/learning-hub/understanding-mcp-servers.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Understanding MCP Servers'
33
description: 'Learn how Model Context Protocol servers extend GitHub Copilot with access to external tools, databases, and APIs.'
44
authors:
55
- GitHub Copilot Learning Hub Team
6-
lastUpdated: 2026-02-26
6+
lastUpdated: 2026-03-23
77
estimatedReadingTime: '8 minutes'
88
tags:
99
- mcp
@@ -61,7 +61,17 @@ GitHub Copilot provides several **built-in tools** that are always available:
6161

6262
## Configuring MCP Servers
6363

64-
MCP servers are configured per-workspace in `.vscode/mcp.json`:
64+
MCP servers are configured per-workspace. GitHub Copilot CLI discovers server definitions from several locations (loaded in order):
65+
66+
| File | Scope | Notes |
67+
|------|-------|-------|
68+
| `.mcp.json` | Repository root | Preferred for repo-shared configuration |
69+
| `.vscode/mcp.json` | VS Code workspace | VS Code–compatible workspace config |
70+
| `devcontainer.json` | Dev container | Available when running inside a container |
71+
72+
> **Security**: Workspace MCP servers are loaded **only after folder trust is confirmed**. If you haven't explicitly trusted a folder, servers defined in its config files won't start — protecting you from malicious MCP server configurations in untrusted repositories.
73+
74+
Example `.mcp.json` or `.vscode/mcp.json`:
6575

6676
```json
6777
{
@@ -193,8 +203,9 @@ MCP server SDKs are available in [Python](https://github.com/modelcontextprotoco
193203
- **Principle of least privilege**: Only give MCP servers the minimum access they need. Use read-only database connections for analysis agents.
194204
- **Keep secrets out of config files**: Use `${input:variableName}` for API keys and connection strings, or load from environment variables.
195205
- **Document your servers**: Add comments or a README explaining which MCP servers your project uses and why.
196-
- **Version control carefully**: Commit `.vscode/mcp.json` for shared server configurations, but use `.gitignore` for any files containing credentials.
206+
- **Version control carefully**: Commit `.mcp.json` or `.vscode/mcp.json` for shared server configurations, but use `.gitignore` for any files containing credentials.
197207
- **Test server connectivity**: Verify MCP servers start correctly before relying on them in agent workflows.
208+
- **Use the MCP allowlist (experimental)**: In high-security environments, the `MCP_ALLOWLIST` feature flag lets you validate MCP servers against a configured registry, blocking unrecognized servers from loading. This is an experimental feature for enterprise environments requiring strict control over which MCP servers are permitted.
198209

199210
## Common Questions
200211

0 commit comments

Comments
 (0)