Skip to main content

Set up OpenAI Codex with Remote MCP

Connect OpenAI Codex—both the desktop app and the CLI—to the Atlan Remote MCP server using the Atlan Codex Plugin. OAuth is handled automatically with mcp.atlan.com on the first tool call. No API key, environment variable, or manual MCP configuration is required.

Prerequisites​

Before you begin, make sure you have:

  • An Atlan tenant with Remote MCP enabled.
  • OpenAI Codex installed—either the desktop app, the CLI, or both.

Set up Codex with Remote MCP​

Choose the setup that fits how you use Codex. Plugin install is the recommended path. Use direct MCP install only if you need the Codex CLI alone and don't want the desktop-app plugin entry.

The Atlan Codex Plugin is published in the Atlan agent toolkit repository, which exposes a Codex marketplace.

  1. Register Atlan's marketplace with Codex:

    codex plugin marketplace add https://github.com/atlanhq/agent-toolkit

  2. Install the Atlan plugin from that marketplace:

    codex plugin add atlan@atlan

    The atlan@atlan slug uses Codex's <plugin-name>@<marketplace-name> convention. The first atlan is the plugin name; the second is the marketplace name (Atlan's). It's how Codex resolves which plugin from which marketplace—not an internal-only identifier.

  3. Quit and relaunch the Codex desktop app. The Atlan plugin appears under Plugins → Manage (enabled, with the bundled MCP server registered).

  4. On the first tool call, Codex runs OAuth with mcp.atlan.com to authenticate to your Atlan tenant. Complete the sign-in flow in your browser.

  5. Inside a Codex session, run /mcp to inspect connected servers, then ask anything Atlan-related—for example:

    Find all tables in the snowflake connection and trace lineage upstream from orders_fact.

Verify the connection​

Confirm the plugin is installed and the MCP server is reachable:

codex plugin list | grep atlan   # atlan@atlan installed, enabled
codex mcp list                   # atlan ✓

You can then ask Atlan-related questions inside a Codex session—for example:

  • Find all tables in the Snowflake connection.
  • Trace lineage upstream from the orders_fact table.
  • List glossary terms tagged as PII in my catalog.

For the full list of tools available, see MCP tools.

Need help?​

If you have any issues configuring the integration, contact Atlan Support for assistance.

See also​