From adding the connector to your first answer

• An assistant that supports remote MCP servers with OAuth sign-in: Claude, ChatGPT, Gemini, Cursor, VS Code, Claude Code, Gemini CLI 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. View access is enough to read numbers. Only if you want to try a budget change do you need edit access on that account.

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.

{
  "mcpServers": {
    "ads-insights": {
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

{
  "servers": {
    "ads-insights": {
      "type": "http",
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

claude mcp add --transport http ads-insights https://ads.hecigo.com/mcp

gemini mcp add --transport http --scope user ads-insights https://ads.hecigo.com/mcp

1

Sign in with Google

hecigo's page opens. Choose Sign in with Google and pick any account. The first time, hecigo creates a workspace that can read only by default, with no budget tools, and sends a welcome email. If you signed in to the portal in this browser within 30 days, the page already knows you.

2

Allow, or connect a platform first

If your workspace has an ad platform connected, hecigo allows the assistant and takes you straight back. If not, the page shows one button, Connect ad accounts: the assistant is connected, this tab returns to it, and the platform page opens in a new tab.

3

Using another workspace

Choose Use a different Google account below the button, then sign in with that workspace's account. An invite code or workspace key is only for people hecigo sent one to, and sits in the folded section.

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.

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.

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.

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.

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. These questions only fetch numbers; nothing in your accounts changes. A budget change is separate, available only in a workspace given the write scope (see the budget-adjust skill).

The connector lets your assistant read the numbers. hecigo's skills add the method: six written workflows Claude uses on its own when a question matches. They run on Claude only (chat, Cowork, Claude Code). ChatGPT, Gemini and Cursor do not use Claude skills, but the core of them, such as how to read Meta costs and compare two periods, already ships with the connector.

• meta-vn-diagnosis: Why Meta costs rose, and whether to scale, hold, fix or stop. Handles shops that sell in the Messenger inbox.
• weekly-ads-report: A weekly report for the owner, against the week before.
• roas-target-audit: Actual ROAS and CPA against the targets you set.
• search-term-cleanup: Search terms that cost money without converting, with a suggested negative keyword list.
• performance-max-audit: A Performance Max check: weak assets, audience signals, ROAS by asset group.
• budget-adjust: Safe budget changes: always plan first, show you the difference, apply only after you confirm. The confirmation is a protocol the skill follows; the server cannot check it. Only in a workspace given the write scope.

/plugin marketplace add hecigo/ads-insights-plugin
/plugin install hecigo-ads-insights@hecigo

When the skills are updated: with Sync automatically, Claude picks them up; if Claude says automatic sync needs GitHub access, go to Customize → Plugins → Add → Manage marketplaces and choose ⋮ next to ads-insights-plugin → Check for updates. On Team and Enterprise plans, if Add marketplace is missing, an Owner has to let members add their own.

• 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.

Need a person?

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

Zalo · Messenger · hi@hecigo.com