Parker MCP Set Up

Getting Started

Step 1 — Create a Parker Account

Sign up for a Parker account at heyparker.ai. You'll need an active paid subscription to use the Parker connector.

Step 2 — Set Up Your Brand Workspace

After logging in to Parker, make sure your brand workspace is set up, your Meta ad account is connected, and that you completed onboarding to make sure Parker is trained on your account info. Parker uses this workspace as the source for all ad data, reviews, and creative research.

FYI- it usually takes 2 - 6 hours (can be up to 24 hours if very large) for your Meta account to be fully synced and analyzed with Parker

Step 3 — Get Your MCP Server URL

All you need to connect to Claude is the Parker MCP server URL:

https://api.heyparker.ai/api/mcp/full

Copy it and continue to Step 4a to connect with OAuth (recommended for Claude). You don't need to visit any settings page if you already have this URL.

Need an API token, or want to copy the URL from the app? In Parker, open the account menu and go to Settings → MCP. Under Parker MCP you can copy the same URL and choose between two connection methods:

- OAuth (recommended for Claude and other interactive clients) — browser sign-in, no token to manage. Follow Steps 4a–6.

- API token (Config file + Bearer) (best for Cursor, Windsurf, Claude Code, and scripts) — MCP-spec compliant; the token stays in your client's config headers. You can also generate or rotate your token here. Follow Step 4b.

Step 4a — Connect with OAuth (Claude)

On the OAuth tab, copy the MCP server URL (https://api.heyparker.ai/api/mcp/full). No API token or brand ID is required.

Then in Claude.ai, navigate to Settings → Connectors and choose Add custom connector:

• Name: Parker
• URL: https://api.heyparker.ai/api/mcp/full

Click Add.

Note: Parker MCP uses the Streamable HTTP transport protocol. Adding Parker as a custom connector (rather than from the Claude Directory) lets you rename it if desired. The same steps apply across Claude chat (web and desktop), Claude Cowork, and Claude Code.

Step 5 — Connect and Authorize

Go to your Claude Settings → Connectors, find Parker in your list, and click Connect. You'll be taken through an authorization flow — sign in on the Parker login page, then click Allow access on the consent screen to complete the connection.

Step 6 — Start Querying

As soon as Parker is connected, you can query against any of the brands you have access to in Parker. On your first message, Claude will pull your available brands so you can pick which one to work with, and you can switch between them anytime.

Step 4b — Connect with an API Token (Cursor, Windsurf, Claude Code, scripts)

On the API token tab, first Generate your API token (create a personal access token, or copy the existing one) — your MCP client sends it as a Bearer token on every request. Then, under Choose how to connect, pick the format your client expects.

Option A — Config file (recommended) — for Cursor, Claude Code, Windsurf, and most coding agents. Copy the ready-made MCP config JSONand paste it into your client's config file. It uses the Authorization header — the MCP-spec-compliant way to authenticate:

{
  "mcpServers": {
    "hey-parker-full": {
      "transport": "streamable-http",
      "url": "https://api.heyparker.ai/api/mcp/full",
      "headers": {
        "Authorization": "Bearer YOUR_PARKER_API_TOKEN"
      }
    }
  }
}

Replace YOUR_PARKER_API_TOKEN with your token. Transport is Streamable HTTP; auth is Bearer token. Common config file locations:

• Cursor: ~/.cursor/mcp.json
• Claude Code: ~/.claude.json
• Project scope: .mcp.json in your project root

Save and reload your client — Parker authenticates automatically via the Bearer token. If your client isn't listed, look for "MCP" or "Model Context Protocol" in its settings.

Option B — Direct URL— for pasting into Claude's custom connector when the OAuth redirect fails. Copy the Direct connect URL (your token is already embedded):

https://api.heyparker.ai/api/mcp/full?access_token=YOUR_PARKER_API_TOKEN

In Claude, go to Settings → Connectors → Add custom connector, paste the Direct URL, name it Parker, and click Add. Same flow as OAuth, but the token is already in the URL — no redirect.

Keep your token secret.Don't paste your real API token or Direct connect URL into shared docs, repos, or screenshots. If a token is exposed, use Rotate token on the MCP page — note that rotating it will break any connected clients until you update their config with the new token.

After your client connects, your first message will prompt you to select a brand, just like the OAuth flow.

Available Tools

Tools you can use through Parker MCP, with short descriptions and annotations (read-only vs write, destructive, and so on).

Troubleshooting

Parker isn't responding or the MCP connection fails

• Confirm your Parker subscription is active at heyparker.ai
• Verify the URL is https://api.heyparker.ai/api/mcp/full (copied from Settings → MCP in Parker)
• If you're using an API token, confirm the Authorization: Bearer …header is set correctly and the token hasn't been rotated
• If while using OAuth an issue occurs, try using the Direct URL instead of the general URL above.
• Try disconnecting and reconnecting the Parker connector in Claude Settings → Connectors
• If re-connecting via OAuth, complete the authorization flow and click Allow access
• If the issue persists, contact support at support@realsimplelabs.com or use your #parker slack channel

Parker responds but doesn't have my brand's data

• Make sure you selected the correct brand when prompted — ask Claude to show your available brands again if you need to switch
• Confirm your Meta ad account is connected inside Parker

  for newly onboarded brands, it usually takes 2 - 6 hours (can be up to 24 hours if very large) for your Meta account to be fully synced and analyzed with Parker

I'm getting an authentication error

• OAuth: disconnect and reconnect the Parker connector in Claude Settings → Connectors to re-trigger the OAuth flow
  • Use the Direct URL under the "API token" page instead of the general URL
• API token: make sure the token in your config matches the current token on the MCP page (rotating the token invalidates the old one)
• Make sure you're using the same Parker account that has an active subscription
• If the issue persists, contact support at support@realsimplelabs.com or use your #parker slack channel

Support

For help with Parker MCP, contact us at support@realsimplelabs.com

If you're an active Parker customer, you also have access to a dedicated Slack channel created during your onboarding — that's the fastest way to get support.

Privacy & Data

Parker's privacy policy is available at: https://heyparker.ai/support/privacy-policy

Parker transmits all data over HTTPS/TLS. Parker only accesses data explicitly requested by the user during a session.