Connect your AI

Add Roasby to your assistant with the address https://roasby.com/mcp (an MCP server). Your assistant then asks you to sign in to Roasby and approve the connection.

The approval screen shows which Roasby account you are signed in to and where it sends you back to. It also lists what the assistant will be able to do:

• read your ad accounts, campaigns, search terms and performance;
• make changes (pause, enable, budgets, bids and bidding, campaign settings, ad text, keywords, negative keywords, assets and conversion goals) only after a preview you confirm;
• create new campaigns, ad groups, ads and keywords, always paused.

You can disconnect at any time.

Copy connector URL in the Ask your AI panel (the button in the bottom corner of every workspace page, see the dashboard) copies the address for you. Once you are connected, the same panel opens a chat with your assistant in one click.

Claude (web, desktop and mobile)

1. Open Settings → Connectors and choose Add custom connector.
2. Enter the URL https://roasby.com/mcp and confirm.
3. Sign in to Roasby and approve access.

Claude Code

claude mcp add --transport http roasby https://roasby.com/mcp

Then run /mcp in Claude Code and choose Authenticate for Roasby.

ChatGPT

Open Settings → Apps & Connectors, add a connector with the URL https://roasby.com/mcp, then sign in to Roasby and approve access.

Codex

Add Roasby to ~/.codex/config.toml:

[mcp_servers.roasby]
url = "https://roasby.com/mcp"

Cursor

Add Roasby to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
    "mcpServers": {
        "roasby": { "url": "https://roasby.com/mcp" }
    }
}

VS Code

Add Roasby to .vscode/mcp.json:

{
    "servers": {
        "roasby": { "type": "http", "url": "https://roasby.com/mcp" }
    }
}

Check that it works

Ask your assistant: "Which Roasby workspace am I in?" It should call get_current_workspace and answer with your workspace name.

To see who else is in it, ask "Who is in my Roasby workspace?" (get_workspace_members).

Work in more than one workspace

One connection reaches every workspace you belong to. See Workspaces for how your assistant picks one.

Disconnect an assistant

Open AI connections (under Manage in the sidebar). It lists every assistant that can still reach your Roasby account and when each last used it. Choose Disconnect to end its access at once. To use it again, add Roasby to the assistant again and approve the connection.

Removing Roasby inside your AI app doesn't tell Roasby, so the assistant stays on this page until its access runs out. An assistant that hasn't used Roasby for 14 days shows Not used recently; if you removed it, choose Disconnect here too.

Disconnecting only affects your own account. Other people in your workspace keep their own connections. Disconnecting is done on this page only, not through an assistant.

Install the Roasby plugin

The Roasby plugin adds Roasby's connection and its skills. Its source is the public Roasby/roasby repository.

In Claude Code, add its marketplace, then install the plugin:

/plugin marketplace add Roasby/roasby
/plugin install roasby@roasby

Then run /mcp and choose Authenticate for Roasby, as above.

In Codex:

codex plugin marketplace add Roasby/roasby
codex plugin add roasby@roasby

Any assistant that reads Agent Skills can install the skills alone. They need the Roasby connection too, so add Roasby as above first:

npx skills add Roasby/roasby

The working-with-roasby skill teaches your assistant how to work with your ads safely:

• start with get_current_workspace, to know which workspace it acts in and whether you may change its ads;
• read freely, and find the IDs it needs with the read tools;
• preview every change, show it to you and wait for your yes before it makes it;
• tell you a refused preview's reason instead of trying again;
• explain the steps only a person can do, and never say it did them.

Four more skills walk your assistant through common jobs: roasby-wasted-spend-audit (find and cut wasted spend), roasby-weekly-review (a review of the week across platforms), roasby-launch-search-campaign (plan and create a campaign, paused) and roasby-budget-and-bid-check (where budget or bids would help).

The plugin is waiting to be listed in the Claude, OpenAI and Cursor directories. Until it is, install it as above, or add Roasby as a connector or MCP server: you get the same tools.

Limitations

• Your assistant can do only what Roasby's tools offer. Connecting ad platforms, billing, account settings and AI connections stay on the web.
• Your assistant is told to ask you before every change, but the preview can't prove you agreed: read your AI app's prompt before you approve a change.
• The plugin needs a Roasby account with at least one connected ad account.
• A connection reaches every workspace you belong to. You can't limit it to some of them: to keep an assistant out of a workspace, leave that workspace or disconnect the assistant.

See every limit by platform on Limitations.