Prerequisites
- Claude Code installed (download)
- The Char SaaS MCP server added to your configuration (see Install MCP Servers)
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:update_organization tool to save your configuration.
Check Your Organization
Add Allowed Domains
Access Browser Tools
If you have browser tabs open with Char embedded, you can invoke those tools from Claude Code:Available Tools
| Tool | Purpose |
|---|---|
get_organization | View org details, IDP config, allowed domains |
update_organization | Configure IDP, update allowed domains |
get_subscription | Check plan tier and features |
hub_list_tools | List tools from connected browser tabs |
hub_call_tool | Invoke a browser tool |
Session Persistence
Your authentication persists across Claude Code sessions:- Restart Claude Code → still authenticated
- Close terminal → still authenticated
- Next day → still authenticated
Troubleshooting
Browser window doesn't open
Browser window doesn't open
- 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
Authorization fails
Authorization fails
Tools not appearing
Tools not appearing
- Ensure you have browser tabs open with Char embedded
- Check that those pages have registered WebMCP tools
- Verify you’re authenticated to those applications