Connecting Clients

Connect the Docs MCP Server to Claude, VS Code, Cursor, and other MCP-compatible clients

The Docs MCP Server is compatible with any client that supports the Model Context Protocol (MCP).

Connection Modes

Most clients support two connection modes:

Remote/HTTP

Connects to a running server instance (e.g., via Docker or npx).

• SSE URL: http://localhost:6280/sse
• HTTP URL: http://localhost:6280/mcp (Streamable HTTP)

Use this mode when running the server with Docker or as a standalone process.

Local/Stdio

Spawns the server process directly within the client.

• Command: npx
• Args: ["-y", "@arabold/docs-mcp-server@latest"]

Use this mode for embedded operation without a separate server process.

Desktop Apps

Claude Desktop

Edit your configuration file:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Remote (Recommended if running Docker):

{
  "mcpServers": {
    "docs-mcp-server": {
      "type": "sse",
      "url": "http://localhost:6280/sse"
    }
  }
}

Local (Embedded):

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Cursor

1. Open MCP Settings

   Go to Settings → Cursor Settings → MCP

2. Add new MCP server

   Click Add new MCP server

3. Configure connection

   Remote:

   • Type: SSE (or streamableHttp)
   • URL: http://localhost:6280/mcp (for streamableHttp) or http://localhost:6280/sse

   Local:

   • Type: stdio
   • Command: npx -y @arabold/docs-mcp-server@latest

Windsurf

Open your Windsurf MCP configuration:

macOS

~/.windsurf/mcp.json

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Zed

Add to your Zed settings.json:

{
  "context_servers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

LM Studio

Go to Program → Install → Edit mcp.json:

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

VS Code Extensions

Cline

1. Open Cline

   Open the Cline extension in VS Code

2. Open MCP Servers

   Click the MCP Servers icon

3. Choose server type

   Choose Remote Servers (if running Docker) or Local Servers

Remote:

{
  "mcpServers": {
    "docs-mcp-server": {
      "url": "http://localhost:6280/mcp",
      "type": "streamableHttp"
    }
  }
}

Local:

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Roo Code

Edit your Roo Code MCP config:

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Continue.dev

Edit ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "docs-mcp-server",
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  ]
}

Trae

See Trae documentation for details.

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

CLI Tools

Claude Code

# Current project
claude mcp add docs-mcp-server -- npx -y @arabold/docs-mcp-server@latest

# Global (all projects)
claude mcp add --scope user docs-mcp-server -- npx -y @arabold/docs-mcp-server@latest

Opencode

{
  "mcp": {
    "docs-mcp-server": {
      "type": "local",
      "command": ["npx", "-y", "@arabold/docs-mcp-server@latest"],
      "enabled": true
    }
  }
}

Gemini CLI

Open ~/.gemini/settings.json:

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Amazon Q Developer CLI

See Amazon Q Developer docs.

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Copilot CLI

Open ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "docs-mcp-server": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Other Integrations

JetBrains AI Assistant

1. Open Settings

   Go to Settings → Tools → AI Assistant → Model Context Protocol

2. Add Server

   Click + Add

3. Select JSON Format

   Select As JSON and add:

   {
     "mcpServers": {
       "docs-mcp-server": {
         "command": "npx",
         "args": ["-y", "@arabold/docs-mcp-server@latest"]
       }
     }
   }
   

Visual Studio 2022

See Microsoft Docs.

{
  "servers": {
    "docs-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@arabold/docs-mcp-server@latest"]
    }
  }
}

Smithery

To install via Smithery:

npx -y @smithery/cli@latest install @arabold/docs-mcp-server --client <CLIENT_NAME>

Docker Configuration

If you prefer using Docker for the client connection:

{
  "mcpServers": {
    "docs-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "docs-mcp-data:/data",
        "ghcr.io/arabold/docs-mcp-server:latest"
      ]
    }
  }
}

Next Steps

Basic Usage

Learn how to add and search documentation sources

Embedding Models

Configure OpenAI, Ollama, Gemini, and other embedding providers