> ## Documentation Index > Fetch the complete documentation index at: https://docs.usechar.com/llms.txt > Use this file to discover all available pages before exploring further. # MCP Setup > Client-by-client setup for Char MCP endpoints with install, verify, usage, and troubleshooting steps. Use this guide when you want a single, predictable setup path per client. This page is operational (how-to). For architecture and transport choices, see [MCP Server Styles](/vibe/mcp-server-styles). ## Endpoint Map and Auth Expectations | Alias | Endpoint | Auth expectation | First-use behavior | | ------------- | ----------------------------- | -------------------- | --------------------------------------------------------------- | | `char-docs` | `https://docs.usechar.ai/mcp` | Public docs endpoint | Connects directly in most clients | | `webmcp-docs` | `https://docs.mcp-b.ai/mcp` | Public docs endpoint | Connects directly in most clients | | `char-saas` | `https://app.usechar.ai/mcp` | Auth-gated | Usually prompts browser sign-in/authorization on first tool use | ## Optional Local Browser Automation (Chrome DevTools MCP Fork) Add this local server if you want browser automation tools: ```bash theme={null} npx -y @mcp-b/chrome-devtools-mcp@latest ``` * Package: [`@mcp-b/chrome-devtools-mcp`](https://www.npmjs.com/package/@mcp-b/chrome-devtools-mcp) * Source: [WebMCP-org/npm-packages/packages/chrome-devtools-mcp](https://github.com/WebMCP-org/npm-packages/tree/main/packages/chrome-devtools-mcp) ## Client Workflows ### Claude Code (Recommended: Plugin-First) #### Install ```bash theme={null} /plugin marketplace add WebMCP-org/char-plugin /plugin install char@webmcp /char:setup ``` Plugin setup auto-adds: `chrome-devtools`, `char-docs`, `webmcp-docs`, `char-saas`. #### Manual fallback (no plugin) ```bash theme={null} claude mcp add --transport http char-docs https://docs.usechar.ai/mcp claude mcp add --transport http webmcp-docs https://docs.mcp-b.ai/mcp claude mcp add --transport http char-saas https://app.usechar.ai/mcp claude mcp add chrome-devtools npx -y @mcp-b/chrome-devtools-mcp@latest ``` #### Verify ```text theme={null} /mcp ``` ```bash theme={null} claude mcp list ``` #### Use in chat * Ask for docs/tool calls normally; Claude will select tools when relevant. * Use aliases in prompts when you want to force source selection (for example, `char-docs` vs `webmcp-docs`). #### Manage and troubleshoot * Re-run `/char:setup` if plugin-managed servers drift. * Remove and re-add a failing server if it remains disconnected. * For `char-saas`, finish browser auth before retrying MCP tools. #### Scope options (`local`, `project`, `user`) ```bash theme={null} claude mcp add --transport http char-docs --scope local https://docs.usechar.ai/mcp claude mcp add --transport http char-docs --scope project https://docs.usechar.ai/mcp claude mcp add --transport http char-docs --scope user https://docs.usechar.ai/mcp ``` ### Codex CLI #### Install ```bash theme={null} codex mcp add char-docs --url https://docs.usechar.ai/mcp codex mcp add webmcp-docs --url https://docs.mcp-b.ai/mcp codex mcp add char-saas --url https://app.usechar.ai/mcp codex mcp add chrome-devtools -- npx -y @mcp-b/chrome-devtools-mcp@latest ``` #### Verify ```bash theme={null} codex mcp list ``` #### Use in chat * Prompt normally and reference server aliases when you want explicit routing. #### Manage and troubleshoot * If a server is missing or stale, run the add command again. * Complete `char-saas` auth in browser when prompted. ### Gemini CLI #### Configure (`~/.gemini/settings.json`) ```json theme={null} { "mcpServers": { "char-docs": { "httpUrl": "https://docs.usechar.ai/mcp" }, "webmcp-docs": { "httpUrl": "https://docs.mcp-b.ai/mcp" }, "char-saas": { "httpUrl": "https://app.usechar.ai/mcp" }, "chrome-devtools": { "command": "npx", "args": ["-y", "@mcp-b/chrome-devtools-mcp@latest"] } } } ``` #### Verify * Start Gemini CLI and run `/mcp` to confirm servers are registered and connected. #### Use in chat * Ask normally; include endpoint aliases in prompts when needed. #### Manage and troubleshoot * Re-open Gemini CLI after editing `settings.json`. * Re-auth `char-saas` if tool calls return `401`. ### Cursor #### One-click add (`char-saas`) [Add Char SaaS in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=char-saas\&config=eyJ1cmwiOiJodHRwczovL2FwcC51c2VjaGFyLmFpL21jcCJ9) #### Manual config (`.cursor/mcp.json`) ```json theme={null} { "mcpServers": { "char-docs": { "url": "https://docs.usechar.ai/mcp" }, "webmcp-docs": { "url": "https://docs.mcp-b.ai/mcp" }, "char-saas": { "url": "https://app.usechar.ai/mcp" }, "chrome-devtools": { "command": "npx", "args": ["-y", "@mcp-b/chrome-devtools-mcp@latest"] } } } ``` #### Verify * Open Cursor MCP settings and confirm each server reports connected/ready. #### Use in chat * Use Agent mode and run prompts normally; tools are auto-selected when relevant. #### Manage and troubleshoot * Restart Cursor after editing MCP config files. * Check server status/logs in MCP settings before re-adding servers. ### VS Code + GitHub Copilot #### One-click add (`char-saas`) [Add Char SaaS in VS Code](vscode:mcp/install?%7B%22name%22%3A%22Char%20SaaS%22%2C%22url%22%3A%22https%3A%2F%2Fapp.usechar.ai%2Fmcp%22%7D) #### Manual config (`.vscode/mcp.json`) ```json theme={null} { "servers": { "char-docs": { "type": "http", "url": "https://docs.usechar.ai/mcp" }, "webmcp-docs": { "type": "http", "url": "https://docs.mcp-b.ai/mcp" }, "char-saas": { "type": "http", "url": "https://app.usechar.ai/mcp" } } } ``` #### Verify * Run `MCP: List Servers` from Command Palette. #### Use in chat * Open Copilot Chat, switch to Agent mode, and confirm tools are available. #### Manage and troubleshoot * Re-open VS Code window after config edits. * Re-run auth for `char-saas` when prompted. ### Windsurf #### Install (`~/.config/codeium/windsurf/mcp_config.json`) ```json theme={null} { "mcpServers": { "char-docs": { "serverUrl": "https://docs.usechar.ai/mcp" }, "webmcp-docs": { "serverUrl": "https://docs.mcp-b.ai/mcp" }, "char-saas": { "serverUrl": "https://app.usechar.ai/mcp" }, "chrome-devtools": { "command": "npx", "args": ["-y", "@mcp-b/chrome-devtools-mcp@latest"] } } } ``` #### Verify * Check MCP server status in Windsurf MCP settings. #### Use in chat * Use Cascade normally; MCP tools should be available automatically. #### Manage and troubleshoot * Restart Windsurf after config edits. * Use MCP server status/log views for connection failures. ### UI-managed clients (ChatGPT, Claude Desktop, Claude.ai) * Add a custom remote MCP server in client settings. * Prefer `https://app.usechar.ai/mcp` for full Char SaaS access. * Complete browser auth when prompted. ## Quick Verification Checklist 1. Endpoint aliases appear in your client/server list. 2. `char-docs` and `webmcp-docs` respond without auth prompts. 3. `char-saas` completes auth and no longer returns `401`. 4. Optional `chrome-devtools` server is connected when browser tooling is needed. ## Sources * [Claude Code plugins reference](https://code.claude.com/docs/en/plugins-reference) * [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) * [Codex MCP docs (OpenAI)](https://developers.openai.com/codex/mcp) * [MCP in Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) * [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) * [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) * [Windsurf MCP setup](https://docs.windsurf.com/windsurf/cascade/mcp) * [Vercel MCP setup patterns](https://vercel.com/docs/ai-resources/vercel-mcp) * [Char plugin README](https://github.com/WebMCP-org/char-plugin) ## Related * [MCP Server Styles](/vibe/mcp-server-styles) * [Skills and Plugins](/vibe/skills-and-plugins) * [Char SaaS MCP Guide](/guides/char-saas-mcp)