Skip to content

Commit b482ac6

Browse files
docs: add MCP Apps feature flag configuration section
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent a24c0be commit b482ac6

File tree

1 file changed

+58
-1
lines changed

1 file changed

+58
-1
lines changed

docs/server-configuration.md

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ We currently support the following ways in which the GitHub MCP Server can be co
1414
| Dynamic Mode | Not available | `--dynamic-toolsets` flag or `GITHUB_DYNAMIC_TOOLSETS` env var |
1515
| Lockdown Mode | `X-MCP-Lockdown` header | `--lockdown-mode` flag or `GITHUB_LOCKDOWN_MODE` env var |
1616
| Insiders Mode | `X-MCP-Insiders` header or `/insiders` URL | `--insiders` flag or `GITHUB_INSIDERS` env var |
17+
| Feature Flags | `X-MCP-Features` header | `--features` flag |
1718
| Scope Filtering | Always enabled | Always enabled |
1819
| Server Name/Title | Not available | `GITHUB_MCP_SERVER_NAME` / `GITHUB_MCP_SERVER_TITLE` env vars or `github-mcp-server-config.json` |
1920

@@ -390,7 +391,7 @@ Lockdown mode ensures the server only surfaces content in public repositories fr
390391

391392
**Best for:** Users who want early access to experimental features and new tools before they reach general availability.
392393

393-
Insiders Mode unlocks experimental features, such as [MCP Apps](./insiders-features.md#mcp-apps) support. We created this mode to have a way to roll out experimental features and collect feedback. So if you are using Insiders, please don't hesitate to share your feedback with us! Features in Insiders Mode may change, evolve, or be removed based on user feedback.
394+
Insiders Mode unlocks experimental features, such as [MCP Apps](#mcp-apps) support. We created this mode to have a way to roll out experimental features and collect feedback. So if you are using Insiders, please don't hesitate to share your feedback with us! Features in Insiders Mode may change, evolve, or be removed based on user feedback.
394395

395396
<table>
396397
<tr><th>Remote Server</th><th>Local Server</th></tr>
@@ -443,6 +444,62 @@ See [Insiders Features](./insiders-features.md) for a full list of what's availa
443444

444445
---
445446

447+
### MCP Apps
448+
449+
[MCP Apps](https://modelcontextprotocol.io/docs/extensions/apps) is an extension to the Model Context Protocol that enables servers to deliver interactive user interfaces to end users. Instead of returning plain text that the LLM must interpret and relay, tools can render forms, profiles, and dashboards right in the chat.
450+
451+
MCP Apps is enabled by [Insiders Mode](#insiders-mode), or independently via the `remote_mcp_ui_apps` feature flag.
452+
453+
**Supported tools:**
454+
455+
| Tool | Description |
456+
|------|-------------|
457+
| `get_me` | Displays your GitHub user profile with avatar, bio, and stats in a rich card |
458+
| `issue_write` | Opens an interactive form to create or update issues |
459+
| `create_pull_request` | Provides a full PR creation form to create a pull request (or a draft pull request) |
460+
461+
**Client requirements:** MCP Apps requires a host that supports the [MCP Apps extension](https://modelcontextprotocol.io/docs/extensions/apps). Currently tested with VS Code (`chat.mcp.apps.enabled` setting).
462+
463+
<table>
464+
<tr><th>Remote Server</th><th>Local Server</th></tr>
465+
<tr valign="top">
466+
<td>
467+
468+
```json
469+
{
470+
"type": "http",
471+
"url": "https://api.githubcopilot.com/mcp/",
472+
"headers": {
473+
"X-MCP-Features": "remote_mcp_ui_apps"
474+
}
475+
}
476+
```
477+
478+
</td>
479+
<td>
480+
481+
```json
482+
{
483+
"type": "stdio",
484+
"command": "go",
485+
"args": [
486+
"run",
487+
"./cmd/github-mcp-server",
488+
"stdio",
489+
"--features=remote_mcp_ui_apps"
490+
],
491+
"env": {
492+
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
493+
}
494+
}
495+
```
496+
497+
</td>
498+
</tr>
499+
</table>
500+
501+
---
502+
446503
### Scope Filtering
447504

448505
**Automatic feature:** The server handles OAuth scopes differently depending on authentication type:

0 commit comments

Comments
 (0)