---
title: "Connect Claude in 5 minutes"
url: "https://docs.teleflows.io/guides/mcp/get-started/connect-claude.md"
canonical_url: "https://docs.teleflows.io/guides/mcp/get-started/connect-claude/"
last_updated: 2026-10-01
type: tutorial
summary: "Create a Teleflows API key, add the Teleflows MCP server to Claude and ask your first question."
related:
  - "https://docs.teleflows.io/guides/mcp/concepts/roles-and-access.md"
  - "https://docs.teleflows.io/guides/mcp/how-to/create-api-key.md"
  - "https://docs.teleflows.io/guides/mcp/how-to/connect-claude.md"
  - "https://docs.teleflows.io/guides/mcp/reference/limits.md"
  - "https://docs.teleflows.io/guides/mcp/reference/tools.md"
  - "https://docs.teleflows.io/guides/mcp/concepts/sign-in-and-security.md"
  - "https://docs.teleflows.io/guides/mcp/how-to/connect-chatgpt.md"
  - "https://docs.teleflows.io/guides/mcp/how-to/connect-claude-code.md"
---

# Connect Claude in 5 minutes

In this tutorial you connect Claude to your Teleflows data and ask a first question. You need a Teleflows account and a Claude account. It takes about five minutes.

You will:

1. Create a Teleflows API key.
2. Add the Teleflows connector in Claude.
3. Sign in with your key.
4. Ask Claude about your buyers.

> **Note:** The Teleflows MCP server is read-only. Nothing in Teleflows can be created, changed or deleted through it.

## 1. Create an API key

1. In Teleflows, open **Settings → API keys** and create a key.
2. Name it after the app, for example **Claude**.
3. Choose a role and an expiry. The role decides what Claude can see. See [Roles and access](https://docs.teleflows.io/guides/mcp/concepts/roles-and-access/).
4. Copy the key. You can only see the full key once.

More detail: [Create a Teleflows API key](https://docs.teleflows.io/guides/mcp/how-to/create-api-key/).

## 2. Add the connector

1. In Claude, open **Settings → Connectors** and choose **Add custom connector**.
2. Enter the name **Teleflows** and the server address:

   ```
   https://mcp.teleflows.io
   ```

3. Select **Add**, then **Connect**.

## 3. Sign in

A Teleflows sign-in page opens.

1. Check that it names **Claude** and that you will be sent back to **claude.ai**.
2. Paste your API key and select **Connect**.

You return to Claude, and the connector shows as connected.

> **Tip:** If Claude says the connector "wasn't connected" right after you sign in, reload the page. The connector is usually already connected.

## 4. Ask your first question

Start a new chat. If Teleflows is off in this chat, select **+**, choose **Connectors** and turn it on. Then ask:

> List my buyers in Teleflows

Claude asks before it uses a Teleflows tool. Allow it. To stop the questions, set the tools to **Always allow** under [Tool permissions](https://docs.teleflows.io/guides/mcp/how-to/connect-claude/#tool-permissions).

Claude reads your buyers and answers with a list from your account.

A good answer:

- Lists buyers you recognise from Teleflows.
- Says so when a field is missing or masked for your key's role, instead of treating it as zero.
- Says so when Teleflows does not document what a value means, instead of guessing.

## What to ask next

| Area | For example |
|---|---|
| Calls | "Show my last 10 calls" · "How many calls yesterday, by campaign?" · "Is there a recording for this call?" |
| Campaigns | "List my active campaigns" · "Which publishers send traffic to campaign X?" · "Which tracking numbers belong to campaign X?" |
| Routing | "Which buyers are active?" · "Show the routing plan for campaign X" · "What are the caps and recent pings for ring tree target X?" |
| Setup | Workflows, variables, audio files, blocked numbers, pixels, postback and predictive configs |
| Monitoring | "Show this week's conversion receipts" · "Where is target X used?" |

Questions cover up to 31 days at a time, in UTC. See [Limits](https://docs.teleflows.io/guides/mcp/reference/limits/).

## Next steps

- See every tool the assistant can use: [Tools](https://docs.teleflows.io/guides/mcp/reference/tools/).
- Learn [how sign-in keeps your key safe](https://docs.teleflows.io/guides/mcp/concepts/sign-in-and-security/).
- Connect [ChatGPT](https://docs.teleflows.io/guides/mcp/how-to/connect-chatgpt/) or [Claude Code](https://docs.teleflows.io/guides/mcp/how-to/connect-claude-code/).
