> ## Documentation Index > Fetch the complete documentation index at: https://docs.superworker.ai/llms.txt > Use this file to discover all available pages before exploring further. # MCP server > The Superworker Model Context Protocol (MCP) server connects your AI assistant to your brand context, website scans, research, and connected business data. 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: 1. Open its MCP or connector settings. 2. Add a server named **Superworker** with this URL: ```text theme={null} https://mcp.superworker.ai/mcp ``` 3. Follow the authentication flow to connect your Superworker account. 4. Return to your assistant and check the connection: ```text theme={null} 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 ```text theme={null} 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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). ##### 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. ```text theme={null} https://mcp.superworker.ai/mcp ``` ![Claude Add custom connector dialog showing the Superworker name, MCP server URL, and Continue button](https://mintcdn.com/superworkerai/fCGo07SFu1Ff6Pf9/apps/docs/images/mcp/claude-custom-connector.png?fit=max\&auto=format\&n=fCGo07SFu1Ff6Pf9\&q=85\&s=07c7194d88c1af1d75b7910e0f31016e) 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](https://developers.openai.com/codex/mcp/). ##### 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](https://mintcdn.com/superworkerai/fCGo07SFu1Ff6Pf9/apps/docs/images/mcp/codex-plugins.png?fit=max\&auto=format\&n=fCGo07SFu1Ff6Pf9\&q=85\&s=1941faa02cef1f1cbbd38fb953eadf19) 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. ```text theme={null} https://mcp.superworker.ai/mcp ``` ![Codex custom MCP form showing the Superworker name, Streamable HTTP selected, and the Superworker MCP URL](https://mintcdn.com/superworkerai/fCGo07SFu1Ff6Pf9/apps/docs/images/mcp/codex-mcp-setup.png?fit=max\&auto=format\&n=fCGo07SFu1Ff6Pf9\&q=85\&s=f2757dd9d147d7c2e1b3ff7806bed91e) 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. 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. ## 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: 1. Ask your assistant which workspace and brand are active. 2. Ask it which supported connections that brand already has. 3. Tell it which business question you want to answer, then follow its connection flow for any missing account. 4. Return to the conversation and ask it to verify the connection before continuing. ```text theme={null} 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 ```text theme={null} Explain this tracking warning. What did the scan observe, and what do we need to check in the connected accounts? ``` ### Prepare work for review ```text theme={null} Prepare a fix plan for this finding, including the proposed changes and how we will verify the result. ``` ### Review progress ```text theme={null} 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](#claude) or [Codex](#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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.