MCP Server

Docsbook ships a Model Context Protocol (MCP) server. Connect Claude Code or any MCP-compatible client and manage every aspect of your docs without leaving the editor.

What MCP is#

The Model Context Protocol is an open standard for exposing tools, resources, and prompts to AI agents over a typed RPC interface. The Docsbook MCP server exposes 61 tools covering the full product surface.

Endpoint#

https://docsbook.io/api/mcp/server

Authentication is OAuth 2.0 Authorization Code with PKCE. Bearer tokens are returned to the client and refreshed transparently.

Install in your AI client#

The Docsbook MCP server is a remote HTTP server with OAuth — every modern MCP client can connect to it using the same endpoint.

Claude Code#

claude mcp add --transport http docsbook https://docsbook.io/api/mcp/server

The first call opens a browser tab for OAuth. After consent, the tools become available inside Claude Code.

Cursor#

Add the server to ~/.cursor/mcp.json (or use Settings → MCP & Integrations → New MCP server):

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

Reload Cursor — OAuth opens in the browser on first use.

Codex CLI#

Codex stores MCP servers in ~/.codex/config.toml:

[mcp_servers.docsbook]
url = "https://docsbook.io/api/mcp/server"

Windsurf#

Edit ~/.codeium/windsurf/mcp_config.json and refresh the Cascade panel:

{
  "mcpServers": {
    "docsbook": {
      "serverUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

Cline#

Open Cline → MCP Servers → Configure MCP Servers and paste:

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server",
      "transportType": "http"
    }
  }
}

Gemini CLI#

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "docsbook": {
      "httpUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

GitHub Copilot (VS Code)#

Create .vscode/mcp.json inside your workspace, then enable the server from the Copilot Chat MCP picker:

{
  "servers": {
    "docsbook": {
      "type": "http",
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

ChatGPT#

ChatGPT supports remote MCP through Connectors (Pro / Business / Enterprise plans).

1. Open ChatGPT → Settings → Connectors → Advanced → Developer mode.
2. Click Create and paste the URL: https://docsbook.io/api/mcp/server.
3. Authorize in the browser when prompted.

Tool categories#

Searching and editing documentation content#

There are two ways to work with your docs content from an agent:

• Hosted, via MCP tokens — search_docs (Free plan and up, read-only, works with any connected token regardless of its scope), get_doc_outline (Free+, read-only; lists every markdown page's title, heading count, and size before searching or writing), and write_docs (Free+, requires a token authorized with read-write scope; commits one or more files as a single atomic git commit). These run against the Docsbook-hosted repository directly, no local checkout needed.
• Local, via markdown-lsp — for an agent working directly on your checked-out files, markdown-lsp exposes richer LSP-style doc_* tools (outline, fuzzy headings, full-text, link references, resolve links) by running npx markdown-lsp <subcommand> ./docs on the agent's machine. See Source of Truth for the tool list and rationale.

Use search_docs/write_docs when the agent only has an MCP connection (no local checkout); use markdown-lsp when the agent already has the repo on disk and wants deeper graph navigation.

Plan gating#

Each tool declares a minimum plan. The server returns a structured error when a tool is called below the required tier.

Related#

• Chat Hooks — Configure pre/post-LLM hooks via MCP.
• Docs Skills — Discover SKILL.md files through find_skill.
• Webhooks — Register event handlers from MCP.