Skip to main content
Use Atlan tools from Codex CLI, the IDE extension, or the desktop app to find registry artifacts and inspect skills while you work in a repository.
Preview. Codex uses one MCP configuration across its CLI, IDE, and desktop surfaces.

​
Prerequisites

  • A current Codex installation with Streamable HTTP MCP support.
  • The Atlan MCP endpoint: https://agentgateway.atlan.engineering/mcp.
  • OAuth sign-in through Codex.
  • Workspace access to the artifacts and tools you expect to use.

​
Setup

  1. Add the Atlan MCP endpoint to user-level Codex configuration, or to a trusted project configuration.
  2. Complete the OAuth sign-in flow when Codex prompts you.
  3. Restart Codex so it loads the MCP server.
  4. Trust the project before relying on project-level configuration.
Keep credentials out of the configuration file and repository.

​
Use skills with Codex

After setup, ask Codex to find or inspect a skill available to your identity. The current Atlan skill profile does not offer a direct Open in Codex handoff.

Use skills with Codex

Find and inspect skills through the connected Atlan MCP server.

Publish skills through Codex

Prepare a read-only inventory, then confirm a bounded MCP creation batch.

​
Expected result

Codex initializes the atlan server and can use the tools returned for the authenticated identity. Tool names can differ from the source names shown in the documentation.

​
Verification

Run codex mcp list and confirm that atlan is enabled. In an interactive session, open /mcp, inspect the server, then ask Codex to perform a read-only registry search.

​
Limitations

  • This integration is in Preview and is not enabled for every Atlan account.
  • Project-level configuration loads only for projects Codex trusts.
  • The available tools depend on account, workspace, and permissions.
  • Codex does not automatically call a tool when the server is connected.
See the Codex MCP documentation for supported transports, authentication, configuration scope, and diagnostics.