Install on Claude Code

Hopkin is built for Claude. The recommended setup pairs MCP servers (for API access) with the Hopkin plugin (for optimized workflows).

Step 1: Add the MCP servers

Open Claude Code and run these commands to connect the ad platforms you use:

claude mcp add --transport http -H "Authorization:Bearer YOUR_API_KEY" hopkin-meta-ads https://mcp.hopkin.ai/meta-ads/mcp

claude mcp add --transport http -H "Authorization:Bearer YOUR_API_KEY" hopkin-google-ads https://mcp.hopkin.ai/google-ads/mcp

claude mcp add --transport http -H "Authorization:Bearer YOUR_API_KEY" hopkin-linkedin-ads https://mcp.hopkin.ai/linkedin-ads/mcp

claude mcp add --transport http -H "Authorization:Bearer YOUR_API_KEY" hopkin-reddit-ads https://mcp.hopkin.ai/reddit-ads/mcp

claude mcp add --transport http -H "Authorization:Bearer YOUR_API_KEY" hopkin-tiktok-ads https://mcp.hopkin.ai/tiktok-ads/mcp

Replace YOUR_API_KEY with your key from app.hopkin.ai/api-keys. You only need to add the platforms you use.

Step 2: Install the Hopkin plugin

The Hopkin plugin adds pre-built skills (slash commands) optimized for ad management workflows:

/plugin marketplace add pearmill/hopkin-plugins
/plugin install hopkin@hopkin-plugins

This gives you commands like /hopkin-report, /hopkin-audit, and more directly in Claude Code.

Note: The plugin requires access to the pearmill/hopkin-plugins repository. Contact your team admin if you don't have access.

Team setup (zero-config for teammates)

Add this to your project's .claude/settings.json so teammates get Hopkin automatically:

{
  "extraKnownMarketplaces": {
    "hopkin-plugins": {
      "source": { "source": "github", "repo": "pearmill/hopkin-plugins" }
    }
  }
}

When a teammate opens Claude Code in the repo, they'll be prompted to install the plugin.

What the plugin includes

The Hopkin plugin bundles skills and MCP server configurations together. Once installed, your teammates don't need to run individual claude mcp add commands — the plugin handles server registration automatically alongside the workflow skills.

Next steps

Once installed, verify your connection by asking Claude: "Check my Hopkin auth status for Meta Ads". See Your First Query for a full walkthrough.