Skip to content

Commit fc274b1

Browse files
docs(github-tools): document automatic safeoutputs guard-policy derivation (#20569)
When a GitHub MCP guard-policy is configured with a specific repos array, the compiler (since #20467, gateway v0.1.14) automatically derives a linked write-sink guard-policy for the safeoutputs MCP server. Document this behavior in the Guard Policies section of github-tools.md. Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent c0ec218 commit fc274b1

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

docs/src/content/docs/reference/github-tools.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,25 @@ tools:
144144
min-integrity: approved
145145
```
146146

147+
### Safe Outputs Integration
148+
149+
When you configure `repos` as an array of specific repository patterns, the compiler automatically derives a linked guard-policy for the [safe outputs](/gh-aw/reference/safe-outputs/) MCP server. Each entry in the `repos` list is added as a `private` accept entry in the safeoutputs policy, allowing the MCP gateway to read private repository data through the GitHub tools and still write outputs via safeoutputs.
150+
151+
This derivation happens at compile time and requires no additional configuration. If you use `repos: "all"` or `repos: "public"`, no safeoutputs guard-policy is derived.
152+
153+
```yaml wrap
154+
tools:
155+
github:
156+
mode: remote
157+
toolsets: [default]
158+
repos:
159+
- "myorg/private-repo" # automatically added to safeoutputs guard-policy
160+
- "myorg/another-repo" # automatically added to safeoutputs guard-policy
161+
min-integrity: approved
162+
safe-outputs:
163+
create-issue: # safe outputs can write to the guard-policy repos
164+
```
165+
147166
## Lockdown Mode for Public Repositories
148167

149168
Lockdown Mode is a security feature that filters public repository content to only show issues, PRs, and comments from users with push access. Automatically enabled for public repositories when using custom tokens. See [Lockdown Mode](/gh-aw/reference/lockdown-mode/) for complete documentation.

0 commit comments

Comments
 (0)