Connect Claude Code to Adflitz

Claude Code runs in your terminal. One command adds Adflitz. Use an API key for scripts and servers, or skip the header and sign in with OAuth.

Before you start

  • Sign-in method: OAuth sign-in or API key. The server address is https://adflitz.com/api/mcp.
  • For OAuth you need to be an owner or admin of the Adflitz workspace. Members can use an API key someone with that role created for them.
  • For an API key create one under Settings, then API keys, and allow agents on the project under Settings, then Agents. The key is shown once, so put it straight into an environment variable.
  • Pick the lowest permission that does the job. Access levels explains read, draft and publish.

Steps

  1. Create an API key under Settings, then API keys in Adflitz, and allow agents on the project under Settings, then Agents. Skip this if you prefer OAuth.
  2. Run the command below in your terminal. Leave out the header line to sign in with OAuth instead.
  3. Inside Claude Code run /mcp to see the connection. With OAuth it also starts the sign-in.
  4. Paste the check prompt into Claude Code.

Copy and paste

One command in your terminal. Leave out the header to sign in with OAuth instead (run /mcp in Claude Code).

claude mcp add --transport http adflitz https://adflitz.com/api/mcp \
  --header "Authorization: Bearer apk_YOUR_KEY"

Check that it worked

Open a new conversation in Claude Code and paste this prompt. It only reads, so it is safe to run on a live account.

Check prompt

Use Adflitz to give me the workspace overview. List my projects, which ad platforms are connected and how many drafts are waiting for approval. Do not change anything.

A good answer names your workspace and plan, lists your projects with the permission each one grants, shows the connected platforms and tells you how many drafts are waiting. If the assistant says it cannot find an Adflitz tool, jump to troubleshooting below.

Troubleshooting

  • Run /mcp inside Claude Code to see the connection status or to start the sign-in.
  • 401 or “unknown or revoked”: send the whole key, starting with apk_, as a Bearer token with nothing around it. A revoked key never works again, so create a new one under Settings → API keys.
  • The tools list is empty or calls say forbidden: open Settings → Agents and allow agents on the project, and give the key at least the permission the tool needs (read, draft or publish).
  • The overview works but lists no ad accounts: connect them first, see Connect ad accounts.

What to ask next

  • How did my ads do over the last 14 days? Group it by campaign and point out what needs attention.
  • Draft a Search campaign for our two best services and file it as a draft for my approval.
  • Which campaigns spent without results this week? Suggest what to pause and give me the reason for each.
  • Save the three most useful competitor ads for this project to my swipe file.

Changes you ask for become drafts that you review first. Read Drafts and approvals to see how a draft is checked and approved.

Other clients

ChatGPTClaude.aiCursorCodexGemini CLIPerplexityGrok BotHermes AgentOpenClawn8nAny other MCP client

Questions about connecting your AI or your ad accounts? Write to contact@adflitz.com or open the support page.