> 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.makeswift.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.makeswift.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 do I register a custom component with `@makeswift/runtime`?"* by pulling directly from the docs.

> **Docs search only**
>
> This server lets your AI tool search and reference the Makeswift documentation. It can't read or change your sites, pages, or workspace settings. To work with site data, use the [Makeswift API](/developer/api-reference/overview) instead.

**`Makeswift docs MCP server`**

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

## 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 Makeswift.

## 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-makeswift-com https://docs.makeswift.com/_mcp/server
```

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

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

```bash showLineNumbers={false}
claude mcp add --transport http --scope user docs-makeswift-com https://docs.makeswift.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-makeswift-com --url https://docs.makeswift.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-img/0936a190575ce28eb54cb15c69cce7007e55b1004414fd4b216b9c66e3554976.webp)

To set it up manually instead, add the Makeswift 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-makeswift-com": {
      "name": "docs-makeswift-com",
      "url": "https://docs.makeswift.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 Makeswift docs server

Add the following to the `mcpServers` section:

**`claude_desktop_config.json`**

```json title="claude_desktop_config.json" showLineNumbers={false}
{
  "mcpServers": {
    "docs-makeswift-com": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.makeswift.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 Makeswift docs server.
* *"Search the Makeswift docs for controls."* — if it returns results pulled from the docs, you're set.