> For the complete documentation index, see [llms.txt](https://docs.zenlytic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zenlytic.com/mcp/connecting-to-zenlytic/claude-ai.md).

# Claude.ai

Claude.ai support MCP custom connectors with OAuth out of the box, so this is one of the easiest clients to connect to Zenlytic. See [MCP Server](/mcp/connecting-to-zenlytic.md) for what you get once connected and general prerequisites.

## Before you start

You'll need Zenlytic's MCP URL for your workspace. URL: <https://mcp.zenlytic.com/mcp>

## Connect with OAuth (recommended)

1. Open **Settings → Connectors**
2. Click **Add**, then choose **Add custom connector**.
3. Paste in Zenlytic's MCP URL and click **Add**.
4. Click **Connect**, complete the OAuth login/approval flow in the browser window that opens, and pick your workspace.

Your connector is now authorized — you won't need to log in again unless you revoke access.

## Connect with a Personal Access Token (alternative)

If OAuth isn't available, you can authenticate with a static token instead:

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. In the **Add custom connector** dialog, open **Advanced settings**.
3. Add a request header named `Authorization` with the value `Bearer <your-personal-access-token>`, and mark it required.
4. Click **Add**, then **Connect**.

## Using it

Once connected, ask Claude 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zenlytic.com/mcp/connecting-to-zenlytic/claude-ai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.