MCP Setup

​

Endpoint Map and Auth Expectations

​

Optional Local Browser Automation (Chrome DevTools MCP Fork)

npx -y @mcp-b/chrome-devtools-mcp@latest

• Package: @mcp-b/chrome-devtools-mcp
• Source: WebMCP-org/npm-packages/packages/chrome-devtools-mcp

​

Client Workflows

​

Claude Code (Recommended: Plugin-First)

​

Install

/plugin marketplace add WebMCP-org/char-plugin
/plugin install char@webmcp
/char:setup

​

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)

​

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)

​

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

• Claude Code plugins reference
• Claude Code MCP docs
• Codex MCP docs (OpenAI)
• MCP in Gemini CLI
• Cursor MCP docs
• VS Code MCP docs
• Windsurf MCP setup
• Vercel MCP setup patterns
• Char plugin README

​

Related

• MCP Server Styles
• Skills and Plugins
• Char SaaS MCP Guide