Skip to Content
MCP / AIClient setupClaude Code

MCP Client Setup — Claude Code

Use the exact configuration shown on your tenant’s Settings → MCP page in the FlowState app. It is generated from your tenant’s live gateway URL and credentials, and is the source of truth if it ever differs from this page.

  1. In the FlowState app, go to Settings → MCP.
  2. Copy the Claude Code snippet shown there — it is generated from your tenant’s live gateway URL and agent ID, not hand-typed.
  3. Paste it into .claude/settings.json (project-level) or ~/.claude/settings.json (user-level), under mcpServers.

The in-app snippet currently uses an SSE transport ("type": "sse") with no inline auth block — the app’s copy of the config is the source of truth; if it differs from what’s shown here, follow the app.

Trigger the auth flow

  1. Start a Claude Code session: claude.
  2. Reference a FlowState tool in your prompt: “List my FlowState tenants.”
  3. Claude Code opens your default browser to authenticate.
  4. Sign in with your FlowState credentials.
  5. Tokens are stored and the session continues.

Project-level setup

For a project where all team members need FlowState access, add the MCP server to the project-level .claude/settings.json instead of ~/.claude/settings.json. Each team member still authenticates individually — the project settings define which MCP server to use, not the credentials.

Verifying the connection

In a Claude Code session, run:

/mcp

This lists connected MCP servers and their status. flowstate should appear with a green indicator and the tool count. If authentication is needed, Claude Code prompts you.

Using FlowState tools in code workflows

Claude Code can use FlowState tools inline while working on code. For example:

“Analyze the deals in the Acme tenant pipeline and show me which ones are stalled — I need this to write a test fixture.”

Claude Code calls FlowState tools to fetch the live data, then uses it in your coding context. Tenant context comes from the JWT of whichever tenant you’re scoped into on the web app — see MCP → Authentication. There is no MCP-side tenant switch to call from within Claude Code.

Claude DesktopAPI