Skip to content

docs: document GitHub OIDC audience binding for self-hosters and CI users#1230

Merged
rdimitrov merged 1 commit into
mainfrom
docs/github-oidc-audience-self-hosting
Apr 30, 2026
Merged

docs: document GitHub OIDC audience binding for self-hosters and CI users#1230
rdimitrov merged 1 commit into
mainfrom
docs/github-oidc-audience-self-hosting

Conversation

@rdimitrov

Copy link
Copy Markdown
Member

Summary

Follow-up to #1229. Three small doc additions so the new audience requirement is discoverable without reading the source:

  • .env.example lists MCP_REGISTRY_GITHUB_OIDC_AUDIENCE alongside the other registry env vars, with a note that the value must match the scheme+host that publishers pass via --registry.
  • The publisher CLI reference (docs/reference/cli/commands.md) explains that the CLI derives the audience from --registry and that self-hosters must set the matching env var on the registry side.
  • The GitHub Actions troubleshooting table (docs/modelcontextprotocol-io/github-actions.mdx) maps the new invalid audience error to the user-facing fix (upgrade mcp-publisher).

No code changes — docs only.

Test plan

  • CI green (markdown lint / link checks if any)
  • Eyeball-render the troubleshooting table on the modelcontextprotocol.io preview to confirm the new row formats correctly

🤖 Generated with Claude Code

…sers

Follow-up to #1229. Three small additions so the new audience requirement
is discoverable without reading the source:

- .env.example lists MCP_REGISTRY_GITHUB_OIDC_AUDIENCE alongside the other
  registry env vars, with a note that the value must match scheme+host of
  the URL publishers pass via --registry.
- The publisher CLI reference explains the new audience derivation and
  what self-hosters need to configure server-side.
- The GitHub Actions troubleshooting table maps the new "invalid audience"
  error to the user-facing fix (upgrade mcp-publisher).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rdimitrov rdimitrov merged commit db43896 into main Apr 30, 2026
5 checks passed
@rdimitrov rdimitrov deleted the docs/github-oidc-audience-self-hosting branch April 30, 2026 00:56
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.

1 participant