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

# Codex MCP setup

> Native remote MCP configuration, browser authorization, tool verification, and troubleshooting

This page covers native MCP in Codex. The remote service uses Streamable HTTP and browser OAuth without requiring EvoLink CLI. For command and skill execution, use the separate [CLI guide](/docs/en/cli/codex).

## Connect remote MCP

For native tools, use **Streamable HTTP + OAuth** with this server URL:

```text theme={null}
https://mcp.evolink.ai/mcp
```

CLI installation is not required. Back up existing configuration, merge only EvoLink, and preserve other services. Choose command-based or manual registration.

<Steps>
  <Step title="Add the remote server">
    In a terminal with Codex CLI installed, run:

    ```bash theme={null}
    codex mcp add evolink --url https://mcp.evolink.ai/mcp
    ```

    The configuration should contain `evolink`. Inspect an existing entry before adding; avoid duplicate manual and plugin registrations.
  </Step>

  <Step title="Authorize MCP separately">
    ```bash theme={null}
    codex mcp login evolink
    ```

    Sign in to EvoLink in the browser, approve, and wait for completion. Skip a repeated login if adding already completed authorization. `evolink auth login` does not authorize this native connection.
  </Step>

  <Step title="Check the connection and query balance">
    ```bash theme={null}
    codex mcp list
    ```

    Open a new Codex session or use `/mcp`, then send the free verification prompt below. Success means actual account balance and available models are returned.
  </Step>
</Steps>

For manual configuration, merge only this section into user `~/.codex/config.toml` or a trusted project’s `.codex/config.toml`:

```toml theme={null}
[mcp_servers.evolink]
url = "https://mcp.evolink.ai/mcp"
```

Codex App has its own plugin/custom MCP connection with the same URL and OAuth. Signing in to the terminal CLI does not automatically connect the App. See [Codex documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

After authorization, send this in the agent chat:

```text theme={null}
Use EvoLink to check my account balance and search available image models. Do not generate anything yet.
```

**Success:** actual `check_balance` and `search_models` calls return results. Verify these tools in the actual MCP connection.

## Updates, disconnection, and troubleshooting

EvoLink updates the hosted MCP server. Refresh the actual client session after configuration changes. Reauthorize through that client's OAuth action when needed. Disable, sign out, or remove EvoLink in host MCP settings to disconnect; retain other servers.

| Symptom | Action |
| - | - |
| URL added but no tools | Enable the connection, complete authorization, refresh, and check organization policy |
| 401 or authentication required | Reauthorize this MCP connection and retain original task IDs |
| 403 or tool denied | Check host permissions, account/Key status, and network errors |
| Timeout or lost response | Query and recover the original operation instead of regenerating |
| Link-only or gray preview | Open and deliver the original without automatically remaking it |

See [MCP costs, access, and troubleshooting](/docs/en/mcp/billing#faq). Read the [creation workflow](/docs/en/mcp/overview#workflows) before submitting; call shapes are in the [MCP tool reference](/docs/en/mcp/tools).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.