Skip to main content

4. Connect in Claude (web & desktop)

How to connect your HilltopAds account and Claude (web & desktop)?

Written by HilltopAds

In Claude you can add the HilltopAds connector straight from the connector directory – there is no URL to paste. (A manual route is described below if you prefer it.)


Add it from the directory

  1. Open Settings → Connectors. Click Add → Browse connectors.

Step 1 – Connectors → Add → Browse connectors.

2. Search for Hilltop and pick HilltopAds from the directory.

Step 2 – search for HilltopAds in the directory.

3. On the connector page, click Connect to Claude.

Step 3 – Connect to Claude.

4. On the HilltopAds MCP Authorization page, paste your API key and click Authorize. No email or password is needed.

Step 4 – authorize with your API key.

5. HilltopAds is connected. Under Tool permissions you decide when Claude may use each group: read-only tools and write/delete tools. The write/delete group defaults to Needs approval, so every change waits for your OK. You can change this anytime, or Disconnect.

Step 5 – connected. Tool permissions split into read-only and write/delete (Needs approval).


Alternative: add it as a custom connector

If you prefer, add the server manually instead of using the directory.

  1. In the message box, click + → Connectors → Add connector → Add custom connector.

Step 1 – + → Connectors → Add custom connector.

2. Give it a name (for example Hilltop Ads MCP) and paste the URL https://mcp.hilltopads.com/mcp

Leave the Advanced settings (OAuth Client ID / Secret) empty, then click Add.

Step 2 – Name the connector and paste the server URL.

3. Authorize with your API key on the HilltopAds page, the same as above.


Using it – create and manage a campaign

Ask in plain language. For read requests Claude may ask permission the first time a tool runs; for anything that changes your account it always asks. Here is a full campaign-creation flow – in which Claude, by its own choice, creates the campaign inactive so you can review it first; ask explicitly if that is what you want.

  • Say what you want, e.g. “I want to create a campaign.” Claude walks you through quick pickers – ad format, pricing model and traffic channels.

Step 1 – Claude asks the ad format…

…the pricing model…

…and the traffic channels.

  • It then asks for the free-text details it still needs – campaign name, landing URL and bid – and notes it will create the campaign inactive so you can review it first.

Step 2 – the remaining free-text details; it will create the campaign inactive.

  • When it needs to check something (existing campaign names, channel categories), Claude asks permission to call a tool – choose Allow once or Always allow.

Step 3 – Claude asks permission before calling a tool.

  • Claude shows a final summary table of everything it will create and asks for the last missing field.

Step 4 – a summary table of exactly what will be created.

  • On your go-ahead it creates the campaign and returns its ID – still inactive – with notes on what to check before you start it.

Step 5 – created, with the new campaign ID; still inactive.

  • The campaign appears in your HilltopAds account.

Step 6 – the campaign is in your HilltopAds account.

Did this answer your question?