Repository navigation
Give Codex its own MCP file so Claude's directory accepts the plugin - #5
Merged
Merged
Conversation
Anthropic's directory refused 1.0.2 with "Config file fields outside the allowed list accepted only from Verified organizations". Its list for a remote server in .mcp.json is type, url, headers, timeout, alwaysLoad, oauth and text fields, with scopes allowed only under oauth. The top-level scopes that Codex needs broke that rule. Moving them under oauth would fix Claude and break Codex: its plugin parser doesn't read oauth.scopes, so it would ask for every scope again and every tool call would fail. Codex now reads .codex-plugin/mcp.json, which keeps the top-level scopes, and .mcp.json has only type and url. Claude Code already takes the same scopes from the service's sign-in challenge. ci/check.py now fails on any .mcp.json field outside the directory's list, and checks the scopes in Codex's file. plugin.json gets privacyPolicyUrl, which the directory asked for. Version 1.0.3. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Anthropic's directory refused 1.0.2 (security scan and validation passed; the directory policy check failed):
The flagged field is
mcpServers.nutrient.scopes, the top-level array that #2 added for Codex.Moving it under
oauth.scopeswould pass Anthropic but break Codex. Codex's plugin parser (codex-rs/codex-mcp/src/plugin_config.rs) maps onlycallbackUrl,callbackPort,clientIdandclientSecretunderoauth, and its OAuth config has noscopesfield. Codex would go back to asking for every scope, and every tool call would fail again.What
.mcp.json(Claude): onlytypeandurl. Claude Code already takesmcp:invoke offline_accessfrom the service's sign-in challenge..codex-plugin/mcp.json(new, Codex): today's.mcp.json, top-levelscopesincluded..codex-plugin/plugin.jsonpointsmcpServersat it..claude-plugin/plugin.json: addsprivacyPolicyUrl, which the directory listed as a non-blocking finding.ci/check.py:.mcp.jsonserver field oroauthkey outside the directory's list;ci/package_openai.py: requires.codex-plugin/mcp.json. The ZIP still carries.mcp.jsontoo, in case OpenAI's dashboard reads the default path.Verified
python3 ci/check.py: pass.claude plugin validate ./plugins/nutrient --profile directory --strict: "found nothing to report". The privacy-policy note is gone.claude plugin validate . --strictalso passes.Each new guard fails when its rule is broken:
scopesback on Claude's server;oauth.clientSecret;nulloauth;scopes;.mcp.json.An allowed
oauth.scopespasses.Codex 0.169.0 with an empty
CODEX_HOME:codex plugin marketplace add .andcodex plugin add nutrient@nutrientinstall 1.0.3, andcodex mcp listshows the server. Giving the two files different URLs showed that Codex reads.codex-plugin/mcp.json, not.mcp.json.python3 ci/package_openai.pybuildsdist/nutrient-openai-1.0.3.zip.Not verified
🤖 Generated with Claude Code