Install on Claude Code

Step 1: Install via Plugin Marketplace (Recommended)

Hopkin is available in Claude's plugin marketplace. This is the fastest way to get started:

1. Open Claude Code

2. Go to Customize -> Personal plugins

3. Click + -> Create plugin -> Add marketplace

4. Enter the marketplace URL: https://github.com/pearmill/hopkin-plugins

5. Install the Hopkin plugins and add the connectors you need (Meta Ads, Google Ads, LinkedIn Ads, Reddit Ads, TikTok Ads)

6. Connect your ad accounts when prompted

The plugin bundles MCP server configurations and workflow skills together — no need to add servers manually.

Alternative: Manual MCP setup

If you prefer to add MCP servers individually via the CLI:

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

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

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

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

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

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

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. The plugin handles MCP server registration automatically alongside 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.