By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Claude to Thrad, create an API key in the Thrad Platform dashboard, paste it into the Thrad card in Ryze AI, then add https://connector.get-ryze.ai/mcp as a custom connector in Claude and start a new chat.
- In Thrad open Settings, API keys and create a key that starts with ak_
- In Ryze AI open Integrations, click Connect on Thrad, paste the key and click Continue
- In Claude open Customize, Connectors, Add custom connector and paste the URL
- Click Connect, pick the workspace, click Allow connection, open a new chat
Before you start
- A Claude account. Anthropic lists custom connectors on Claude, Cowork and Claude Desktop for Free, Pro, Max, Ultra, Team and Enterprise plans. Free users can add one custom connector. On Team plans only Owners and Primary Owners can add it; on Enterprise plans Owners, Primary Owners and people with a custom role that includes Manage access to Libraries can. Members then connect to it individually.
- A Thrad account with an 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; Agency is $279 per month for agencies. Connecting the Ryze AI connector is free, but the Thrad tools need an active plan or trial.
How to connect Claude to Thrad in claude.ai
The first three steps happen in Thrad and Ryze AI, the last three in Claude. The connector URL is the same for every user.
Open Settings, API keys in Thrad
Sign in to the Thrad Platform dashboard and go to Settings, then API keys. You need to be an owner or admin of the Thrad organization to create a key.
Create a key and copy it
Create a new key and copy it right away. Thrad keys start with ak_. Thrad shows the secret once, and a later list only shows a masked preview.
Paste the key into Ryze AI
Create a Ryze AI account or sign in, open Integrations and click Connect on the Thrad card. Paste the key into API key and click Continue. Ryze AI verifies the key and the card shows Connected.
Add the custom connector in Claude
In claude.ai open Customize, then Connectors. Click + Add, choose Add custom connector, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, then click Continue. On the authentication step do not choose No sign in: the Ryze AI server uses OAuth sign-in and needs no key or request header in Claude.
Click Connect and allow the workspace
Click Add, then Connect on the Ryze AI connector. On the Ryze AI page Connect your data sources to AI, sign in (or sign up), choose the workspaces Claude can access (up to 20 per connection) and click Allow connection.
Open a new chat and ask your first question
Connectors are turned on or off per conversation from the + button, Connectors, so start a new chat. Ask: Show my Thrad campaigns with their status and review status.
The Ryze AI help article for Thrad covers the Thrad side of the connection, and the Claude connector FAQ covers the connection errors.
Claude Desktop, Team and Enterprise plans, and the Claude Directory
Claude connects to a remote MCP server from Anthropic's cloud, not from your device, so the same connector covers claude.ai, Claude Desktop, Cowork and the mobile apps. The steps above are the same in Claude Desktop under Customize, Connectors. Team plans and the Claude Directory differ in who adds the connector.
Team and Enterprise organizations
- An Owner or Primary Owner opens Organization settings, Connectors and clicks Add. On Enterprise, a person with a custom role that includes Manage access to Libraries can do this too.
- Hover over Custom, select Web, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, then click Continue.
- Under Authentication choose Sign in now or Sign in when needed (not No sign in), then click Add.
- Each member opens Customize, Connectors, finds Ryze AI (usually labeled Custom) and clicks Connect, signs in on the Ryze AI page, picks workspaces and clicks Allow connection.
Claude Directory listing
- Open the Ryze AI listing at claude.ai/directory/ryze-ai and sign in to Claude if the button reads Sign in to add.
- Add the connector from the listing, then complete the Ryze AI sign-in, choose workspaces and click Allow connection.
- The listing carries the Community label. Anthropic says community connectors have gone through automated reviews but are not verified by Anthropic.
Claude Code
Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account; the free claude.ai plan does not include it. One command registers the connector:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userThen open Claude Code, run /mcp, select ryze and authenticate, or run claude mcp login ryze in a shell (add --no-browser over SSH to print the URL). Sign in on the Ryze AI page, choose workspaces and click Allow connection. Without --scope the server is local to the current project; --scope user covers all projects and --scope project writes a .mcp.json for your team. Check the status with claude mcp get ryze.
Claude Code is a fit when a Thrad pull feeds a file or a script. For unattended runs, claude -p cannot run the OAuth flow, so sign in first with /mcp. Ryze AI also issues API keys (Workspace Settings, Profile, API keys) that go in an Authorization Bearer header on the /mcp endpoint.
ChatGPT and Cursor
The same URL works in other MCP clients. The Thrad key is entered once in Ryze AI, so nothing changes on the Thrad side.
ChatGPT
OpenAI lists custom MCP servers on ChatGPT Business and Enterprise/Edu web workspaces; Pro users can connect them with read and fetch permissions only, so Thrad write tools are not available there. On Business an admin or owner creates the server. Open Plugins, select the plus button, choose Add custom MCP server, name it Ryze AI, enter https://connector.get-ryze.ai/mcp, choose OAuth, create it, sign in to Ryze AI and allow the workspace.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project), then complete the Ryze AI sign-in when Cursor asks. Cursor asks for approval before it uses MCP tools by default.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }The Thrad API key
Thrad has no OAuth screen for this connection. Ryze AI stores the API key you paste, and the key decides what Claude 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 Claude 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 chat.
What Thrad documents about its keys
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 Claude makes through it.
| Topic | What Thrad documents |
|---|---|
| Key format | Keys start with ak_ and are sent as a Bearer token to https://api.thrad.ai/v1. |
| Who creates it | Organization owners and admins, in the Thrad Platform dashboard under Settings, API keys. |
| 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 paused and submitted for Thrad's review. Only an approved, paused campaign can be activated. |
| Targeting | Country level, using two-letter country codes. |
Sources: Thrad's authentication reference and campaigns reference.
Removing access
To remove access, click View on the Thrad card in Ryze AI and disconnect the account, and revoke or rotate the key in the Thrad dashboard if you want it dead everywhere. In Claude, open Customize, Connectors, Ryze AI and click Disconnect.
What Claude can do in Thrad
The Ryze AI connector exposes five Thrad tools. Every tool also takes an optional connection_id, which selects the account when more than one Thrad account is connected.
| 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 insights that combine Thrad and ChatGPT (OpenAI Ads) supply: impressions, clicks, spend, CTR, CPC and CPM. |
| thrads__write | Write | Creates or updates campaigns, ad groups and ads, and activates or pauses them. New campaigns go to Thrad for review before they go live. |
| thrads__uploadFromUrl | Write | Uploads an image from a URL to get a file id for a creative. Thrad currently answers this call with a 404, so existing assets are used instead. |
| thrads__delete | Delete | Archives a campaign, ad group or ad. Archiving a campaign is irreversible. |
You choose which tools need your approval in Claude. In Customize, Connectors, Ryze AI, Tool permissions, set write and delete tools to Needs approval so Claude asks before it activates a campaign or archives anything. In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals.
First 3 prompts to run
Thrad runs ads on its own supply and on ChatGPT (OpenAI Ads) supply, and the insights tool returns both in one read. Thrad records two separate states on a campaign: a lifecycle status (active, paused or archived) and a review status (in_review, approved or rejected). The prompts below use those words, and each answer comes from your own account.
1. Campaigns and their review status
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 and review status, with the in-review and rejected ones first.
2. Thrad against ChatGPT supply
Pull Thrad insights for the last 30 days and split the rows by source, Thrad and ChatGPT. Show impressions, clicks, spend, CTR, CPC and CPM for each, then tell me which source costs less per click.
Tools used: thrads__insights
What comes back: One row per source with the six metrics, and a plain comparison of cost per click between the two.
3. A new campaign from a brief
Create a Thrad campaign named after my spring offer with one ad group and two card ads that use existing assets, targeted to the United States. Leave it ready for review and tell me its review status.
Tools used: thrads__read, thrads__write
What comes back: The new campaign with its ad group and ads, its paused status and an in-review status. Thrad reviews new campaigns before they can serve.
Claude works from the tools in the table above, so a prompt that asks for something they do not cover, such as targeting below country level, will come back with a limit instead of a result. Ask Claude to confirm before it activates or archives anything.
Ryze AI vs the Thrad API and Thrad's agent skills
Thrad publishes a REST API for advertisers and agent skills for coding agents. At the time of the check its docs did not describe an MCP server, so the table compares the three ways to work with Thrad.
| Option | Setup | Thrad coverage | Works in |
|---|---|---|---|
| Ryze AI connector | Thrad API key pasted into Ryze AI, then one custom connector URL in Claude | Read, insights, create and update, activate and pause, archive. Five tools; image upload currently returns a 404 | claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor |
| 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 and insights, with budget and pricing fields such as CPM or CPC, and an Idempotency-Key header for safe retries | Any code that can make HTTP requests |
| Thrad agent skills | Paste a skill file reference into a coding agent | Thrad describes these as for publishers who show ads in their own chat apps, not for advertisers | Coding agents |
If you run Thrad from a script or a pipeline, call the REST API directly. Claude through Ryze AI fits the chat jobs: reading campaigns, comparing supply, drafting a campaign and pausing one. The REST API is Thrad's own reference, so read its pages for any field the five connector tools do not describe.
Sources: Thrad advertiser overview, Thrad agent skills, Thrad insights reference, Ryze AI Thrad guide. Checked November 10, 2026.
Thrad errors and fixes
- 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 key that was rotated or revoked returns an invalid key error. 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. The old key stops working after Thrad's grace window. Click Reconnect on the Thrad card in Ryze AI and paste the new key.
- Thrad tools do not appear in Claude
- Claude keeps the tool list from the moment you add the connector. If you connected Thrad afterwards, remove the Ryze AI connector under Customize, Connectors, add it again and start a new chat.
- A campaign will not activate
- Thrad only activates an approved, paused campaign. A new campaign starts in review and cannot serve until Thrad approves it; trying earlier returns the error code campaign_not_approved.
- Campaign creation asks for a card
- Thrad's campaign docs say a default card on the Thrad organization is needed and that a $10 deposit is charged off-session on creation. That is a Thrad charge, set up in Thrad billing, not a Ryze AI price.
- Image upload fails
- thrads__uploadFromUrl currently gets a 404 from Thrad. Ask Claude to build ads from assets that already exist in the account.
- Claude cannot bring back an archived campaign
- Archiving a campaign is terminal and cannot be reversed. 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.
- Claude says a subscription is required
- The Thrad tools need an active Ryze AI plan or free trial. Start the trial or update the card under Organization Settings, Billing, then retry.
Frequently asked questions
How do I connect Claude 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 claude.ai open Customize, Connectors, Add custom connector, enter https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat.
Does Thrad have its own Claude connector or MCP server?
The Thrad docs checked on November 10, 2026 describe a REST API for advertisers at api.thrad.ai/v1 and agent skills for publishers, and do not mention an MCP server. Ryze AI supplies the MCP layer: its connector gives Claude five Thrad tools through one URL.
Which way should I connect Claude to Thrad?
Ryze AI is the best way to run Thrad from Claude for chat-based work such as reading campaigns, comparing Thrad and ChatGPT supply and pausing ads, though a script that calls Thrad's REST API directly suits scheduled pipelines better. The connector costs nothing; the Thrad tools need a Ryze AI plan or trial.
What do I need in Thrad to connect?
A Thrad API key that starts with ak_. Thrad says only organization owners and admins can create keys, and each organization has one active key. Ryze AI also keeps the key you paste, so replacing it in Thrad means clicking Reconnect in Ryze AI.
Which Claude plan do I need?
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans. Free users can add one custom connector. On Team and Enterprise an Owner adds the Ryze AI connector first, then each member clicks Connect. Claude Code needs a paid or Console account.
Can Claude create and pause 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, so Claude cannot make an unreviewed campaign serve. Set write and delete tools to Needs approval in Claude so it asks first.
Can Claude delete a Thrad campaign?
It can archive one with thrads__delete. Archiving a campaign cannot be undone. An archived ad group or ad is deactivated and can be activated again.
Can Claude upload images to Thrad?
Not reliably today. The upload tool exists, but Thrad currently answers it with a 404, so ads reference assets that are already in the account.
Which metrics can Claude pull from Thrad?
Impressions, clicks, spend, CTR, CPC and CPM, combined across Thrad and ChatGPT (OpenAI Ads) supply. Thrad's insights docs also let you filter or split the rows by source.
Can I connect more than one Thrad account?
Yes. Click View on the Thrad card in Ryze AI and choose Add one more account. A star marks the primary. There is no default accounts picker, so name the account in chat, or pass connection_id over MCP.
Does this work in Claude Desktop, Claude Code and ChatGPT?
Yes. A connector added in claude.ai is available in Claude Desktop. In Claude Code run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then /mcp to sign in. ChatGPT needs a Business or Enterprise/Edu workspace for full tool access; Pro is read and fetch only.
Why do the Thrad tools not show up in Claude?
Claude keeps the tool list from the moment you add the connector. If you connected Thrad in Ryze AI afterwards, remove the Ryze AI connector under Customize, Connectors, add it again and start a new chat.
How much does it cost to connect Claude to Thrad?
Adding the connector is free, but the Thrad tools need an active Ryze AI plan or free 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 campaign charges are separate.