hecigo Ads InsightsMCP server
← Back to the main page

Guide

From adding the connector to your first answer

About 5 minutes. You need an assistant that supports MCP, such as Claude, ChatGPT or Cursor, a Google account and view access to your ad accounts. Then ask about spend, ROAS, bidding targets, search terms and campaign settings right in your assistant.

1

Before you start

  • An assistant that supports remote MCP servers with OAuth sign-in: Claude, ChatGPT, Cursor, VS Code, Claude Code or similar.
  • A Google account to sign in to hecigo. No new password to create.
  • View access to the ad accounts you want to read. Read-only access is enough, and it is the access to use.
2

Add the connector

The connector address is the same for every assistant. Choose a quick link to copy the address and open the right settings page, or pick your assistant below for step-by-step instructions.

https://ads.hecigo.com/mcp
Or open your assistant directly

Each one copies the address first. Cursor and VS Code fill it in; Claude and ChatGPT open their connector page for you to paste it. ChatGPT needs Developer mode on.

Claude

web, Desktop, mobile apps, Cowork
  1. Open Customize and choose Connectors.
  2. Choose +, then Add custom connector.
  3. Name it Ads Insights, paste the connector address, then choose Add.
  4. Choose Connect on the new connector. hecigo's sign-in page opens.
  5. In a conversation, choose + at the lower left, then Connectors, and turn Ads Insights on.

The Free plan allows one custom connector. On Team and Enterprise, an owner adds the connector in Organization settings first, and members only choose Connect. Add it once and it works on the web, Desktop, Cowork and mobile.

Add connector
Add

Illustration. The real screen may differ slightly between versions.

ChatGPT

on the web
  1. Open Settings, go to Security and login, and turn on Developer mode.
  2. Open Plugins at chatgpt.com/plugins and choose + to create an app.
  3. Name it Ads Insights, paste the connector address as the MCP server URL, and choose OAuth for authentication.
  4. Create the app. ChatGPT opens hecigo's sign-in page.
  5. In a new conversation, choose +, then Developer mode, and select Ads Insights.

Developer mode is available on Plus, Pro, Business, Enterprise and Education, on the web. Menu names in ChatGPT change between versions; if you cannot find one, see OpenAI's help pages on Developer mode.

Add connector
Create

Illustration. The real screen may differ slightly between versions.

Cursor

