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

# Docs MCP Server

> Connect Claude, Cursor, or any MCP-compatible AI agent to the Spree docs MCP server to search and read the latest documentation while building.

Spree hosts a [Model Context Protocol](https://modelcontextprotocol.io) server on top of this documentation. Once connected, your agent can search the docs and read full pages on demand — answering questions from the latest published documentation instead of stale training data.

```text theme={"theme":"night-owl"}
https://spreecommerce.org/docs/mcp
```

The server exposes two tools: full-text **search** across the documentation, and **reading** doc pages as Markdown.

## Setup

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={"theme":"night-owl"}
    claude mcp add --transport http spree-docs https://spreecommerce.org/docs/mcp
    ```

    Scope it to the project (`--scope project`) to share the connection with your team via `.mcp.json`, or keep the default local scope for just yourself.
  </Tab>

  <Tab title="Claude.ai / Claude Desktop">
    Go to [Settings → Connectors](https://claude.ai/settings/connectors), click **Add custom connector**, and paste the URL:

    ```text theme={"theme":"night-owl"}
    https://spreecommerce.org/docs/mcp
    ```
  </Tab>

  <Tab title="Cursor">
    Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):

    ```json theme={"theme":"night-owl"}
    {
      "mcpServers": {
        "spree-docs": {
          "url": "https://spreecommerce.org/docs/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code (Copilot)">
    Add to `.vscode/mcp.json` in your project:

    ```json theme={"theme":"night-owl"}
    {
      "servers": {
        "spree-docs": {
          "type": "http",
          "url": "https://spreecommerce.org/docs/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Other tools">
    Any MCP client that supports remote servers over streamable HTTP can connect — point it at `https://spreecommerce.org/docs/mcp`. No authentication is required.
  </Tab>
</Tabs>

## When to use MCP vs the other doc channels

| Channel                                                      | Best for                                                                                                           |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| **MCP server** (this page)                                   | The latest published docs; agents working outside a scaffolded project; questions the installed skills don't cover |
| **[`@spree/docs` npm package](/developer/agentic/llm-docs)** | Fast local reads inside a project — no network round-trip, works offline, pinned to what you installed             |
| **[Agent skills](/developer/agentic/agent-skills)**          | Conventions and how-to knowledge the agent should apply without searching at all                                   |

<Note>
  In create-spree-app projects the generated `AGENTS.md` and `CLAUDE.md` already points agents at the local `@spree/docs` package first — MCP complements it for anything newer than your installed docs version.
</Note>