# MCP servers

The usedocs MCP server for docs speaks Streamable HTTP JSON-RPC at [usedocs.app/mcp](https://usedocs.app/mcp), with discovery at [/.well-known/mcp.json](https://usedocs.app/.well-known/mcp.json). Tools: `ask_docs`, `search_docs`, `get_bot_config`. Pass `botId` and `botKey` in each tool's arguments.

```
{
  "mcpServers": {
    "usedocs": { "url": "https://usedocs.app/mcp" }
  }
}
```

The **workspace MCP server** at `https://usedocs.app/mcp/admin` manages your help center from Claude, Claude Code, ChatGPT, Cursor, Codex, or any MCP client, with the same operations as the Docs API: `search_articles`, `get_article`, `create_article`, `update_article`, `publish_article`, `list_drafts`, `get_draft` (with a diff), `propose_edit`, `apply_draft`, `dismiss_draft`, `list_changelog`, `create_changelog_entry`, `create_task` (send the change you're working on), `get_task`, `list_gaps`, `doc_health`, and `check_articles`. Prompts: `document_my_change` and `review_docs`.

Each teammate connects their own client with OAuth sign-in and acts as themselves; setup steps for each client are in Integrations → AI clients. In Claude Code:

```
claude mcp add --transport http usedocs https://usedocs.app/mcp/admin
```

An agent that can't sign in (a CI job) uses a workspace API key; `content:read` keys only see the read tools.

```
{
  "mcpServers": {
    "usedocs": {
      "url": "https://usedocs.app/mcp/admin",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```