A Project in Adsroid represents a workspace: a client, a brand, or an ad account (or group of accounts) that you manage. Every action Claude performs through the MCP — analyze, create, manage, or test — always runs inside a specific Project.
If you manage a single account, you’ll likely have just one Project. If you’re an agency managing multiple clients, each client typically has its own Project.
What a Project contains
A Project groups together:
- One or more connected ad accounts (Google Ads, Meta Ads, etc)
- The campaigns, budgets, and performance data tied to those accounts
- The history of actions Claude has taken on that Project
How Claude picks the right Project
With a single API key, you can have access to multiple Projects. Claude needs to know which one to work in before executing any action. There are two scenarios:
1. You don’t specify a Project
Claude starts by listing the Projects available in your workspace and asks you to specify which one to use — or, if only one Project exists, it uses that one automatically.
2. You name the Project in your prompt
If you mention the client or account name directly, Claude matches it to the corresponding Project without needing to ask.
Example:
“Analyze the Google Ads campaign performance for the Client A project over the last 30 days.”
Claude identifies “Client A,” retrieves the matching Project, and executes the action only within that context.
Best practices
- Start a multi-client session by listing your Projects. Simply ask: “List the projects available in my Adsroid workspace.” This removes any ambiguity about which account is targeted.
- Name the Project explicitly in your prompts if you manage multiple accounts, especially for write actions (creating a campaign, editing a budget). This reduces the risk of acting on the wrong account.
- One project = one isolated context. Data and actions from one Project never mix with another, even within the same conversation.
Common error
If Claude returns an error saying an adsroid_project_id doesn’t match any project, it usually means the Project mentioned doesn’t exist in your workspace, or was misspelled. Ask Claude to list your projects to get the exact names.
