docs(codex-plugin): document type='http' workaround for plugin-add bug#231
Closed
Aryamanz29 wants to merge 1 commit into
Closed
docs(codex-plugin): document type='http' workaround for plugin-add bug#231Aryamanz29 wants to merge 1 commit into
Aryamanz29 wants to merge 1 commit into
Conversation
`codex plugin add` does not preserve the `type` field from the plugin's bundled `.mcp.json` when writing into `~/.codex/config.toml`. Without `type = "http"`, Codex tries to spawn the URL as a subprocess instead of opening an HTTPS/OAuth connection — tool discovery silently returns zero tools and the agent falls back to weird `codex exec` shell-out workarounds. Empirically reproduced on Codex CLI: a fresh `codex plugin add atlan@atlan` yielded a config section missing the `type` line. Adding it manually and restarting Codex fixes tool discovery and the OAuth flow. The plugin's own `codex-plugin/.mcp.json` already specifies `"type": "http"` correctly — this is a Codex CLI bug. Documenting the post-install workaround until OpenAI fixes the installer. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Member
Author
|
Closing — wrong place for the fix. The plugin's |
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.
Summary
Documents a known issue with Codex CLI's
codex plugin addcommand — it drops thetypefield from the bundled.mcp.jsonwhen writing into~/.codex/config.toml. Withouttype = \"http\"Codex tries to launch the URL as a subprocess and tool discovery silently returns 0 tools.Why this matters
Empirically reproduced on a fresh install:
codex plugin marketplace add https://github.com/atlanhq/agent-toolkit✅codex plugin add atlan@atlan✅ (plugin installed)~/.codex/config.tomlends up with:codex execchild processes as a workaround.What this PR changes
Adds a callout in
codex-plugin/README.mdright after thecodex plugin addinstructions explaining:codex execworkarounds)[mcp_servers.atlan]should look likeWhat this PR is NOT
codex-plugin/.mcp.jsonis already correct — it specifies\"type\": \"http\". This is a Codex CLI bug, not a plugin source issue.Follow-up
File an upstream issue against openai/codex so the workaround can eventually be removed. Until then, this README note saves the next user 30+ minutes of debugging.
🤖 Generated with Claude Code