MCP Server

The Intelligems MCP (Model Context Protocol) Server provides AI assistants like Claude, ChatGPT, and Gemini with secure, authenticated access to your Intelligems data and Shopify store information through a standardized protocol.

What is MCP?

The Model Context Protocol (MCP) is an open standard created by Anthropic that allows AI assistants to securely connect to external data sources and tools. The Intelligems MCP Server implements this protocol to give AI assistants controlled access to:

• Your Intelligems experiments and experiences

• Organization configuration

• Shopify store catalog, collections, and pages

• Analytics and audience data

• Custom events and integrations

Quick Start

Prerequisites

• An active Intelligems account

• A Shopify store connected to Intelligems

• An MCP-compatible AI client (e.g., Claude Desktop, ChatGPT, Gemini, etc.)

Installation

The Intelligems MCP Server is hosted at: https://ai.intelligems.io

No installation is required - the server is hosted by Intelligems and ready to use.

Configuration

Add the Intelligems MCP Server to your AI client's configuration:

Claude Desktop:

Due to a Claude Desktop bug, MCP setup via the Connectors page is not currently supported. Please follow steps below.

Quick Install:

macOS / Linux

Open Terminal and run:

curl -fsSL https://static.intelligems.io/mcp/claude-desktop/install.sh | bash

Windows

Open PowerShell and run:

irm https://static.intelligems.io/mcp/claude-desktop/install.ps1 | iex

After installation, restart Claude Desktop to activate the Intelligems MCP server.

Manual Install:

Claude Desktop supports remote MCP servers with OAuth authentication. Add the Intelligems MCP Server via the UI:

1. Open Claude in your web browser or the desktop app

2. Click your profile name in the sidebar and select Settings

3. Click Developer

4. Choose "Edit Config"

1. Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Add the following MCP server entry:

{
  "mcpServers": {
    "intelligems":
        {
            "command": "npx",
            "args":
            [
                "-y",
                "mcp-remote",
                "https://ai.intelligems.io/mcp"
            ]
        }
  }
}

1. Save and restart Claude Desktop

2. When starting a new chat, confirm that Intelligems is toggled on in the options menu, pictured below

In order to avoid hitting "Allow" every time Claude pulls information from Intelligems, go to Settings > Connectors > Configure next to Intelligems > switch the dropdown next to "Read-only tools" to "Always allow".

Claude Code:

Add the Intelligems MCP Server using the CLI:

# Add with HTTP transport (recommended)
claude mcp add --transport http intelligems https://ai.intelligems.io/mcp

# Or with SSE transport
claude mcp add --transport sse intelligems https://ai.intelligems.io/mcp/sse

When you first use the server, Claude Code will trigger a browser-based OAuth login. Complete the authentication flow to authorize access to your Intelligems account. Tokens are stored securely and refresh automatically.

Alternatively, you can add the server to your .mcp.json configuration file in your project root or ~/.claude.json for user-wide access:

{
  "mcpServers": {
    "intelligems": {
      "type": "http",
      "url": "https://ai.intelligems.io/mcp"
    }
  }
}

Management commands:

claude mcp list           # View all configured servers
claude mcp get intelligems # Get server details
claude mcp remove intelligems # Remove the server

ChatGPT:

Custom Connectors require a paid ChatGPT plan (Plus, Team, or Enterprise) to use.

ChatGPT supports MCP servers through Developer Mode. To add the Intelligems MCP Server:

1. Open ChatGPT in your web browser

2. Click your profile name in the sidebar and select Settings

3. Navigate to Apps & Connectors > Advanced settings

4. Enable Developer mode

5. Return to Apps & Connectors and click Create

6. Configure the connector:

   • Name: Intelligems

   • MCP Server URL: https://ai.intelligems.io/mcp

   • Authentication: Select OAuth

   • Check "I understand and want to continue"

7. Click Create and complete the OAuth authorization flow

To use in a chat:

1. Open a new chat

2. Click the + icon in the message bar

3. Select More > Developer Mode

4. Choose Add sources and enable the Intelligems MCP server

Google Gemini (Gemini CLI):

Add the Intelligems MCP Server using the Gemini CLI:

# Add with HTTP transport (recommended)
gemini mcp add --transport http intelligems https://ai.intelligems.io/mcp

# Or with SSE transport
gemini mcp add --transport sse intelligems https://ai.intelligems.io/mcp/sse

Alternatively, add the server to your ~/.gemini/settings.json (user-wide) or .gemini/settings.json (project-level):

{
  "mcpServers": {
    "intelligems": {
      "httpUrl": "https://ai.intelligems.io/mcp"
    }
  }
}

Management commands:

gemini mcp list           # View all configured servers
gemini mcp remove intelligems # Remove the server

Other MCP Clients:

Refer to your client's documentation for adding OAuth2-authenticated SSE-based or http MCP servers.

• HTTP: https://ai.intelligems.io/mcp (recommended)

• SSE: https://ai.intelligems.io/mcp/sse

Multi-Organization Support

If you have access to multiple Intelligems organizations, you can specify which one to use:

• During initial authentication, choose any organization installed on Intelligems. This is only used for authentication.

• Most tools accept an optional organization parameter to override the default

• Use the getOrganizationsList tool to see all organizations you have access to

• If you would like to always use a specific organization, add a System Prompt or Custom Instruction to your LLM with these details.