DocsLog inGet started

Guide

Getting started with Kagel

Kagel is one connector that puts your Meta, Google Ads and TikTok ad accounts into Claude or ChatGPT. Five minutes from signup to your first campaign report in chat — no API keys, no config files.

1 · Create your account

Sign up at kagel.cc/signup — with Google sign-in or email. That's it: there are no API keys to copy anywhere.

You can also start from the connector: adding it opens Kagel sign-in / signup, and after e-mail verification you return to the connector automatically.

2 · Add the Kagel connector

The connector URL is the same everywhere:

https://mcp.kagel.cc/mcp

Paste the URL, sign in to Kagel, pick the ad platforms to connect (Meta, Google Ads, TikTok Ads; at least one must be working), press Continue in <client>.

Claude.ai / Claude Desktop

Open Settings → Connectors → Add custom connector, paste https://mcp.kagel.cc/mcp and press Connect.

Claude Code

claude mcp add --transport http kagel https://mcp.kagel.cc/mcp

Then run /mcp, pick kagel and choose Authenticate.

ChatGPT

Settings → Apps & Connectors → Advanced settings → Developer mode, then Create: enter a name, the MCP Server URL https://mcp.kagel.cc/mcp and Authentication OAuth.

Gemini CLI

gemini mcp add --transport http kagel https://mcp.kagel.cc/mcp

Then run /mcp auth kagel inside Gemini CLI.

Had the connector before? Remove and re-add it — the old sign-in no longer works.

3 · Manage platforms

Connect or reconnect Meta, Google Ads, TikTok at kagel.cc/connect, or ask the assistant connect Google Ads — it replies with the same link.

4 · First prompts to try

Meta Ads

  • List my ad accounts
  • How did my campaigns perform in the last 7 days? Break it down by campaign
  • Pause campaign X

Google Ads

  • Which of my Google Ads campaigns spent the most last month?
  • Add 10 keywords about running shoes to ad group X

TikTok Ads

  • List my TikTok advertisers
  • TikTok report for the last 7 days

Cross-platform

  • Yesterday's spend across all platforms
  • Show my billing card

For anything that changes a campaign — like pausing one — the assistant shows a confirmation card first.

How approvals work

Reads run immediately. Anything that changes campaign state or budget shows a confirmation card (Meta) or a preview to approve (Google Ads, TikTok) — nothing runs until you confirm.

Billing

9 990 ₸ / month, unlimited ad accounts. Pay by Kaspi QR or an invoice to your phone from the billing card in chat — ask show my billing card. Support: t.me/kagel_ai.

Troubleshooting

  • “… not connected” — connect that platform at kagel.cc/connect or ask the assistant to connect it.
  • Meta: “our app is under review” — Meta’s Access verification for Kagel is pending; until it clears, Meta works only for accounts with a role in our app. Google Ads and TikTok work regardless.
  • Meta expires — Meta access lasts ~60 days; reconnect at kagel.cc/connect (the page shows days left).
  • TikTok stopped working — TikTok authorization expires every 30 days; reconnect at kagel.cc/connect.
  • Google Ads “permission denied” — ask the assistant to link the account to Kagel's manager account (link_to_kagel_mcc).
  • Connector shows no Kagel tools — remove and re-add the connector in your client.
  • Claude asks before running some tools. Read-only tools (lists, reports) can be approved once: in the connector's tool list choose “Always allow” for them. Tools that change campaigns will still ask — that is intentional.

Get started