Run your ads from Windsurf
Windsurf reads the Valkiria server from its MCP config file and authenticates with a developer API key in a header.
01
Connect Windsurf in 3 steps
- In Valkiria create a developer API key with the scopes you need.
- Add the server to ~/.codeium/windsurf/mcp_config.json as shown below, replacing vk_live_… with your key. Note the field is serverUrl, not url.
- Restart Windsurf and tell the assistant: "Get started with Valkiria".
- This recipe needs a developer API key. Developer API keys are part of the plans that include API access; the pricing page shows which.
{
"mcpServers": {
"valkiria": {
"serverUrl": "https://valkiria.pro/mcp",
"headers": { "Authorization": "Bearer vk_live_…" }
}
}
}02
Ad platforms you can ask Windsurf about
Each platform works at its own depth. Open one to see what the assistant reads, what it can propose and the prompts to start with.
03
Platforms without an assistant guide
04
How changes stay safe
- This client authenticates with a developer API key in a header. The key can only do what its scopes allow; create a read-only key if the editor should never propose changes.
- 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
Windsurf
- A developer API key is required, and developer API keys are not included in every plan.
- 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
Connect Windsurf and ask the first question
Create a free account, connect an ad account and add the connector. The first pass only reads.