Help
MCP Guide

MCP Guide

1. Install the Claude CLI (If Not Already Setup)

Claude Code uses the CLI for MCP server configuration.

For macOS & Linux

  1. Run this in Terminal:

curl -fsSL https://claude.ai/install.sh | bash

  1. Verify:

claude --version


2. Log in to Claude CLI

Authenticate the CLI with your Anthropic account:

claude auth login

A browser window will open. Log in with your Anthropic account and return to the terminal once authentication completes.


3. Add the onBeacon MCP Server

Register the MCP server with Claude using HTTP + SSE transport:

claude mcp add --transport http onbeacon https://mcp-server.designpro.ai/mcp/sse 

You should see a confirmation that the server was added.


4. Authenticate the MCP Server (Google OAuth2)

The onBeacon MCP server requires Google OAuth for authorization.

Start the Claude CLI:

claude

In the Claude chat input, type:

/mcp

Press Enter.

  1. Select the onBeacon MCP server using the arrow keys and press Enter

  2. Select Authenticate and press Enter

  3. Your browser will open the Google login page

  4. Log in with your Google account and approve the requested permissions


5. Test the MCP Server

Once authenticated, in the Claude CLI chat, type:

/mcp

You should see the onBeacon MCP server listed as Connected.

  • Press Enter

  • Select View tools to see the list of tools available

  • Select any tool to view instructions on how to use it


6. Available Tools

We currently provide three tools:

  1. Growth Analysis — Finds conversion issues using proven patterns.

  2. UX Critique — Detects usability issues and helps fix user problems you're seeing.

  3. Audit UI — Catches UI issues (layout, hierarchy, etc) using heuristics.

All three tools take a URL parameter pointing to a publicly available website.
The UX Critique tool also accepts a user problem parameter describing what you want to diagnose.

Tools are invoked using natural-language prompts in the Claude CLI chat; no special command syntax is required.


6. Example tool usage

Growth Analysis

Can you call the Growth Analysis tool for this URL: https://yoursite.com

UX Critique

Use the onBeacon UX critique tool to analyze https://yoursite.com

Focus on this user problem: New users aren't clicking the signup button and they don't know where to start.

Audit UI

Please call the Audit UI tool of the onBeacon MCP server for this website: https://yoursite.com

Notes

  • Apply feedback to your codebase — after getting results, ask Claude to implement the suggestions directly