ADS Beast for AI assistants
Connect Devin Desktop (Windsurf) to ADS Beast
Windsurf is now called Devin Desktop. Its local agent reads MCP servers from one JSON file and can send the key as a header.
First, create an API key
- 1Sign in to ADS Beast and open API keys in the menu. Creating a key needs the administrator role.
- 2Create a key with only the scopes the assistant needs.
read:*is enough to look at data. Addwrite:proposalsto let it propose changes and build campaign drafts, andwrite:leadsto let it update leads. - 3Copy the key that starts with
absk_. It is shown once. You revoke it on the same screen, and a revoked key stops working at once.
Add the server with a key
- 1Open Customize from the Agents window, choose MCPs and open the config file under This computer. It is
~/.config/devin/mcp_config.json; older Windsurf builds used~/.codeium/windsurf/mcp_config.json. On Windows the file is%APPDATA%\devin\mcp_config.json. - 2Paste the snippet. It takes the key from the
ADSBEAST_API_KEYenvironment variable, which has to be set before the app starts. You can also write the key itself in place of${env:ADSBEAST_API_KEY}. - 3Refresh the list under This computer. On team plans an administrator may need to allow the server first.
File:
~/.config/devin/mcp_config.json{
"mcpServers": {
"adsbeast": {
"url": "https://adsbeast.pro/api/mcp/workspace",
"headers": {
"Authorization": "Bearer ${env:ADSBEAST_API_KEY}"
}
}
}
}First prompts to try
- Call whoami in ADS Beast and tell me which organization and scopes this connection has.
- Show the campaign dashboard summary and the unread alerts.
- Check this Google Ads headline against the platform limits: "Plumber in Bratislava, same day".
If it does not work
- A 401 answer means the key is missing, mistyped or revoked. The handshake and the tool list answer without a key, so a client can show the tools and still fail on the first call.
- A 403 in the answer means the key lacks the scope that tool needs. The
whoamitool lists the scopes the key carries. - No tools after you edit a config file: restart the client or reload its MCP servers.
We could not run Devin Desktop (Windsurf) ourselves. The steps follow its documentation as read on November 18, 2026, and menus can change between versions. The server side was checked against production. Vendor documentation