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.

https://docs.makeswift.com/_mcp/server

Pick your agent

Claude Code

Terminal — Anthropic’s coding agent.

Codex

Terminal — OpenAI’s coding agent.

Cursor

IDE — AI-first VS Code fork.

Claude Desktop

Desktop — general Q&A about Makeswift.

Setup your agent

Claude Code

1

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:

claude mcp add --transport http docs-makeswift-com https://docs.makeswift.com/_mcp/server

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

claude mcp add --transport http --scope user docs-makeswift-com https://docs.makeswift.com/_mcp/server

2

Run it in your terminal

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

3

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:

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.

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)

{
  "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

{
  "mcpServers": {
    "docs-makeswift-com": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.makeswift.com/_mcp/server"
      ]
    }
  }
}

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.