> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Docs MCP Server

The docs site exposes a **Model Context Protocol (MCP) server** that AI tools can search and reference. Once connected, your AI tool can answer questions like *"How does the BigCommerce checkout API work?"* by pulling directly from the docs.

> **Docs search only**
>
> This server lets your AI tool search and reference the BigCommerce documentation. It can't read or change your store, orders, catalog, or account settings. If you're looking for an MCP server that interacts with your storefront, see the [BigCommerce MCP Server](/developer/api-reference/mcp/overview). For everything else, use the [REST and GraphQL APIs](/developer/api-reference).

**`BigCommerce docs MCP server`**

```text title="BigCommerce docs MCP server" showLineNumbers={false}
https://docs.bigcommerce.com/_mcp/server
```

For schema-aware workflows, you can also download BigCommerce [OpenAPI Specifications](/developer/api-reference/openapi-specifications) and add them to tools that import OpenAPI files.

## Pick your agent

#### [Claude Code](#claude-code)

Terminal — Anthropic's coding agent.

#### [Codex](#codex)

Terminal — OpenAI's coding agent.

#### [Cursor](#cursor)

IDE — AI-first VS Code fork.

#### [Claude Desktop](#claude-desktop)

Desktop — general Q\&A about the BigCommerce platform.

## Setup your agent

### Claude Code

#### Copy the install command

Pick the scope you want.

**For a single project**, click the **Copy page** dropdown in the upper right of any docs page and select **Connect to Claude Code**, or copy it from here:

```bash showLineNumbers={false}
claude mcp add --transport http docs-bigcommerce-com https://docs.bigcommerce.com/_mcp/server
```

![Copy page dropdown with the Connect to Claude Code option highlighted](/_fern-files/_img/d97c22e2247d43efdcefefcf0eb9b7a09035d5329e20d5073ddfec7574f7e56f.webp)

**For every project on your machine**, copy this one instead:

```bash showLineNumbers={false}
claude mcp add --transport http --scope user docs-bigcommerce-com https://docs.bigcommerce.com/_mcp/server
```

#### Run it in your terminal

Paste the command into a terminal. For the project-only command, run it from that project's directory.

#### Confirm it's connected

Run `claude mcp list` to see the server listed, then run `/mcp` inside Claude Code to check that it's connected.

### Codex

Run this in your terminal to add the docs server:

```bash showLineNumbers={false}
codex mcp add docs-bigcommerce-com --url https://docs.bigcommerce.com/_mcp/server
```

Confirm it appears with `codex mcp list`, then use `/mcp` inside the Codex TUI to check its status.

### Cursor

**Fastest:** click the **Copy page** dropdown in the upper right of any docs page and select **Connect to Cursor**. Cursor opens and asks you to confirm the new server. No file editing needed.

![Copy page dropdown with the Connect to Cursor option highlighted](/_fern-files/_img/71defefcc200e269ef66bb04c6fd7ba6e7513a85c7fb1f147baffcf2b1c48cbb.webp)

To set it up manually instead, add the BigCommerce docs server entry to one of these files. In recent Cursor versions, the **Settings → Tools & MCPs → New MCP Server** button opens `mcp.json` for direct editing rather than a Name/URL form.

* `.cursor/mcp.json` in your project root (project-scoped), or
* `~/.cursor/mcp.json` in your home directory (available in every project)

**`.cursor/mcp.json`**

```json title=".cursor/mcp.json" showLineNumbers={false}
{
  "mcpServers": {
    "docs-bigcommerce-com": {
      "name": "docs-bigcommerce-com",
      "url": "https://docs.bigcommerce.com/_mcp/server",
      "headers": {}
    }
  }
}
```

Save the file — Cursor picks the new server up automatically.

### Claude Desktop

> **Note**
>
> Node.js must be installed for `npx` to work.

#### Locate and open the config file

In Claude Desktop, go to **Settings > Developer > Edit Config** — this reveals `claude_desktop_config.json` in Finder (macOS) or Explorer (Windows). Open that file in VS Code, Cursor, or any text editor.

#### Add the BigCommerce docs server

Add the following to the `mcpServers` section:

**`claude_desktop_config.json`**

```json title="claude_desktop_config.json" showLineNumbers={false}
{
  "mcpServers": {
    "docs-bigcommerce-com": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.bigcommerce.com/_mcp/server"
      ]
    }
  }
}
```

#### Restart Claude Desktop

**Fully** restart Claude Desktop — quit and reopen, not just close the window.

## Verify it's working

Once you've connected, try asking your AI tool:

* *"What MCP tools do you have available?"* — you should see tools from the BigCommerce docs server.
* *"Search the BigCommerce docs for webhooks."* — if it returns results pulled from the docs, you're set.