> ## 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 Claude Code to Equip

> Add Equip's MCP server to Claude Code with one command and ask about your openings, candidates and results from the terminal.

**Claude Code** connects to Equip's MCP server at `https://equip.co/api/v3/mcp/` with one command. The server is read-only, so Claude Code 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. Run the add command**

```sh theme={null}
claude mcp add --transport http equip https://equip.co/api/v3/mcp/ --header 'Authorization: Bearer ${EQUIP_MCP}'
```

Keep the single quotes. Claude Code stores the `${EQUIP_MCP}` reference and reads the key from your environment each time it starts, so the key is never written into its config.

**2. Check the connection**

Start Claude Code and run `/mcp`. **equip** shows as connected with its tools listed.

**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 Claude Code tab selected, showing the export EQUIP\_MCP line and the claude mcp add command with a copy button](https://mintcdn.com/equip-hq/hQF868N9i7xn4NG3/images/mcp-claude-code/developers-claude-code-tab.png?fit=max\&auto=format\&n=hQF868N9i7xn4NG3\&q=85\&s=299be8c6387e77657adfa6505ac3ffce)

The Claude Code 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 Claude Code 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 Claude Code after adding the server.

## 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.