Claude Desktop

Connect Adsyncs to Claude Desktop (macOS / Windows).

For the smoothest setup, use Settings → Connectors → Add custom connector and paste:

https://mcp.adsyncs.net/mcp

If a company account blocks custom connectors, use the Adsyncs Desktop Extension before falling back to config-file setup.

Install

1. Open Claude Desktop Settings.
2. Go to Connectors.
3. Click Add custom connector.
4. Paste https://mcp.adsyncs.net/mcp.

Claude opens a browser for OAuth. Sign in, then Adsyncs tools become available in the tool picker.

Company-account fallback: Desktop Extension

If your Claude organization disables custom MCP connectors, install the Adsyncs .mcpb extension:

npm run pack --workspace @adsyncs/claude-desktop-extension

Then open Claude Desktop Settings > Extensions > Advanced settings > Install Extension and select:

packages/claude-desktop-extension/dist/adsyncs-claude-desktop.mcpb

The extension bundles the local bridge dependency and connects to the same hosted Adsyncs MCP endpoint.

Connect your ad accounts

The MCP server doesn't ship credentials. Provider OAuth happens in our dashboard:

1. Visit app.adsyncs.net and sign in.
2. Open Connections and start the OAuth flow for each provider you use (Google, Meta, LinkedIn, Bing).
3. Pick the ad accounts the AI is allowed to see.

Once connected, accounts show up in Claude the next time you call a tool such as linkedin_ads_list_accounts. No second restart needed.

Manual install

If native Connectors and Desktop Extensions are unavailable, use the fallback installer:

npx -y @adsyncs/mcp-install@latest claude

Then fully quit Claude Desktop and reopen it.

If npx is not available, paste this fallback entry into claude_desktop_config.json:

{
  "mcpServers": {
    "adsyncs-mcp": {
      "command": "npx",
      "args": ["-y", "@adsyncs/mcp-bridge@latest", "--url", "https://mcp.adsyncs.net/mcp", "--profile", "default"]
    }
  }
}

Then quit and reopen Claude Desktop.

The config file lives at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Troubleshooting

• auth_required from a tool: your workspace is missing a connection for that provider. Add it in app.adsyncs.net/connections.
• Need a different config key: pass --name <key> to the installer.
• OAuth or bridge state is stuck: call adsyncs_bridge_status, then adsyncs_bridge_connect for an explicit reconnect. The credential-free diagnostic is npx -y @adsyncs/mcp-bridge@latest --doctor.
• "Refresh token expired": re-authorize the platform in the dashboard. We don't store passwords; we can't refresh silently if the platform revoked the token.

Uninstall

For native setup, remove Adsyncs from Settings > Connectors. For extension setup, remove Adsyncs from Settings > Extensions. For config-file setup, delete the mcpServers.adsyncs-mcp entry from claude_desktop_config.json, then quit and reopen Claude Desktop.