Setup guide

Install

Meta Ads

Facebook and Instagram ad performance, campaigns, ad sets and ads — read-only (ads_read).

What you need

• A Facebook account with access to the ad account (Business Manager → Ad accounts, any role).

How to connect

1. Press “Authorize with Meta” on this page; in the Facebook dialog keep all permissions and pick the businesses and pages.
2. One Meta connection serves Meta Ads, Facebook Pages and Instagram.
3. Open Data preview: the Meta section lists your ad accounts and last-7-day campaigns.

Common errors and what to do

• No ad accounts are listed — the Facebook account has no role in the ad account; ask the admin to add you in Business settings.
• The connection expired (about 60 days) — press “Authorize again”.

Connect on the Connections page More about Meta Ads →

Google Ads

Campaign, ad group and ad reports via GAQL — read-only (adwords).

What you need

• A Google account with access to the Google Ads account (any access level).

How to connect

1. Press “Authorize with Google” (the same consent as GA4 and Search Console).
2. Nothing else to enter: if the account is reached through a manager account (MCC), Marketing Kit finds the manager account itself. Only when an ad account is reachable through several manager accounts and you need a specific one: open Google on this page → “Advanced · Google Ads login customer ID” (10 digits, hyphens allowed); a value in the Claude Desktop extension settings takes priority over it.
3. Ask Claude about spend, clicks or conversions; the list of accounts — “which Google Ads accounts do I have” (direct and through manager accounts, with name and status).

Common errors and what to do

• “Google Ads API access for Marketing Kit is still at test level” — the server's developer token is waiting for Google's approval (Basic access). At test level Google Ads answers only for test accounts — nothing to fix on your side, it starts working once Google approves.
• USER_PERMISSION_DENIED or “customer not found” — the account is not visible to the connected Google account (neither directly nor through a manager account Marketing Kit can reach): check your access to it in Google Ads → Admin → Access and security. The Google connection stays as it is.
• “The Google Ads developer token is not set up by the owner yet” — the site owner has not configured Google Ads yet.

Connect on the Connections page More about Google Ads →

TikTok Ads

TikTok advertiser accounts, ad performance reports, campaigns, ad groups and ads — read-only. Organic TikTok (videos, followers) is not covered.

What you need

• A TikTok for Business account with access to the advertiser account (TikTok Ads Manager).

How to connect

1. Press “Authorize with TikTok” in the TikTok row; sign in to TikTok for Business and allow access for the advertiser accounts you need.
2. Open Data preview: the TikTok Ads section lists your advertisers and 7-day campaigns.

Common errors and what to do

• “not configured by the owner” / TikTok row “Unavailable” — the site owner has not finished setting up the TikTok app (TikTok reviews it first). The Authorize button is disabled until then; nothing to do on your side.
• An advertiser is missing — it was not selected when authorizing; press “Authorize again” and select it.

Connect on the Connections page More about TikTok Ads →

Facebook Pages

Pages, posts, page and post insights — read-only (pages_show_list, pages_read_engagement, read_insights).

What you need

• A Facebook account with a role on the Page (or a task in the Business portfolio that owns it).

How to connect

1. Press “Authorize with Meta” — or “Authorize again” if the Meta row says “Facebook Pages … missing permissions”. Re-authorizing adds the Page permissions; the Ads connection keeps working.
2. In the Facebook dialog choose the Pages to share and keep all checkboxes.
3. Open Data preview: the Facebook Pages section shows your Pages, 7-day insights and recent posts.

Common errors and what to do

• “Re-authorize Meta to enable Facebook Pages” — the saved Meta connection was granted before Pages were added; re-authorize and keep all checkboxes.
• A Page is missing — it was not selected in the Facebook dialog; re-authorize and select it.

Connect on the Connections page More about Facebook Pages →

Instagram

Instagram professional account profile, insights, media and media insights — read-only.

What you need

• An Instagram Business or Creator account (not a personal one): Instagram → Settings → Account type and tools → Switch to professional account.
• The Instagram account linked to a Facebook Page you manage: Page settings → Linked accounts → Instagram.

How to connect

1. Press “Authorize with Meta” — or “Authorize again” if the Meta row says “… Instagram missing permissions”. This adds the Instagram permissions; the Ads connection keeps working.
2. In the Facebook dialog select the Page the Instagram account is linked to, and the Instagram account itself.
3. Open Data preview: the Instagram section shows the account and its 7-day insights.

