MCP server

Use it to identify problems and opportunities, prioritize next steps, prepare supported changes for review, and track their resolution from your conversation. The server includes tools for:

Website scans: check site health, search presence, AI visibility, advertising presence, and storefront tracking.
Research: explore keywords, competitors, public ads, and how AI assistants recommend your brand.
Connected data: read supported information from Shopify, Google Analytics, Search Console, Tag Manager, Meta Ads, Google Ads, Klaviyo, and Gorgias.
Drafts and fixes: prepare fix instructions, supported Shopify theme previews, and evidence-backed content drafts.
Follow-ups: save findings, review progress, and check verification evidence.

Available workflows depend on your brand’s setup and connected accounts.

Setup

Connect your AI assistant

In an AI application that supports remote MCP servers:

Open its MCP or connector settings.
Add a server named Superworker with this URL:
https://mcp.superworker.ai/mcp
Follow the authentication flow to connect your Superworker account.

Return to your assistant and check the connection:

Check my Superworker connection.
Show which workspace and brands I can access.

If you have not added a brand, your assistant can guide you through setup using your website address.

Run your first scan

Scan [yourstore.com] with Superworker.

When it finishes, explain the three most important findings,
show the evidence, and recommend what to do first.

Replace [yourstore.com] with your website address. You can also specify a focus, such as tracking, SEO, site health, or AI visibility. Your assistant can guide you through connecting additional accounts when a question requires private data.

Claude

Connect Superworker in Claude using a custom connector. For client requirements and connector settings, see Claude’s official connector documentation.

1. Add the custom connector

Open Customize, select Connectors, then choose Add custom connector. Enter these settings:

Name: Superworker
Remote MCP server URL: paste the server URL below.

https://mcp.superworker.ai/mcp

Claude Add custom connector dialog showing the Superworker name, MCP server URL, and Continue button

Enter Superworker and the MCP server URL, then select Continue.

Select Continue to proceed.

2. Authenticate your account

A Superworker page will open in your browser. This is where you connect your Superworker account to your AI application.

New to Superworker? Select Create account and follow the instructions to register.
Already have an account? Sign in with the email address and password you use for Superworker. Use the account where your brands and scans are saved.

After signing in, review the access requested by your AI application and approve the connection. Then return to your AI application to continue. You don’t need to have a store connected yet—you can add your website after signing in.

Codex

Connect Superworker in the Codex app, then authenticate with your Superworker account. For MCP configuration and authentication options, see OpenAI’s official MCP documentation.

1. Add the MCP server

Open Plugins and select the MCPs tab. Open the Add menu, then choose Add MCP server.

Codex Plugins page with MCPs selected and Add MCP server in the Add menu

Open Plugins → MCPs → Add → Add MCP server.

In Connect to a custom MCP, enter these settings:

Name: superworker
Type: select Streamable HTTP.
URL: paste the server URL below.

https://mcp.superworker.ai/mcp

Codex custom MCP form showing the Superworker name, Streamable HTTP selected, and the Superworker MCP URL

Check that Streamable HTTP is selected and the server URL is correct.

Select Save to add the server.

2. Authenticate your account

A Superworker page will open in your browser. This is where you connect your Superworker account to your AI application.

New to Superworker? Select Create account and follow the instructions to register.
Already have an account? Sign in with the email address and password you use for Superworker. Use the account where your brands and scans are saved.

Connected business data

Connecting Claude or Codex gives your assistant access to Superworker. Connecting a business account gives Superworker access to the supported private data needed for a question. These are separate connections. You can start with your website address and public scans. When a task needs private data:

Ask your assistant which workspace and brand are active.
Ask it which supported connections that brand already has.
Tell it which business question you want to answer, then follow its connection flow for any missing account.
Return to the conversation and ask it to verify the connection before continuing.

Check the connected accounts for [yourstore.com].
I want to understand search traffic and storefront tracking.
Show which relevant sources are connected and guide me
through any missing connections.

