Back to Spree

Docs MCP Server

docs/developer/agentic/mcp.mdx

5.5.02.4 KB
Original Source

Spree hosts a Model Context Protocol 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

<Tabs> <Tab title="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.
</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
https://spreecommerce.org/docs/mcp
```
</Tab> <Tab title="Cursor"> Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):
```json
{
  "mcpServers": {
    "spree-docs": {
      "url": "https://spreecommerce.org/docs/mcp"
    }
  }
}
```
</Tab> <Tab title="VS Code (Copilot)"> Add to `.vscode/mcp.json` in your project:
```json
{
  "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

ChannelBest 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 packageFast local reads inside a project — no network round-trip, works offline, pinned to what you installed
Agent skillsConventions 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>