Claude Desktop
Add BuddyStat as a custom connector on claude.ai, Claude Desktop, and mobile
Adding BuddyStat as a custom connector turns Claude into a conversational analytics interface: ask how a launch went, why traffic spiked on Tuesday, or where a funnel drops off — without opening the dashboard. Connectors are shared across claude.ai, Claude Desktop, and the mobile apps.
This page covers client setup only. The MCP overview covers the endpoint, the full tool list, permissions, and troubleshooting.
Add the connector
-
Open Settings → Connectors (in Claude Desktop:
Cmd/Ctrl + ,, then Connectors; on claude.ai: your profile menu → Settings → Connectors). -
Click Add custom connector.
-
Name it BuddyStat and paste the endpoint URL:
https://app.buddystat.com/api/mcpFor a self-hosted installation, use your configured
BASE_URLhost instead. -
Confirm, then click Connect. Your browser opens BuddyStat's OAuth flow — log in and approve access. The connector acts with your user's role.
There is no API key to manage: custom connectors authenticate through OAuth, and the Advanced settings fields (OAuth client ID and secret) can stay empty — BuddyStat registers the client automatically. Custom connectors are available on all Claude plans; the Free plan is limited to one.
Self-hosted installations must be publicly reachable. Claude connects to
custom connectors from Anthropic's infrastructure, not from your device — a
BuddyStat instance on a private network, behind a VPN, or on localhost will
not connect, even if you can reach it in your own browser.
Use it
Once connected, BuddyStat appears in the chat's tools menu — enable it there if it isn't already. Then try:
List my BuddyStat sites and summarize last month's traffic for the main one.
Claude asks for confirmation before tool calls by default; destructive tools (deleting goals, funnels, sites) are marked so it always confirms those.