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

# Connect coding agents and other MCP clients

> Configure Claude Code, Codex CLI, or another MCP client with an ABConvert server URL and an access token.

Connect a coding agent or another Model Context Protocol (MCP) client with a server URL and a store-scoped access token.

> [!NOTE]
>
> For ChatGPT or Claude desktop / web, follow the [directory quickstart](https://docs.abconvert.io/mcp/quickstart.md). Those connections use a connect code.

## 1. Generate an access token

In **Integrations → MCP**, select your client: **Claude → Claude Code**, **Codex**, or **Other MCP Clients**. Choose **Read only** to list tests and read results, or **Read and write** to create and change tests too. Click **Generate token**.

In legacy Settings, use **Settings → MCP & API Access → Access tokens**.

Copy the token when it appears. It is shown once. Use a separate token for each client and keep it out of chat and source control.

## 2. Configure your client

> [tab] Claude Code
>
> Run this command with your token:
>
> ```sh theme={null}
> claude mcp add --transport http abconvert https://mcp.abconvert.io/mcp \
>   --header "Authorization: Bearer <your-api-token>"
> ```
>
> Check the connection with `claude mcp list`.

> [tab] Codex CLI
>
> Add this entry to your local `~/.codex/config.toml`, replacing the placeholder with your token:
>
> ```toml theme={null}
> [mcp_servers.abconvert]
> url = "https://mcp.abconvert.io/mcp"
> http_headers = { Authorization = "Bearer <your-api-token>" }
> ```
>
> Restrict access to the file with `chmod 600 ~/.codex/config.toml`, then restart Codex. If an `abconvert` entry already exists, update it instead of adding a second table.

> [tab] Other clients
>
> Set the HTTP transport URL and request header:
>
> * **Server URL:** `https://mcp.abconvert.io/mcp`
> * **Header name:** `Authorization`
> * **Header value:** `Bearer <your-api-token>`
>
> Use your client's documentation for its exact configuration format. A connect code cannot be used as the bearer token.

## 3. Verify the connection

Start a new session and send:

```text theme={null}
List my active ABConvert tests and summarize their results.
```

If tools do not appear, check [Troubleshooting](https://docs.abconvert.io/mcp/troubleshooting.md). For token rotation and revocation, see [Security](https://docs.abconvert.io/mcp/security.md).

## Optional: compatible OAuth clients

If your client supports ABConvert's OAuth flow, add `https://mcp.abconvert.io/mcp`, then enter a fresh connect code on the ABConvert authorization page it opens. In **Other MCP Clients**, expand **Use a compatible OAuth client instead** to generate the code. Confirm the store before approving access.


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