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

# Claude Code

## Prerequisites

* A Box enterprise account with the MCP server enabled by an admin. See [Set up the MCP server](https://developer.box.com/guides/box-mcp/setup).
* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed (`npm install -g @anthropic-ai/claude-code`).

## Enable integration in Box

<Badge color="orange" size="lg">Admin</Badge>

1. Sign in to the [Box Admin Console](https://app.box.com/master).
2. Go to **Integrations** and find **Custom Box MCP Server** either by using the **MCP Category** filter, or by using the search bar at the top of the page.
3. Go to **Configuration** > **Add Integration Credentials** to generate new credentials.
4. In **Redirect URIs**, change the Box redirect URIs to `http://localhost:PORT/callback`. You can use any callback port for this.
5. Copy the **Client ID** and **Client Secret** for later use. These are required later for Claude Code to authorize the connection.
6. Check the **Access scopes**.
7. Click **Save**.

## Use the integration

<Badge color="green" size="lg">User</Badge>

1. In CLI, run the following command and replace YOUR-CLIENT-ID and PORT with the values set in the Admin console.

```bash theme={null}
claude mcp add-json box-mcp \
  '{"type":"http","url":"https://mcp.box.com","oauth":{"clientId":"YOUR-CLIENT-ID","callbackPort":PORT}}' \
  --client-secret
```

2. Paste the Client Secret and press enter to open a browser tab for OAuth.

### Verify the connection

After adding the server, start Claude Code and run `/mcp` to confirm `box-mcp` is listed and connected. You can then ask Claude Code to interact with your Box content using the [available tools](https://developer.box.com/guides/box-mcp/tools).

See Anthropic's docs for details: [Connect Claude Code to tools via MCP - Claude Code Docs](https://code.claude.com/docs/en/mcp#use-pre-configured-oauth-credentials).