Common errors and what to do

• “No Instagram professional accounts linked to the user's Pages” — switch the account to Business/Creator and link it to a Page, then re-authorize Meta.
• “Re-authorize Meta to enable Instagram” — re-authorize and keep all checkboxes; Meta adds permissions only through a new consent.

Connect on the Connections page More about Instagram →

Google Search Console

Organic Google Search: clicks, impressions, CTR and position by query, page, country, device; sitemaps; URL index status — read-only (webmasters.readonly).

What you need

• A Google account added to the property in Search Console (Settings → Users and permissions).

How to connect

1. Press “Authorize with Google”. If the Google row says “Search Console missing permissions”, press “Authorize again” and keep the Search Console checkbox.
2. Open Data preview: the Search Console section lists your properties and the last 28 days.
3. In Claude, ask about search queries, pages or positions. The property looks like https://example.com/ or sc-domain:example.com.

Common errors and what to do

• “Reconnect Google to add Search Console” — re-authorize Google and keep the Search Console checkbox; GA4 and Google Ads keep working meanwhile.
• “Search Console API is not enabled in the Google Cloud project …” — a setting of the site owner; your connection is kept.
• The last 2–3 days are empty — Google publishes search data with a 2–3 day delay; not an error.

Connect on the Connections page More about Google Search Console →

Google Analytics 4

Reports, realtime and metadata of your GA4 properties — read-only (analytics.readonly).

What you need

• A Google account with at least Viewer access to the GA4 property (GA4 → Admin → Property access management).
• An account on this site (sign in with Google or Meta).

How to connect

1. On this page press “Authorize with Google” — one consent covers GA4, Google Ads and Search Console.
2. Pick the Google account that sees your GA4 property and leave every checkbox ticked.
3. Back here the Google row shows “Connected”. Open Data preview to check: the GA4 section lists your properties.
4. In Claude, ask about users, sessions or events — the property id comes from the list of properties.

Common errors and what to do

• No GA4 properties are listed — the Google account you authorized has no access to the property; ask for Viewer access or reconnect with the right account.
• “Google Analytics Data API is not enabled in the Google Cloud project …” — a setting of the site owner, not yours; the message has the enable link for the owner. Your connection is kept.

Connect on the Connections page More about Google Analytics 4 →

AppsFlyer

Installs and in-app events by media source, campaign and geo; raw data; OneLink links. Saved encrypted on the server, or kept in the Claude Desktop extension.

What you need

• An AppsFlyer user with access to the apps (an admin can issue tokens for the account).
• Optional: the Marketing Kit extension in Claude Desktop, if you prefer to keep the token there.

How to connect

1. In AppsFlyer open the profile menu → Security center (Account settings → Security center) → API tokens.
2. Create (or copy) an API token V2 — Pull API (aggregate and raw data) access is needed. Tokens issued before 2026-03-10 are revoked: create a new one if yours is older.
3. On this page (Connections), under AppsFlyer, paste it into “API token V2” and press Save. It is stored encrypted on marketing-kit.app. Alternatively, in the Claude Desktop extension: Settings → Extensions → Marketing Kit → “AppsFlyer token”; a token entered there takes priority.
4. Ask Claude about installs by media source.
5. OneLink links (creating and editing) need a separate OneLink API token — ask your AppsFlyer manager to enable it, then paste it into “OneLink API token” on this page (or in the extension).

Common errors and what to do

• “appsflyer_token_missing” — the token is not saved here and not in the extension; paste it on this page (step 3).
• 401 / “token is not valid” — the token was revoked or issued before 2026-03-10; create a new API token V2.
• “no Raw Data module” — raw reports need the Raw Data add-on in your AppsFlyer plan; aggregate reports work without it.

Connect on the Connections page More about AppsFlyer →

RevenueCat

Subscription metrics (MRR, active subscriptions and trials, revenue), charts, products, entitlements, offerings and one customer's subscriptions — read-only, REST API v2. Saved encrypted on the server, or kept in the Claude Desktop extension.

What you need

• A RevenueCat collaborator role that can manage API keys in the project.
• Optional: the Marketing Kit extension in Claude Desktop, if you prefer to keep the key there.

How to connect

