By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Gemini to Thrad, create an API key in the Thrad Platform dashboard and paste it into the Thrad card in Ryze AI, then add https://connector.get-ryze.ai/mcp as a custom app in the Gemini web app under Settings, Connected Apps, and type @ in a prompt to use it.
- In the Thrad Platform dashboard open Settings, API keys and create a key that starts with ak_
- In Ryze AI open Integrations, click Connect on Thrad and paste the key
- In gemini.google.com open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection, then type @ and pick Ryze AI
Before you start
- A Gemini account that Google allows. Google's help page for custom apps requires you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. The feature is English only. Google's help page names no paid plan.
- A Thrad API key. The key is created in the Thrad Platform dashboard under Settings, API keys. Thrad says only organization owners and admins can create keys, and each organization has one active key.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Connecting the connector is free; the Thrad tools need an active plan or trial.
- Trust in the server. Google states it does not control, monitor or secure third-party MCP servers, so you decide whether to trust the provider before you connect.
How to connect Gemini to Thrad in the web app
Setup has two parts: Thrad is connected inside Ryze AI with an API key, then Gemini is pointed at the Ryze AI connector. Custom apps can only be added from the Gemini web app on a computer, and they then also work in the Gemini mobile app.
Create a Thrad API key
Sign in to the Thrad Platform dashboard and go to Settings, then API keys. Create a new key and copy it right away. Thrad keys start with ak_, and Thrad shows the full secret only once.
Connect Thrad in Ryze AI
Create a Ryze AI account or sign in, open Integrations, find the Thrad card and click Connect. Paste the key into API key and click Continue. Ryze AI verifies it and the card shows Connected.
Open Connected Apps in Gemini
On a computer go to gemini.google.com. At the bottom click Settings, then Connected Apps. If Connected Apps is missing, click Personal Intelligence first and then Connected Apps.
Add a custom app with the Ryze AI URL
Under Custom apps use the Add a custom app link to get started field, or click Add a custom app if one is already connected. Enter https://connector.get-ryze.ai/mcp and click Next. Ryze AI supports dynamic client registration, so you do not enter credentials under Advanced features.
Allow the workspace
Follow the on-screen instructions: sign in on the Ryze AI page, choose the workspaces that hold your Thrad connection and click Allow connection.
Use the app in a prompt
In a new prompt type @ and select the Ryze AI app, then ask your question, for example: Show my Thrad campaigns with their status and review status.
Source: Google's Gemini help page on custom apps. The Ryze AI Thrad guide covers the API key on the Ryze AI side, and Thrad's authentication docs cover where the key comes from.
Gemini CLI
Gemini CLI reads MCP servers from the command line. One command registers the Ryze AI connector at user scope, which makes it available in every project (the default scope is project). Connect Thrad in Ryze AI first, using the key steps above:
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpStart Gemini CLI. On the first 401 it discovers OAuth, registers a client and opens a browser for the Ryze AI sign-in. Type /mcp auth ryze to start or repeat the sign-in. OAuth needs a local browser and a localhost callback, so it does not work in headless environments or SSH sessions without X11 forwarding.
Prefer the settings file? Add this entry to settings.json:
{
"mcpServers": {
"ryze": { "httpUrl": "https://connector.get-ryze.ai/mcp" }
}
}For a script or a headless machine, create a Ryze AI API key and pass it as a header instead of using OAuth: gemini mcp add --transport http -s user --header "Authorization: Bearer rk_live_..." ryze https://connector.get-ryze.ai/mcp. That key belongs to Ryze AI and is a different key from the ak_ key you paste into the Thrad card. Gemini CLI also filters tools with includeTools and excludeTools in settings.json, which lets you leave thrads__write and thrads__delete out.
Source: Gemini CLI MCP server docs.
Antigravity CLI and Gemini Enterprise
Antigravity CLI
Google's May 19, 2026 announcement says that since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or people using it free of charge through Gemini Code Assist for individuals, and points them to Antigravity CLI. Gemini CLI remains available with Gemini Code Assist Standard or Enterprise licenses and with paid Gemini or Gemini Enterprise Agent Platform API keys. This guide does not cover Antigravity CLI steps.
Gemini Enterprise
Gemini Enterprise has an administrator-run process in the Google Cloud console for custom MCP servers. It accepts StreamableHTTP only, enables up to 100 actions at a time and needs a pre-registered OAuth client ID and secret. Ryze AI documents no such client, so this guide gives no Gemini Enterprise steps.
Sources: Google Developers Blog on Gemini CLI and Antigravity CLI, Gemini Enterprise custom MCP server setup.
Thrad API key and limits
Thrad has no OAuth screen for this connection. Ryze AI stores the API key you paste, and the key decides what Gemini can see. Three things matter.
- Who can create the key
- Thrad says only organization owners and admins can create keys. If you are neither, ask an owner to create one and paste it into Ryze AI for you.
- One key per organization
- Thrad allows one active key per organization. Creating a new key in Thrad makes the old one stop working, so the Thrad card in Ryze AI needs Reconnect with the new key. If other tools use the same key, replace it there too.
- Which account Gemini uses
- One key is one Thrad organization. Add more Thrad accounts to the same Ryze AI workspace under View, Add one more account; a star marks the primary. Ryze AI has no default accounts picker for Thrad, so name the account in your prompt.
Thrad does not publish per-key scopes in the pages checked. These are the documented points about the key and the Thrad limits that apply to every call Gemini makes through it.
| Point | Detail |
|---|---|
| Key format | Keys start with ak_ and are sent as a Bearer token to https://api.thrad.ai/v1. |
| Active keys | One per organization. Rotation keeps the previous key valid for a 30-minute grace window; revoking disables a key immediately. |
| Rate limit | 1,000 requests per hour per key, and 60 per hour per key for creating campaigns. Past that Thrad returns a 429 with the code rate_limit_exceeded. |
| New campaigns | Created in review. Thrad moderates a new campaign before it can serve. |
| Targeting | Country level only, using two-letter country codes. |
Sources: Thrad advertiser API authentication.
Removing access
To remove access, remove the app in Gemini under Settings, Connected Apps. To cut off Thrad itself, click View on the Thrad card in Ryze AI and disconnect the account, and revoke or rotate the key in the Thrad dashboard so it stops working everywhere.
What Gemini can do in Thrad
The Ryze AI connector exposes 5 Thrad tools: 2 read, 2 write and 1 delete. Each runs with the Thrad API key you pasted into Ryze AI.
| Tool | Type | What it does |
|---|---|---|
| thrads__read | Read | Reads any Thrad resource, such as the ad account, campaigns, ad groups, ads and assets. |
| thrads__insights | Read | Returns aggregated Thrad insights combining Thrad and ChatGPT (OpenAI Ads) supply: impressions, clicks, spend, CTR, CPC and CPM. |
| thrads__write | Write | Creates or updates Thrad campaigns, ad groups and ads, and activates or pauses them. |
| thrads__uploadFromUrl | Write | Uploads an image from a URL to get a file id for an ad creative. Thrad currently answers this call with a 404, so existing assets are used instead. |
| thrads__delete | Delete | Archives a Thrad campaign, ad group or ad. Archiving a campaign is irreversible. |
Google's help page says Gemini requires manual confirmation for any write actions, so expect a confirmation step before a change. In Gemini CLI the default asks before tool calls, and setting trust to true (or passing --trust) bypasses all confirmations, so leave it off for this server. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals, and you can switch it in the chat composer to Approve write & delete or Manual approve.
First 3 prompts to run
The prompts below describe what each one asks for. Answers come from your own account, so this page shows no sample numbers.
1. List campaigns and their review state
@Ryze AI Show my Thrad campaigns with name, status and review status. Put any campaign that is in review or rejected at the top.
Tools used: thrads__read
What comes back: A list of your Thrad campaigns with their lifecycle status (active, paused or archived) and review status (in_review, approved or rejected).
2. Compare Thrad and ChatGPT supply
@Ryze AI Pull Thrad insights for the last 30 days, split by source, and show impressions, clicks, spend, CTR, CPC and CPM for each.
Tools used: thrads__insights
What comes back: Rows for the Thrad and ChatGPT (OpenAI Ads) sources with the six metrics, filterable by source.
3. Draft a campaign from existing assets
@Ryze AI Create a Thrad campaign with one ad group and two card ads that use existing assets, targeted to the United States, and tell me its review status.
Tools used: thrads__read, thrads__write
What comes back: A new campaign with its ad group and ads. Thrad submits new campaigns for review before they go live, and Gemini asks you to confirm the write.
Start with read prompts. Once you trust the setup, ask for changes such as pausing a campaign and confirm each one when Gemini asks.
Ryze AI vs the Thrad REST API
Thrad publishes a REST API for advertisers at api.thrad.ai/v1. Its docs, checked on the date above, describe no MCP server, so the table compares the two ways to work with Thrad from Gemini.
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad API key pasted into Ryze AI, then the URL https://connector.get-ryze.ai/mcp as a custom app in Gemini | 5 tools: read, insights, create and update, activate and pause, archive. Image upload currently returns a 404 | Gemini web app and Gemini CLI |
| Thrad advertiser REST API | Send the ak_ key as a Bearer token to https://api.thrad.ai/v1 from your own code | Campaigns, ad groups, ads, assets and insights over plain HTTP, with money in integer micros | Any code that can make HTTP requests |
If you run Thrad from a script or a pipeline, call the REST API directly. Gemini through Ryze AI fits chat jobs: reading campaigns, comparing supply, drafting a campaign and pausing one. Read Thrad's own reference for any field the five connector tools do not describe.
Sources: Thrad advertiser API overview, Thrad docs index, Ryze AI Thrad guide. Checked November 11, 2026.
Errors and fixes
- Connected Apps is missing in Gemini
- Click Personal Intelligence, then Connected Apps. If it is still missing, check Google's requirements: age 18 or over, US, a personal Google Account and Keep Activity on. Custom apps can only be added in the web app.
- Gemini says the app is unavailable
- Google's help page says the feature is unavailable when Keep Activity is off. Turn it on and try again.
- Ryze AI rejects the key
- Check that you copied the whole ak_ key and that it is the active one. Thrad allows one active key per organization, so a rotated or revoked key is refused. Create a fresh key in Settings, API keys and paste it again.
- Thrad was working and then stopped
- Someone created a new key in Thrad, so the old key stopped working. Click Reconnect on the Thrad card in Ryze AI and paste the new key.
- The Thrad tools do not load
- Start a new chat. If they still do not appear, remove the Ryze AI custom app in Connected Apps, add it again and confirm that Thrad shows Connected in Ryze AI.
- Gemini CLI cannot sign in
- OAuth needs a local browser and a localhost callback. In a headless or SSH session use a Ryze AI API key header instead, or run /mcp auth ryze on a machine with a browser.
- Gemini CLI says it no longer serves your plan
- Since June 18, 2026 Google no longer serves Google AI Pro and Ultra users or free Gemini Code Assist for individuals users in Gemini CLI. Google points them to Antigravity CLI.
- A campaign will not activate
- A new Thrad campaign starts in review. Thrad has to approve it before it can serve.
- Image upload fails
- thrads__uploadFromUrl currently gets a 404 from Thrad. Ask Gemini to build ads from assets that already exist in the account.
- An archived campaign cannot come back
- Archiving a campaign is terminal. An archived ad group or ad is deactivated and can be activated again. Pause a campaign instead when you may want it back.
- A rate limit error appears
- Thrad allows 1,000 requests per hour per key and 60 campaign creations per hour. Wait for the window to reset or split the work.
- Gemini says a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI and retry.
Frequently asked questions
How do I connect Gemini to Thrad?
Create an API key in the Thrad Platform dashboard under Settings, API keys, then open Integrations in Ryze AI, click Connect on Thrad and paste the key. In gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, allow the workspace and type @ to pick Ryze AI in a prompt.
Does Thrad have its own MCP server for Gemini?
The Thrad docs checked on November 11, 2026 describe a REST API for advertisers at api.thrad.ai/v1 and do not mention an MCP server. Ryze AI supplies the MCP layer: its connector gives Gemini five Thrad tools through one URL.
Which Thrad connector should I use with Gemini?
Ryze AI is the best Thrad connector for Gemini when you want to read performance and manage campaigns in a chat, but it needs a Ryze AI plan or trial and the Gemini web app asks you to confirm every write. If you run Thrad from code, Thrad's own REST API is the simpler choice.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It requires you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. It is English only.
Can Gemini create or change Thrad campaigns?
Yes. thrads__write creates campaigns, ad groups and card or poll ads, updates them, and activates or pauses them. New campaigns are submitted for Thrad's review before they go live. Google states Gemini requires manual confirmation for any write actions, so you approve each change.
Can Gemini delete Thrad items?
A separate delete tool archives a campaign, ad group or ad. Archiving a campaign is irreversible, while an archived ad group or ad can be activated again.
What numbers can Gemini read from Thrad?
Impressions, clicks, spend, CTR, CPC and CPM, combined across Thrad and ChatGPT (OpenAI Ads) supply and filterable by source.
Does this work in Gemini CLI?
Yes. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, then start Gemini CLI and sign in, or run /mcp auth ryze. Since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or free Code Assist for individuals users.
Does it work in the Gemini mobile app?
Custom apps can only be added in the Gemini web app. Once connected on the web, Google says the app also works in the Gemini mobile app.
Can I use more than one Thrad account?
Yes. Add another account on the Thrad card with View, Add one more account. A star marks the primary, and there is no default accounts picker, so name the account in your prompt. Over MCP every Thrad tool takes an optional connection_id.
Why do the Thrad tools not show up in Gemini?
Start a new chat first. If they are still missing, remove the Ryze AI custom app in Connected Apps, add it again and confirm that Thrad shows Connected in Ryze AI.
How much does it cost to connect Gemini to Thrad?
Connecting is free, but the Thrad tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year. Thrad's own billing, such as a deposit when creating campaigns, is charged by Thrad.
How do I disconnect Thrad from Gemini?
Remove the Ryze AI app in Gemini under Settings, Connected Apps. To cut off Thrad itself, disconnect the account on the Thrad card in Ryze AI and revoke or rotate the key in the Thrad dashboard.