feat: add Codex plugin for Atlan MCP server (AICHAT-1113)#228
Merged
Conversation
Adds a Codex-format plugin that exposes Atlan's hosted MCP server (`https://mcp.atlan.com/mcp`) to both the OpenAI Codex desktop app and the Codex CLI, mirroring the existing Cursor and Claude Code plugins. Layout follows the official Codex plugin schema discovered by inspecting the bundled `openai-bundled` marketplace: - `codex-plugin/.codex-plugin/plugin.json` — plugin manifest with desktop-app metadata (displayName, brandColor, logo, capabilities, privacy/terms URLs). - `codex-plugin/.mcp.json` — MCP server registration bundled by the plugin (`type=http`, OAuth handled by Codex against the discovery endpoint). - `.agents/plugins/marketplace.json` — marketplace manifest at the repo root exposing the plugin as `atlan@atlan`. Uses the `source.source=local` shape matching OpenAI's bundled marketplaces; enables sideloading via `codex plugin marketplace add <repo-root>`. Verified locally on Codex CLI 0.133.0: - `codex plugin marketplace add` registers the marketplace - `codex plugin list` shows `atlan@atlan` as discoverable - `codex plugin add atlan@atlan` installs the plugin and appends `[mcp_servers.atlan]` to `~/.codex/config.toml` automatically Refs: https://linear.app/atlan-epd/issue/AICHAT-1113
…eload-only install
- Fix logo rendering: prefix asset paths with ./ and add composerIcon field
(Codex composer surface reads composerIcon, not logo)
- Convert defaultPrompt to array and capabilities to PascalCase tokens
per the canonical schema at developers.openai.com/codex/plugins/build
- Align customer-facing description with Cursor plugin's copy for consistency
- README: lead with sideload path since OpenAI's curated Plugin Directory
is not yet GA ("coming soon" per official docs); demote curated-directory
install to "once GA" footnote
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
abhinavmathur-atlan
approved these changes
May 26, 2026
Collaborator
|
@Hk669 PTAL |
Hk669
approved these changes
May 27, 2026
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
3 participants
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
Adds a Codex-format plugin for Atlan's hosted MCP server (
https://mcp.atlan.com/mcp), mirroring the existing Cursor and Claude Code plugins. Works in both the Codex desktop app and the Codex CLI — OAuth handled by Codex against the MCP server's discovery endpoint on first tool call.Linear: AICHAT-1113
What ships
Schema follows OpenAI's bundled marketplaces (verified by inspecting
~/.codex/.tmp/bundled-marketplaces/openai-bundled/.agents/plugins/marketplace.json):source.source: "local"+source.path: "./codex-plugin"for the plugin referencepolicy.installation: "AVAILABLE",policy.authentication: "ON_INSTALL".mcp.jsonusestype: "http"to delegate OAuth to Codex's discovery flowVerified locally (Codex CLI 0.133.0)
After install the plugin is visible in Codex.app → Plugins → Manage with the bundled MCP server registered.
How users install (post-merge)
Once accepted into OpenAI's curated Plugin Directory:
codex plugin add atlan@openai-curatedor via the desktop app's marketplace search.Before then, sideload via
codex plugin marketplace add <path-to-checkout>followed bycodex plugin add atlan@atlan. CLI-only users who don't need the desktop plugin entry can still use the existingcodex mcp add atlan --url https://mcp.atlan.com/mcpflow directly.🤖 Generated with Claude Code