Claude Code

Connect Claude Code to Zenlytic's MCP server so it can query your business data directly from the command line.

Claude Code connects to remote MCP servers over HTTP transport from the command line. See MCP Server for what you get once connected and general prerequisites.

Before you start

You'll need Zenlytic's MCP URL for your workspace: https://mcp.zenlytic.com/mcp (orgs on a vanity subdomain use a different URL — see Before you start).

Connect with OAuth (recommended)

1. Add the server (swap in your org's URL from Before you start if you're on a vanity subdomain):

claude mcp add --transport http zenlytic https://mcp.zenlytic.com/mcp

1. Inside Claude Code, run /mcp, select zenlytic, and click Authenticate.
2. Complete the OAuth login/approval flow in the browser window that opens, and pick your workspace.

Claude Code stores the token and refreshes it automatically, so you shouldn't need to re-authenticate unless you revoke access.

Connect with a Personal Access Token (alternative)

If OAuth isn't available, add the server with a static bearer header instead. Creating one requires the Admin (or Organization Admin) role — see Option 2.

1. In Zenlytic, go to Workspace Settings → Personal Access Tokens (/workspace-settings/personal-access-tokens), click Create token, and copy it immediately — it's only shown once.
2. Add the server with the token as a header (swap in your org's URL from Before you start if you're on a vanity subdomain):

claude mcp add --transport http zenlytic https://mcp.zenlytic.com/mcp \
  --header "Authorization: Bearer <your-personal-access-token>"

Using it

Once connected, ask Claude Code a data question naturally, for example:

"Hey Zoë, who were our top 5 customers by revenue last month?"

Claude will call the ask_zoe tool and return the answer along with a link back to the full conversation in Zenlytic.

Troubleshooting

• "Unauthorized" or repeated login prompts: run /mcp, select zenlytic, and re-authenticate, or generate a new Personal Access Token.
• Server not found: double-check the URL with claude mcp list, and confirm it with your workspace admin.
• Not sure what got asked/answered: open Zenlytic and check your conversation history — MCP conversations appear there just like conversations started in the app.