Skip to content

Add workflow OAuth scope so MCP can manage .github/workflows/*.yml#2

Merged
ai-nlma merged 1 commit into
mainfrom
fix/add-workflow-oauth-scope
Jul 6, 2026
Merged

Add workflow OAuth scope so MCP can manage .github/workflows/*.yml#2
ai-nlma merged 1 commit into
mainfrom
fix/add-workflow-oauth-scope

Conversation

@ai-nlma

@ai-nlma ai-nlma commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds workflow to the default GITHUB_SCOPES fallback in src/github-oauth.ts so newly-minted GitHub tokens can create/update .github/workflows/* files (GitHub 404s writes to that path without the scope, even with repo granted).
  • Updates .env.example, README.md, and CLAUDE.md to reflect the new default and document why workflow is needed.

Deployment note (manual, out of scope for this PR)

Per CLAUDE.md, the VPS .env is not touched by npm run deploy. After merge, someone needs to:

  1. Add workflow to GITHUB_SCOPES in /opt/github-mcp-auth/.env on the VPS (or remove the var entirely to pick up this new default).
  2. systemctl restart github-mcp-auth.
  3. Existing users must disconnect/reconnect the GitHub MCP in Claude.ai settings to mint a token with the new scope — old tokens don't auto-upgrade.

Fixes #1

Test plan

  • npm run build passes (strict TS, no errors)
  • After deploy: reconnect GitHub MCP and confirm github:create_or_update_file(path=".github/workflows/foo.yml") no longer 404s

GitHub returns 404 on writes to .github/workflows/* without the
workflow scope, even when repo is granted. Bump the default
GITHUB_SCOPES fallback and docs; existing users still need to
disconnect/reconnect to mint a token with the new scope.

Fixes #1
@ai-nlma
ai-nlma merged commit fd2367d into main Jul 6, 2026
@ai-nlma
ai-nlma deleted the fix/add-workflow-oauth-scope branch July 6, 2026 03:04
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.

Add workflow OAuth scope so the MCP can manage .github/workflows/*.yml

1 participant