Install on Claude Desktop

The fastest way to get started with Hopkin on Claude Desktop:

1. Open Claude Desktop

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

Option 2: Add via Settings

Go to Settings > Connectors > Add Connector and enter the server URL for each platform you use:

  • https://meta.mcp.hopkin.ai
  • https://google.mcp.hopkin.ai
  • https://linkedin.mcp.hopkin.ai
  • https://reddit.mcp.hopkin.ai
  • https://tiktok.mcp.hopkin.ai

Option 3: Edit the config file

Manually edit your claude_desktop_config.json:

{
  "mcpServers": {
    "hopkin-meta-ads": {
      "url": "https://meta.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "hopkin-google-ads": {
      "url": "https://google.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "hopkin-linkedin-ads": {
      "url": "https://linkedin.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "hopkin-reddit-ads": {
      "url": "https://reddit.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "hopkin-tiktok-ads": {
      "url": "https://tiktok.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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

Next steps

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