---
title: "Docs MCP Server"
sidebarTitle: MCP
description: "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
https://spreecommerce.org/docs/mcp
```

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

## Setup

**Claude Code:**

```bash
    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.

  **Claude.ai / Claude Desktop:**

Go to [Settings → Connectors](https://claude.ai/settings/connectors), click **Add custom connector**, and paste the URL:

    ```text
    https://spreecommerce.org/docs/mcp
    ```

  **Cursor:**

Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):

    ```json
    {
      "mcpServers": {
        "spree-docs": {
          "url": "https://spreecommerce.org/docs/mcp"
        }
      }
    }
    ```

  **VS Code (Copilot):**

Add to `.vscode/mcp.json` in your project:

    ```json
    {
      "servers": {
        "spree-docs": {
          "type": "http",
          "url": "https://spreecommerce.org/docs/mcp"
        }
      }
    }
    ```

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


## 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](llm-docs.md)** | Fast local reads inside a project — no network round-trip, works offline, pinned to what you installed |
| **[Agent skills](agent-skills.md)** | 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.