1. Home
  2. AI assistants
  3. Setup guide
Setup guide

How to connect Claude, ChatGPT or Claude Code to Signal Beam

Connect an AI assistant to Signal Beam's MCP server, use the ready-made prompts, approve what it suggests, and disconnect it when you're done.

Signal Beam's MCP server lets an AI assistant read your tracking reports, check your setup and suggest changes. The address is https://app.signalbeam.co/mcp. You need a Signal Beam account, on any plan or the free trial.

You stay in control

An assistant can only suggest changes. Nothing happens until an owner or admin approves it in the dashboard. It can't delete anything, reach your ad accounts, or edit or publish your website, and it never asks for passwords or keys.

Connect Claude

On claude.ai or in the Claude desktop app:

  1. Open Customize, then Connectors, and choose Add custom connector.
  2. Name it Signal Beam and paste https://app.signalbeam.co/mcp as the server address.
  3. Choose Connect. Signal Beam opens in your browser: log in if asked.
  4. Check the app's name and your account, choose whether it can suggest changes or only read, and choose Allow.

On a Team or Enterprise plan, an owner adds the connector under Organization settings, then Connectors. By default, Claude asks before it runs each tool.

Connect ChatGPT

  1. In ChatGPT's settings, add a custom MCP server. Where this is depends on your plan.
  2. Paste https://app.signalbeam.co/mcp as the address and choose OAuth as the sign-in.
  3. Log in to Signal Beam when asked, and choose Allow.

ChatGPT doesn't show Signal Beam's ready-made prompts, so ask in your own words, such as "Audit my tracking with Signal Beam".

Connect Claude Code

Run this in a terminal:

claude mcp add --transport http signal-beam https://app.signalbeam.co/mcp

Then type /mcp in Claude Code, choose signal-beam, and sign in. If you'd rather not sign in from Claude Code, create a token on the dashboard's AI access page and add it as a header instead:

claude mcp add --transport http --header "Authorization: Bearer YOUR_TOKEN" signal-beam https://app.signalbeam.co/mcp

Other apps

Most apps that can add a remote MCP server work the same way: give them the address and sign in when asked. If an app can't sign in, create a token on the AI access page and send it as the header Authorization: Bearer YOUR_TOKEN. The AI access page shows the steps for each app we've tried.

Use the ready-made prompts

In Claude, the prompts are under the + button, then Connectors, then Add from Signal Beam. In Claude Code, type /. You can leave the site empty: the assistant finds it, or asks which one.

  • Set up tracking adds a site, takes you through installing the script, checks it's live, and gives you the links to connect your ad platforms.
  • Audit tracking checks a site's setup and recent events, and lists the problems with the most important first.
  • Weekly report compares the last 7 whole days with the 7 before: conversions, revenue, and what was and wasn't sent.

What the assistant can read

Only the sites you can reach in the dashboard, with your role on each.

ToolWhat it gives
list_sites, get_site_statusYour sites, and each one's connected ad platforms, consent setting and last 7 days
audit_trackingProblems with a site's setup, the most important first
get_overviewTotals by day or week, compared with another period, and how many sent events carried an email or phone
get_attribution_report, list_conversions, get_customer_journeyConversions and revenue by source and campaign, and the visits before a conversion
list_recent_events, get_event_detailThe event log, and one event's outcome at each ad platform
get_blocked_eventsEvents held back on purpose, by reason, event and day
list_custom_events, get_custom_event_firesCustom events and how often each fired
list_blocking_rules, check_duplicate_pixels, list_integrationsBlocking rules, ad pixels installed twice, and connected tools such as Stripe
get_install_snippet, get_install_steps, check_script_installedThe script and install steps for your builder, and whether your live page has it
get_connect_link, build_utm_linkDashboard links where you connect an ad platform, Stripe or Calendly yourself, and tagged links for ads
list_change_proposalsChanges it suggested, and whether they were approved

What it can suggest

Only if you allowed suggestions when you connected, and only on sites where you're an owner or admin.

ToolWhat approving does
propose_siteAdds a site to your account. It counts towards your plan's site limit
propose_site_updateChanges a site's name in the dashboard or its currency
propose_custom_event, propose_page_triggerTracks a new event on a click, form or page view
propose_blocking_rule, propose_blocking_rule_changeAdds a blocking rule, or turns one on or off
propose_test_event_codeSends a pixel's events to the platform's test tool for 1 to 24 hours
propose_pixel_nameNames a pixel in Signal Beam
propose_integration_settingsChanges a Stripe connection's settings, such as counting renewals

Approve or reject a change

  1. Open the link the assistant gives you. It goes to the AI access page in your dashboard, with that change outlined. Log in first if you need to.
  2. Read the exact change and the assistant's reason.
  3. Choose Approve or Reject. The dialog says what approving does before anything happens.

Viewers can see changes but not approve them. A new site is approved by the person who asked for it.

Stay connected, or disconnect

An app you sign in from stays connected while you use it, and asks you to sign in again after 30 days without use. A token lasts 30 days, 90 days or a year, as you choose when you create it. To disconnect either, open AI access and choose Disconnect. It stops working at once, and other apps stay connected.

If you lose your role on a site, the assistant loses it at the same moment.

Limits

  • Each connection can make up to 120 requests a minute. If it goes over, it's asked to wait a minute.
  • Up to 20 suggested changes can wait for approval per site.
  • The overview covers up to 92 days by day, or 366 days by week.

If something doesn't work

  • The sign-in page says the app isn't registered. Remove the connector and add it again.
  • The assistant says a site wasn't found. Ask it to use list_sites. A token can be limited to some sites.
  • It says it can only read. The connection is read-only. Disconnect it and connect again, allowing suggestions.

Still stuck? Email admin@signalbeam.co.