1. In RevenueCat open your project → Project settings → API keys → “+ New secret API key”.
2. Name it (for example “Marketing Kit”), choose version V2 and set permissions: Charts & Metrics — Read, Customer Information — Read, Project Configuration — Read; everything else — No access. Press Generate and copy the key (sk_…); it is shown once.
3. On this page (Connections), under RevenueCat, paste it into “Secret API key V2” and press Save. It is stored encrypted on marketing-kit.app. Alternatively, in the Claude Desktop extension: Settings → Extensions → Marketing Kit → “RevenueCat secret API key”; a key entered there takes priority.
4. Ask Claude “what is our MRR” or “trial conversion last month”.

Common errors and what to do

• “revenuecat_key_missing” — the key is not saved here and not in the extension; paste it on this page (step 3).
• 401 authentication_error — the key is a v1 key or a public SDK key (appl_, goog_); issue a secret key with version V2.
• 403 authorization_error — the key lacks a Read permission for that area or belongs to another project; edit its permissions or issue a new key.
• Rate limit — charts and metrics allow 25 requests per minute per key; wait a minute.

Connect on the Connections page More about RevenueCat →

App Store Connect

Your own apps in App Store Connect: apps, sales and downloads by country and device, subscription reports and events, App Store funnel, sources, sessions and crashes, reviews, versions and Product Page Optimization setup. Team API key, read-only except one confirmed action. This is not the public App Store data (that is the “Apple App Store” source).

What you need

• An Apple Developer account with App Store Connect access. Only the Account Holder or an Admin can create team keys; the first time, the Account Holder must press “Request Access” in the API section.
• A team key, not an individual key: individual keys cannot read Sales and Trends. A team key sees all apps of the team.
• For sales and subscription reports: the vendor number of the team.

How to connect

1. Open https://appstoreconnect.apple.com/access/integrations/api → tab Team Keys (not Individual Keys). Only the Account Holder and Admins see it; if there is a “Request Access” button, the Account Holder presses it once.
2. Issuer ID — above the key table, with a Copy button (one per team).
3. Press “+”, name the key “Marketing Kit”, Access: Admin (the only role that covers every mode).
4. In the new key's row: Key ID (10 characters) and Download for the .p8 file — Apple lets you download it only once.
5. Vendor number — App Store Connect → Payments and Financial Reports, top left under your company name.
6. Enter all of it here under App Store Connect and press Save key (the vendor number has its own Save). It is stored encrypted and never shown back. Then ask Claude “installs and proceeds last week”.

Common errors and what to do

• “app_store_connect_key_missing” — no key is saved; enter it on this page (step 6).
• “app_store_connect_vendor_number_missing” — sales and subscriptions need the vendor number; save it on this page (step 5).
• 401 / “key is not valid” — the key was revoked or the Issuer ID, Key ID and .p8 do not belong together; create a new team key and save all three again.
• 403 — the key's role is too narrow for that mode (for example, enabling Analytics Reports needs Admin); create a key with a wider role.
• No sales for a date — Apple has no report yet (reports appear about 08:00 Pacific time the next day) or the vendor number is wrong.

Connect on the Connections page More about App Store Connect →

Apple App Store

Public App Store data (not your App Store Connect account): app details, ratings, reviews and top charts. No authorization, no key.

What you need

• Nothing — the data is public.
• The App Store ID of the app (the number after “id” in the App Store link) or its bundle ID.

How to connect

1. Connect Marketing Kit to Claude (Install page, “Connect to Claude”) and ask, for example: “rating and latest reviews of app id1627714743 in the US”.
2. Ratings and reviews are per App Store country — name the country.

Common errors and what to do

• “No results” — check the App Store ID and the country: an app may not be available in every store.

Connect on the Connections page

Errors you may see with any source

• “source not authorized” — the source is not connected (or the provider revoked access): press Authorize on the Connections page.
• “Reconnect to add …” / “Re-authorize … to enable …” — the saved connection was granted before this source was added; authorize the provider again and keep every checkbox. Other sources keep working.
• “not configured by the owner” — the site owner has not set up this provider yet; nothing to do on your side.
• Google “Google hasn't verified this app” — while Google's review is pending, press Advanced → “Go to marketing-kit.app (unsafe)” → Continue.
• Meta “App not active” / “This app isn't available” — the Meta app is in development mode or waiting for Meta's review; only people with a role in the app can connect for now — ask the site owner.