> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connect Codex to the Atlan MCP endpoint.

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.

<Note>
  **Preview.** Codex uses one MCP configuration across its CLI, IDE, and desktop
  surfaces.
</Note>

## Prerequisites

* A current Codex installation with Streamable HTTP MCP support.
* The Atlan MCP endpoint: [https://agentgateway.atlan.engineering/mcp](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.

<Card title="Use skills with Codex" icon="code" href="/guides/skills/use-with-codex">
  Find and inspect skills through the connected Atlan MCP server.
</Card>

<Card title="Publish skills through Codex" icon="upload" href="/guides/skills/publish-with-codex">
  Prepare a read-only inventory, then confirm a bounded MCP creation batch.
</Card>

## 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](https://learn.chatgpt.com/docs/extend/mcp)
for supported transports, authentication, configuration scope, and diagnostics.