Supported sources described in this guide include Shopify, Google Analytics, Search Console, Tag Manager, Meta Ads, Google Ads, Klaviyo, and Gorgias. Availability depends on your brand, role, and account configuration. Before requesting a fresh scan or a change, confirm the intended brand and task.

Workflow examples

Each example starts with a goal and a prompt you can adapt. Ask your assistant to explain which saved evidence it can use and whether the task needs a fresh scan or an additional connection.

Workflow	Goal	Example prompt
Website scans	Find the most important issue to investigate first.	“Scan [yourstore.com] for site health and tracking. Show the three most important findings, their evidence, and what I should check first.”
Research	Identify a relevant keyword or competitor question to explore.	“Research search opportunities for [yourstore.com]. Use my brand context, show the sources, and suggest three questions worth investigating.”
Connected data	Answer a specific business question using supported connected sources.	“Use the connected sources for [yourstore.com] to review search traffic and storefront tracking. Explain what the data supports and what is still missing.”
Drafts and fixes	Prepare work that a person can review before it is applied.	“Prepare a fix plan for this finding, including the evidence, proposed changes, and how we will verify the result. Do not apply the change.”
Follow-ups	Review whether saved work has been resolved and verified.	“Show the saved follow-ups for [yourstore.com], their verification status, and what still needs to be checked.”

A prepared plan, an applied change, and a verified result are separate stages. Review any requested approval before work that writes or spends proceeds.

Example prompts

Understand a finding

Explain this tracking warning. What did the scan observe,
and what do we need to check in the connected accounts?

Prepare work for review

Prepare a fix plan for this finding, including the proposed
changes and how we will verify the result.

Review progress

Show the saved follow-ups for [yourstore.com],
including their current verification status.

FAQ

Do I need to install or host a local server?

No. Superworker hosts the MCP server. Add https://mcp.superworker.ai/mcp in your AI assistant’s connector settings, then sign in with your Superworker account. Follow the Claude or Codex setup guide above.

Do I need to connect all my business accounts before I start?

No. You can start by adding your brand with its website address and running public website checks. Connect additional accounts when your question needs private data, such as analytics, advertising performance, or store information. Your assistant can check which supported connections are available for your brand and guide you through authorization.

Can I work with more than one workspace or brand?

Yes, if your Superworker account has access to them. Ask your assistant to list your available workspaces and brands, then tell it which workspace and brand you want to use. Workspace selection is specific to each AI client, so switching in Claude does not switch the workspace in Codex or the Superworker web app. Available actions depend on your role and the brand’s connected accounts.

Will a proposed fix change my live website?

Preparing a fix does not publish it. Superworker can provide fix instructions and, for supported Shopify findings, prepare a theme preview. Review the proposed change through its browser review link and approve it before it can be applied. A prepared preview, an applied change, and a verified result are separate stages; ask your assistant for the current status and verification evidence.

What should I check if the connection works but data is missing?

Ask your assistant to check your Superworker connection and show the active workspace, available brands, and connection status for the brand you want to use. If you have no brand yet, ask it to guide you through adding your website. If a required account is disconnected or its authorization has expired, complete the connection flow and ask your assistant to verify it. For connection errors, confirm the server URL, check that the MCP server is enabled in your AI app, and complete sign-in.

Get started

Agents and automation

Contribute

Setup

Connect your AI assistant

Run your first scan

Claude

1. Add the custom connector

2. Authenticate your account

Codex

1. Add the MCP server

2. Authenticate your account

Connected business data

Workflow examples

Example prompts

Understand a finding

Prepare work for review

Review progress

FAQ

​Setup

​Connect your AI assistant

​Run your first scan

​Claude

1. Add the custom connector

2. Authenticate your account

​Codex

1. Add the MCP server

2. Authenticate your account

​Connected business data

​Workflow examples

​Example prompts

​Understand a finding

​Prepare work for review

​Review progress

​FAQ

Setup

Connect your AI assistant

Run your first scan

Claude

Codex

Connected business data

Workflow examples

Example prompts

Understand a finding

Prepare work for review

Review progress

FAQ