Skip to main content
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.

​
Endpoint Map and Auth Expectations

AliasEndpointAuth expectationFirst-use behavior
char-docshttps://docs.usechar.ai/mcpPublic docs endpointConnects directly in most clients
webmcp-docshttps://docs.mcp-b.ai/mcpPublic docs endpointConnects directly in most clients
char-saashttps://app.usechar.ai/mcpAuth-gatedUsually 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: 
npx -y @mcp-b/chrome-devtools-mcp@latest

​
Client Workflows

​
Install

/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)

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

/mcp

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)

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

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

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)

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

​
Manual config (.cursor/mcp.json)

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

​
Manual config (.vscode/mcp.json)

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

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