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

# Codex CLI Integration

> Connect Logic MCP servers to Codex command-line interface

## Overview

Codex is an AI-powered CLI tool for software development. You can connect your Logic MCP server to make Logic agents available during coding sessions.

## Prerequisites

* **Codex CLI** installed
* **Logic MCP server** created ([Quick Start guide](/mcp/quick-start))
* **Server URL** from Logic organization settings

## Adding Logic MCP Server

### Using Codex Commands

<Note>
  **Important**: Run this command in your terminal, not within a Codex session.
</Note>

Add your Logic MCP server using the `codex mcp add` command:

```bash theme={null}
codex mcp add [SERVER_NAME] --url [MCP_SERVER_URL]
```

**Parameters:**

* `[SERVER_NAME]` - A name to identify this server (e.g., "logic-docs")
* `--url [MCP_SERVER_URL]` - Your Logic MCP server URL from [organization settings](https://app.logic.inc/settings/organization-settings/mcp-servers)

### Managing MCP Servers

**List configured servers:**

```bash theme={null}
codex mcp list
```

**Remove a server:**

```bash theme={null}
codex mcp remove [SERVER_NAME]
```

## Using Logic Agents

Once configured, Logic agents are available in your Codex sessions.

### Verifying Your Connection

To check if your Logic MCP server is connected:

1. **Start a Codex session**
2. **Type `/mcp`** in your chat
3. **Verify your Logic server shows as "enabled"**

If the server appears with an enabled status, Logic agents are available for use.

### Accessing Logic Agents

Codex can automatically access your Logic agents based on the conversation context. You can:

* Ask Codex to use specific Logic agents by name
* Let Codex discover and suggest relevant Logic agents
* Execute Logic agents with parameters as needed

**Example usage:**

```
Can you run the "code-review" Logic agent on the current branch?
```

Codex will execute the Logic agent and incorporate the results into its response.

<Info>
  Long-running Logic agents are handled asynchronously. Learn more about
  [async task execution](/mcp/async-tasks).
</Info>

## Next Steps

* [Learn about async tasks](/mcp/async-tasks) - Handle long-running Logic agents
* [Explore agent scope](/mcp/agent-scope) - Control tool availability