Skip to main content

Clearer MCP Server

Connect Clearer MCP so AI tools like Claude and ChatGPT can securely access your store data.

Written by Thomas Ta

Clearer.io MCP allows AI agents to securely retrieve structured store data for analysis and insights.


What is Clearer MCP?

Clearer MCP (Model Context Protocol) allows AI tools like ChatGPT, Claude, and Cursor to securely connect to your store’s real data.

Once connected, your AI Agent can:

  • Analyze store performance

  • Understand customer behavior

  • Generate insights using Clearer features (Search, Merchandising, Bundles, Segmentation, Smart Catalog, etc.)

🔎 Before you start: To connect Clearer MCP to any AI Agent, you must first create an MCP Server for your store.

  • The MCP Server is created per store, not per user.

  • All users in the same store share the same MCP Server.

  • Only one MCP Server is needed per store.


What data can AI agents access via Clearer.io MCP?

Depending on what’s enabled in your store, MCP can expose structured data such as:

Feature

Information

Search

  • Search queries list & total searches

  • CTR / CVR per search query

  • Search result product lists

  • Manual & AI synonym lists

  • Product performance (CTR/CVR)

  • Best-selling products

Merchandising

  • Pin / Boost / Hide strategy configuration

  • Rules and ranked product lists

  • Active date ranges

  • Real-time inventory status

Bundles (Coming soon)

  • Bundle groups & product lists

  • CTR / CVR & discount info

  • Inventory availability

Recommendation (Coming soon)

  • Recommendation widgets & product lists

  • CTR / CVR of recommended products

  • Stock status

User Segmentation (Coming soon)

  • Segment lists & conditions

  • Segment type (AI / manual)

  • Profiles in each segment

  • Segment actions

Smart catalog (Coming soon)

  • Product Category, tags classification

  • AI-generated product tags

  • Missing product data summary

  • Last scan timestamp

  • Exportable product list

All data access is secure and scoped to your store.


Create Your MCP Server

Create MCP Server

  1. On the bottom left of the app admin, go to All settings > Integration > Clearer MCP > Clearer > Click Create now
    ​

  2. The system will generate your store’s MCP Server URL

  3. You will be redirected to the Integration page

  4. Status will show: Enabled

Your MCP Server is now ready.

Understand MCP Server status

You can manage your MCP Server anytime in the Integration page.

Enabled (Default)

  • AI Agents can access store data

  • Insights and analysis will work normally

Disabled

  • MCP Server is turned off

  • AI Agents will no longer be able to retrieve data from Clearer

You can toggle between Enable/Disable at any time.


Connect Clearer.io MCP to Claude

Important notes (Claude permissions)

  • While anyone can build and host connectors using remote MCP, only Owners can add custom connectors to Team and Enterprise plans.

  • After a connector is added to a Team/Enterprise org, each user must individually connect and enable it.

  • This ensures Claude can only access tools and data the individual user already has permission to access.

Step 1: Add Clearer.io MCP as a custom connector

  1. Open Claude

  2. Go to Admin Settings

  3. Navigate to Connectors

  4. Click Add custom connector

Step 2: Enter MCP details

In the modal, enter:

  • Name: Clearer

  • Remote MCP Server URL, in this format:

https://mcp.clearer.io/claude/[store-id]/[unique-authentication-code]/mcp/

⚠️ Note: The MCP Server URL is store-specific. Copy the exact URL shown in the Connect Claude with Clearer MCP modal inside Clearer.io. Do not reuse another store’s URL.

Click Add.

Step 3: Connect the MCP server

  1. Go to Personal Settings

  2. Open Connectors

  3. Find the Clearer.io connector

  4. Click Connect

Step 4: Test the connection

  1. Open a new chat.

  2. Click the + button in the chat input, choose Connectors, and toggle on Clearer MCP.

  3. Enter the prompt: “Using the Clearer MCP service, get my account details.”

  4. Confirm the response references your Clearer account data.


Connect Clearer.io MCP to ChatGPT

Important notes (ChatGPT plan requirement)

⚠️ This feature is only available for ChatGPT Pro and Plus plans. Make sure you are logged into a supported plan before starting setup.

📝 Note: MCP connector setup is only available in the web browser version of ChatGPT. Once complete, the Clearer connector will automatically appear in the chat section of your ChatGPT mobile and desktop apps.

Step 1: Enable Developer Mode

  1. Open ChatGPT

  2. Go to Settings

  3. Navigate to Apps

  4. Click Advanced settings

  5. Turn on Developer mode

Step 2: Create a new app

  1. Go back to Apps

  2. Click Create app

Step 3: Enter MCP configuration

In the New App modal:

  • Name: Clearer

  • MCP Service URL, in this format:

https://mcp.clearer.io/gpt/[store-id]/[unique-authentication-code]/mcp/

  • Authentication: OAuth

  • Check: “I understand and want to continue”

  • Click Create

⚠️ Note: The MCP Server URL is store-specific. Copy the exact URL shown in the Connect ChatGPT with Clearer MCP modal inside Clearer.io. Do not reuse another store’s URL.

Step 4: Authorize application

Approve the Authorize Application request when prompted.

Step 5: Test the connection

  1. Open a new chat.

  2. Click the + button in the chat input, select More, and connect Clearer MCP.

  3. Enter the prompt: “Using the Clearer MCP service, get my account details.”

  4. Confirm the response references your Clearer account data.


Security and data control

  • The MCP Server is store-specific.

  • Data is only accessible when the status is Enabled.

  • You can disable access at any time.

If you disable MCP:

  • AI Agents immediately lose access to your store data.

  • No further data is shared.


Feel free to reach out to our dedicated support team via chat with any further questions.

Did this answer your question?