Run ChatGPT Ads from Claude Code
ChatGPT Ads is OpenAI's advertising platform. Valkiria connects an ad account with its own API key from ads.openai.com and gives the assistant campaigns, ad groups, ads and daily insights. Claude Code adds Valkiria with one command. Because it works in your terminal and repository, it can save what it reads to files, compare it with last week and keep reports next to your code.
01
Connect Claude Code in 3 steps
- Run the command below in your terminal.
- Sign in to Valkiria in the browser window that opens and approve the request.
- Start a new session and type: "Get started with Valkiria".
- The command registers a remote HTTP server; nothing is installed locally and no API key is stored in your repository.
claude mcp add --transport http valkiria https://valkiria.pro/mcp02
What works for ChatGPT Ads today
Connection: An API key from ads.openai.com → Settings, one key per ad account. There is no OAuth and no app review.
The assistant can read
- Campaigns, ad groups and ads with their status.
- Daily impressions, clicks, spend and conversions from Insights, with money already converted from micros.
- ChatGPT Ads next to your other platforms in the same metrics.
The assistant can propose or request
- Create a campaign draft inside Valkiria. What later reaches the ad account is created paused.
- Request a pause or a resume of a campaign.
- Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.
03
Prompts to try: ChatGPT Ads in Claude Code
Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.
List my ChatGPT Ads campaigns with status, spend and conversions for the last 14 days.
Which ChatGPT Ads ad groups have impressions but no clicks this week?
What did ChatGPT Ads cost per conversion each day this month?
Compare ChatGPT Ads with Google Search for the last 30 days: spend, clicks and conversions.
Save daily ChatGPT Ads insights for this month to data/chatgpt-ads.csv.
Write notes/chatgpt-ads.md: which campaigns we tested, what they spent and what they returned.
04
How changes stay safe
- Sign-in uses OAuth 2.1 with PKCE on valkiria.pro, so the assistant never sees your password.
- Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
- A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
- New campaigns are created paused. Starting new spend and deleting always wait for a person.
- The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
- The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
- You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.
05
Limits
ChatGPT Ads
- Launching and archiving both need an explicit spend confirmation in Valkiria; the assistant cannot give it.
- Archiving is irreversible on the provider side, and the bidding type cannot be changed after a campaign is created.
- ChatGPT Ads accounts are available to self-serve advertisers only in the markets OpenAI has opened.
Claude Code
- Files the assistant writes are its own work in your repository: Valkiria returns data, it does not create files for you.
- The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
- Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
- Money stays in each account's own currency. Different currencies are not converted or added up.
- Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.
06
FAQ
Ask Claude Code about your ChatGPT Ads account
Create a free account, connect an ad account and add the connector. The first pass only reads.