Skip to content

feat(spec): add bots field to GitHub MCP Access Control Specification#21734

Closed
Copilot wants to merge 2 commits intomainfrom
copilot/update-mcp-gateway-specification-again
Closed

feat(spec): add bots field to GitHub MCP Access Control Specification#21734
Copilot wants to merge 2 commits intomainfrom
copilot/update-mcp-gateway-specification-again

Conversation

Copy link
Contributor

Copilot AI commented Mar 19, 2026

The GitHub MCP Server Access Control Specification lacked a way to grant bot accounts team-member-level access, forcing all actors through the roles permission check even for trusted automation bots.

Changes

scratchpad/github-mcp-access-control-specification.md — bumped to v1.1.0

  • Section 4.4.4 (new): Defines bots?: string[] — bot identifiers that bypass the roles check while repos and private-repos constraints still apply. Accepts both dependabot[bot] and dependabot forms (case-insensitive).
  • Section 4.5: Updated evaluation order — bot identity check inserted before roles check (step 4).
  • Section 4.6.3–4.6.5: Type validation for bots (must be string[]); new Section 4.6.5 for bot identifier validation rules.
  • Section 9.2: Middleware diagram updated to include bot identity check step.
  • Sections 9.3 & 9.4: Schema extension and frontmatter→gateway config examples updated.
  • Section 10: Added compliance tests T-Fix orphan removal on "gh aw remove" #11–013 (validation) and T-Small docs fixes #27–032 (bypass behavior).
  • Appendix A.12 (new): Example configuration for bot team members.

Example

tools:
  github:
    mode: "remote"
    toolsets: [repos, issues, pull_requests]
    repos:
      - "myorg/*"
    roles:
      - "write"
      - "admin"
    bots:
      - "dependabot[bot]"   # bypasses roles check; repos/private-repos still enforced
      - "renovate[bot]"
    private-repos: true
Original prompt

Update the MCP gateway specification:

The github configuration should allow to specify a list of bots that are considered team members. (bots?: string[])

Custom agent used: w3c-specification-writer
AI technical specification writer following W3C conventions and best practices for formal specifications


📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.

Add `bots?: string[]` to the `tools.github` configuration in the
GitHub MCP Server Access Control Specification. Listed bots are treated
as team members, bypassing the `roles` permission check while `repos`
and `private-repos` constraints still apply.

- Add Section 4.4.4 describing the new `bots` field
- Update Section 4.5 evaluation order to include bot bypass
- Add Section 4.6.5 bot identifier validation rules
- Update Section 9.2 middleware diagram, 9.3/9.4 schema examples
- Add compliance tests T-GH-11–013 and T-GH-27–032
- Add Appendix A.12 bot team members configuration example
- Bump spec version to 1.1.0

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update MCP gateway specification for team member bots feat(spec): add bots field to GitHub MCP Access Control Specification Mar 19, 2026
Copilot AI requested a review from pelikhan March 19, 2026 04:55
@pelikhan pelikhan closed this Mar 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants