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

# Connect Codex to Equip

> Add Equip's MCP server to Codex with three lines in config.toml and ask about your openings, candidates and results.

**Codex** connects to Equip's MCP server at `https://equip.co/api/v3/mcp/` through its config file. The server is read-only, so Codex can look things up but never change them.

Available on the annual Premium and Elite plans.
[Compare plans](https://help.equip.co/compare-plans.md)

## Add the Server

You need your organization's API key in your shell as `EQUIP_MCP` first; see [Connect Your AI Assistant to Equip](https://help.equip.co/connect-ai-assistant.md).

**1. Edit config.toml**

Add this to `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.equip]
url = "https://equip.co/api/v3/mcp/"
bearer_token_env_var = "EQUIP_MCP"
```

`bearer_token_env_var` names the variable, so Codex reads the key from your environment and the key itself never sits in the file.

**2. Check the connection**

Run `codex mcp list` in a terminal, or start Codex and ask "what tools do you have from equip?".

**3. Ask a question**

Try: "Which of my job openings have the most candidates waiting in screening?"

![The Connect your AI assistant section on the Account Developers page with the Codex tab selected, showing the export EQUIP\_MCP line and the three-line config.toml entry with a copy button](https://mintcdn.com/equip-hq/hQF868N9i7xn4NG3/images/mcp-codex/developers-codex-tab.png?fit=max\&auto=format\&n=hQF868N9i7xn4NG3\&q=85\&s=344c1ae5cf2403c3585ffe484fbf3ecc)

The Codex snippet on the Developers page

> [accordion] Troubleshooting
>
> * **401 Invalid API key**: the key was mistyped or rotated, or `EQUIP_MCP` is not exported in the shell you started Codex from. Run `echo $EQUIP_MCP` there.
> * **403 "isn't included in your plan"**: your plan does not include the MCP server. See [Compare Plans](https://help.equip.co/compare-plans.md), or [contact support](https://help.equip.co/contact-support.md) to have it switched on for your organization.
> * **The server shows but has no tools**: quit and restart Codex after editing the file.

## Related Resources

* [Connect Your AI Assistant to Equip](https://help.equip.co/connect-ai-assistant.md) - Getting the key, what the tools can read, other clients
* [API Integrations](https://help.equip.co/api-integrations.md) - The REST API behind the same key


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