Skip to main content
The Char SaaS MCP connects Claude Code to your Char account, letting you manage everything through conversation instead of switching between terminal and dashboard.

​
Prerequisites

​
First-Time Setup

When you first use the Char SaaS MCP, an authentication flow runs automatically:
1

Sign in

A browser window opens to the Char sign-in page. Sign in with your identity provider, or create a new account.
2

Create your organization

If you’re new, name your organization. Char suggests a name based on your email domain (e.g., “Acme” for [email protected]).
3

Authorize Claude Code

Confirm that Claude Code can access your Char account. Click Authorize and the browser closes.
4

Start using

Back in Claude Code, you’re authenticated. Your session persists across restarts.

​
Common Tasks

​
Configure an Identity Provider

Ask Claude to set up your IDP:
Claude uses the update_organization tool to save your configuration.

​
Check Your Organization

Returns your org name, configured IDP, allowed domains, and subscription tier.

​
Add Allowed Domains

These are the origins where you can embed the Char agent.

​
Access Browser Tools

If you have browser tabs open with Char embedded, you can invoke those tools from Claude Code:
This uses the Tool Hub to route calls to your browser.

​
Available Tools

For the full API, see MCP Tools Reference.

​
Session Persistence

Your authentication persists across Claude Code sessions:
  • Restart Claude Code → still authenticated
  • Close terminal → still authenticated
  • Next day → still authenticated
Re-authentication is only needed if you explicitly sign out or your session expires.

​
Troubleshooting

  • Check that your default browser is set correctly
  • Try running Claude Code from a terminal with GUI access
  • On headless systems, copy the URL from the output and open it manually
  • Verify you’re signing into the correct account
  • Check that third-party cookies aren’t blocked
  • Try in an incognito window to rule out extensions
  • Ensure you have browser tabs open with Char embedded
  • Check that those pages have registered WebMCP tools
  • Verify you’re authenticated to those applications

​
See Also

Install MCP Servers

Add the Char SaaS MCP to Claude Code

Tool Hub

How browser tools connect to Claude Code

MCP Tools Reference

Full API documentation

WebMCP Tools

Register tools in your application