Install the HYPD plugin for Claude Code & Cowork

The HYPD plugin bundles our MCP server into a single install. Unlike the custom connector setup, there is nothing to configure by hand.

Before you start, make sure you’ve signed up at app.hypd.ai and connected at least one ad account on the Sources page. See the Quickstart if you haven’t yet.

Install

The steps differ by surface — pick yours.

Claude Code (terminal)
Desktop app & Cowork
Zip upload

/plugin marketplace add HYPD-AI/ads-mcp-plugin
/plugin install hypd-ai-ads@hypd-ai
/reload-plugins

Then authorize: run /mcp, select hypd, choose Authenticate, and approve in the browser. The token is stored in your OS keychain and refreshes on its own.

From a normal terminal you can skip the panel: claude mcp login 'plugin:hypd-ai-ads:hypd'. This needs a real interactive terminal.

A terminal install also covers the desktop app’s Code tab — but not Cowork, which has its own path (next tab).

In the desktop app, open Settings → Customize → Plugins (in Cowork, Customize is in the left sidebar; in the Code tab you can also use the + button next to the prompt box → Plugins).

Add the HYPD marketplace

Click Add → Add marketplace → Add from a repository, enter HYPD-AI/ads-mcp-plugin, and click Sync.

Plugins screen with the Add menu open — Plugins — Add menu

Add marketplace dialog with the HYPD repository entered — Add from a repository — enter HYPD-AI/ads-mcp-plugin and Sync

Leave Sync automatically on to receive updates. If a banner about GitHub repository access appears, it only affects auto-sync — you can dismiss it and install normally.

Install the plugin

Find HYPD AI - Paid Ads & Analytics under the Personal tab and click +.

Confirmation that the plugin is installed — Installed and ready to use

Connect

Open the plugin’s page (gear icon) and connect the HYPD AI Ads connector. If your HYPD connector is already authorized on claude.ai, it’s reused automatically.

No marketplace needed: download hypd-ai-ads.zip, then in the desktop app choose Add → Upload plugin. Or load it for a single terminal session:

claude --plugin-dir ./hypd-ai-ads.zip

Uploaded copies don’t update automatically — prefer the marketplace install.

Try it

Ask Claude something that needs your account data:

List my Google Ads accounts.

Audit my account and tell me where budget is being wasted.

How are my Meta ads performing, and which creatives are fatiguing?

Compare attribution between Google Analytics and Google Ads.

HYPD is read-only. It reports on your accounts and never changes your campaigns, budgets or ads.

Plugin or custom connector?

Both reach the same HYPD MCP server. Pick whichever matches where you work.

	Plugin	Custom connector
Where	Claude Code, Cowork	Claude apps (web, desktop, mobile)
Setup	Two commands or a few clicks	Paste the MCP URL
Updates	Automatic (marketplace installs)	Automatic

Troubleshooting

The plugin doesn't appear after installing

In the terminal, run /reload-plugins or restart Claude Code, then check the /plugin Errors tab. In the desktop app, check Settings → Customize → Plugins.

Tools aren't available / HYPD says it isn't connected

Terminal: run /mcp and authenticate (or Re-authenticate if the token expired). Desktop/Cowork: open the plugin’s page and connect the HYPD AI Ads connector.

Authentication fails with 'stdin isn't a terminal'

claude mcp login needs a real interactive terminal. Use /mcp inside a session instead, or run it from a standard terminal window.

No ad accounts show up

Connect a source first: open the Sources page and connect Google Ads, Meta, Google Analytics or Merchant Center.

`/plugin` isn't recognised

In the terminal, update Claude Code (npm install -g @anthropic-ai/claude-code@latest) and restart. In the desktop app and Cowork, /plugin doesn’t exist — use Settings → Customize → Plugins.

Privacy

The plugin registers no lifecycle hooks and ships no telemetry. The only network destination is HYPD’s own API at mcp.hypd.ai, reached through the MCP connection you authorize. See our Privacy Policy and Security & Privacy page.

Getting Started

Connect via MCP

Sources

Prompts

Resources

Install

Try it

Plugin or custom connector?

Troubleshooting

Privacy

​Install

​Try it

​Plugin or custom connector?

​Troubleshooting

​Privacy

Install

Try it

Plugin or custom connector?

Troubleshooting

Privacy