code editor
  1. Choose Add to Cursor in the quick links above. Or open ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project, and add the configuration shown.
  2. Open Customize in the sidebar, find Ads Insights and switch it on.
  3. When Cursor asks you to sign in to Ads Insights, choose it to open hecigo's page in your browser.
{
  "mcpServers": {
    "ads-insights": {
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

VS Code

with an MCP-capable assistant
  1. Choose Add to VS Code in the quick links. Or run MCP: Add Server from the Command Palette, choose HTTP, paste the connector address and pick Global or Workspace. You can also add the configuration shown to .vscode/mcp.json.
  2. VS Code asks whether you trust the server before it starts: confirm to start Ads Insights. The first time, VS Code opens your browser to sign in to hecigo.
  3. In the Chat view, choose Configure Tools and turn on the Ads Insights tools.
{
  "servers": {
    "ads-insights": {
      "type": "http",
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

Claude Code

command line
  1. Run the command shown in your terminal.
  2. In Claude Code, type /mcp and follow the browser to sign in. Or run claude mcp login ads-insights.
claude mcp add --transport http ads-insights https://ads.hecigo.com/mcp

Other assistants

with MCP support
  1. Find where to add a remote MCP server (HTTP or Streamable HTTP).
  2. Paste the connector address. The assistant must support OAuth sign-in to open hecigo's sign-in page.
3

Sign in and allow

Every Ads Insights tool is read-only, so you can let the assistant use them without asking each time.

When hecigo temporarily switches to manual approval, step 2 becomes an access request: you get an email once approved, then go back to your assistant and connect again.

4

Connect ad accounts

Your assistant can only read platforms connected to your workspace, even after the connector is added. The platform page opens from the Connect ad accounts button above, from Step 1 in the portal at ads.hecigo.com/portal, or from the link your assistant gives you when nothing is connected. That link works for 15 minutes.

Google Ads

Choose Google Ads, pick the Google account that can view your ad account, then grant access on Google's own screen. Google still warns that the app is unverified: choose Advanced, then Go to hecigo Ads Insights. When done, the result page offers buttons to open Claude or ChatGPT, or to go back to the portal.

Meta Ads

Waiting for Meta to approve hecigo's ad reading access. Need it now? Message hecigo and we connect it with you. Once open, you grant access on Meta's own screen.

TikTok Ads

Waiting for TikTok to approve hecigo's app. Once open, it connects the same way as Google.

The portal shows which platforms are being read and which assistants are connected, with a button to disconnect each. Disconnecting Google Ads in the portal removes hecigo's access; review and revoke every grant at myaccount.google.com/permissions.

5

Check the connection

Ask your assistant the question below. It calls the ads_health tool, says which platforms are connected and still working, and hands you a connection link if nothing is connected.

ads_health

Check whether my connected ad platforms are still working.

6

Questions by task

Ask the way you would ask an ads specialist: name the dates, the platform and the decision you need to make. The assistant combines the tools itself, with numbers straight from the platforms. Every question here only reads; nothing in your accounts changes.

Weekly report for the ownerads_insights

Summarise the last 7 days, excluding today, against the 7 days before: total spend, conversion value, ROAS and cost per conversion by platform. Name the 3 campaigns that lifted results and the 3 that dragged them down, with the numbers behind each.

Actual ROAS against targetads_settings + ads_insights

For each running Google campaign, put its configured target ROAS or target CPA next to its actual ROAS and cost per conversion over the last 30 days. Which campaigns miss their target by more than 20%? Do not read targets from campaign names.

Audit what counts as a conversionads_settings

List the conversion actions counted in the conversions column and used for bidding, with their lookback windows and attribution model. Is anything like a page view or a first app open inflating conversions?

Cut spend on wasted search termsads_search_terms

Over the last 30 days, which search terms spent money without converting? Rank them by cost, group them by theme, propose a negative keyword list and flag terms that mention competitors.

Audit Performance Maxads_asset_groups

For each Performance Max asset group: ad strength, 30-day ROAS, which assets Google rates LOW and should be replaced, and whether its audience signals and search themes fit what we sell.

Check targetingads_settings

Which campaigns look mistargeted: locations outside the markets we sell to, location matching by interest rather than presence, missing exclusions, or a Search campaign with the Display Network switched on?

Which creative deserves more budgetads_insights + ads_creatives

Compare running ads over the last 14 days by cost per conversion and ROAS. For the best 3 and the worst 3, read their headlines, copy and destination links, and explain what sets them apart.

Rebalance budgetsads_insights + ads_entities

Based on 30-day ROAS, current daily budgets and impression share lost to budget, which campaigns should get more, the same or less budget? Suggest a figure for each and explain why.

Why spend droppedads_delivery + ads_entities

Spend yesterday was far below normal. Check account status, spend caps, rejected ads, ineligible campaigns and daily budgets, then give the main cause first.

Reconcile with Ads Managerads_insights

Give me last week's spend, impressions, clicks and conversions, Monday to Sunday, by campaign and in the ad account's time zone, so I can compare with Ads Manager.

7

Reconciling numbers

  • Pick the same dates and leave today out. Presets such as Last 7 days in Ads Manager exclude today, and today's numbers are still moving.
  • Days follow the ad account's time zone, not your computer's.
  • Meta's Clicks column includes image taps and taps on see more. To compare site visits, ask for link clicks.
  • Each platform counts conversions over its own attribution window, so do not add one platform's conversions to another's and compare the sum to a single figure.
  • ROAS and conversion value are the platform's own numbers. Google counts its primary conversion actions; Meta values only the action being counted. To see which actions count, ask for a conversion audit.
8

Common problems

Google says the app is not verified

hecigo is waiting for Google to verify its Google Ads access. Until then Google shows this warning: choose Advanced, then Go to hecigo Ads Insights to continue. hecigo still only reads your numbers.

Connecting Google Ads asks for 2-Step Verification

Since 21 April 2026 Google requires 2-Step Verification from anyone granting Google Ads access, and some accounts must also sign in with a passkey. Turn it on at myaccount.google.com/security, then choose Connect again. Connections made before are not affected.

The assistant says it cannot connect

Remove the connector and add it again. On hecigo's page, check that the workspace name shown is right; if not, choose Use a different Google account.

The assistant says nothing is connected

The assistant is reading a workspace with no platform connected. Open the portal to check the workspace name and Connected assistants, then choose Connect; or use the link your assistant gave you within 15 minutes.

The connection link has expired

Links from the assistant work for 15 minutes. Ask your assistant again for a new one, or open the portal and choose Connect.

The assistant does not see a new tool or option

Assistants keep the tool list from when a conversation started. Start a new conversation; if it is still missing, turn the connector off and on in the assistant's settings.

The assistant says a platform reports an error

Ask it to check connections to see the exact error, then reconnect that platform in the portal.

Numbers differ from Ads Manager

See the reconciling section above. It is usually different dates, today included, or Clicks compared with link clicks.

The assistant does not use Ads Insights

Turn the connector on in the conversation, or say “use Ads Insights” in your question.

There is no place to add a connector

Check that your assistant's plan supports remote MCP servers, then see that assistant's official help pages.

Need a person?

Stuck at any step? Message hecigo with a screenshot of that step.

Zalo · hi@hecigo.com