Skip to content

Commit fd7c261

Browse files
committed
docs: Update optional headers and path params for remote server
1 parent 8beacca commit fd7c261

File tree

1 file changed

+40
-7
lines changed

1 file changed

+40
-7
lines changed

docs/remote-server.md

Lines changed: 40 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,43 @@ These toolsets are only available in the remote GitHub MCP Server and are not in
4545
| -------------------- | --------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
4646
| Copilot coding agent | Perform task with GitHub Copilot coding agent | https://api.githubcopilot.com/mcp/x/copilot | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-copilot&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fcopilot%22%7D) | [read-only](https://api.githubcopilot.com/mcp/x/copilot/readonly) | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-copilot&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fcopilot%2Freadonly%22%7D) |
4747

48-
### Headers
49-
50-
You can configure toolsets and readonly mode by providing HTTP headers in your server configuration.
51-
52-
The headers are:
53-
- `X-MCP-Toolsets=<toolset>,<toolset>...`
54-
- `X-MCP-Readonly=true`
48+
### Optional Headers
49+
50+
The Remote GitHub MCP server has optional headers equivalent to the Local server env vars:
51+
52+
- `X-MCP-Toolsets`: Comma-separated list of toolsets to enable. E.g. "repos,issue".
53+
- Equivalent to `GITHUB_TOOLSETS` env var for Local server.
54+
- If the list is empty, default toolsets will be used. If a bad toolset is provided, the server will fail to start and emit a 400 bad request status. Whitespace is ignored.
55+
- `X-MCP-Readonly`: Enables only "read" tools.
56+
- Equivalent to `GITHUB_READ_ONLY` env var for Local server.
57+
- If this header is empty, "false", "f", "no", "n", "0", or "off" (ignoring whitespace and case), it will be interpreted as false. All other values are interpreted as true.
58+
59+
Example:
60+
61+
```json
62+
{
63+
"type": "https",
64+
"url": "https://api.githubcopilot.com/mcp/",
65+
"headers": {
66+
"X-MCP-Toolsets": "issues",
67+
"X-MCP-Readonly": "true"
68+
}
69+
}
70+
```
71+
72+
### URL Path Parameters
73+
74+
The Remote GitHub MCP server also supports the URL path parameters:
75+
76+
- `/x/{toolset}`
77+
- `/x/{toolset}/readonly`
78+
- `/readonly`
79+
80+
Example:
81+
82+
```json
83+
{
84+
"type": "https",
85+
"url": "https://api.githubcopilot.com/mcp/x/issues/readonly"
86+
}
87+
```

0 commit comments

Comments
 (0)