Skip to main content

Chameleon's MCP Server

Connect your Chameleon data to AI assistants like Claude and ChatGPT using the Model Context Protocol (MCP) for natural language querying

Written by Pulkit Agrawal

Overview

Ask natural language questions about your Chameleon data and get instant insights:

  • "Which tours have the highest completion rates?"

  • "Who are my most engaged users?"

  • "Show me users at risk of churning"

  • "How are my surveys performing?"

Your AI assistant gets real-time data from your Chameleon account to provide accurate, -to-date answers.

Setup Instructions

Claude.ai Web (Recommended)

Requirements: Claude Max, Team, or Enterprise plan

Step 1: Get Your API Token

  1. Go to Chameleon Settings → Integrations → Custom → API Tokens

  2. Click View my Tokens → Generate Token

  3. Give it an appropriate name (e.g. "MCP Server") and click Generate token

  4. Copy the token (it should look something like SEilsjr4agZ1fchMUVysiD7XOkfQTQNAQp5ZA8wsrgsnHn-1UO5F6-BavKjji83W0zEJi0

Once you've copied this token it will not be available again to copy so store is safely. Replace any instances of YOUR_ACTUAL_API_TOKEN or similar in the instructions below with this token

Step 2: Add Organization Connector (Admin Required)

  1. Go to claude.ai → Settings → Organization Connectors

  2. Click "Add custom connector"
    ​

  3. Enter the following details:

  4. Click "Add"

Step 3: Enable for Your Account

  1. Go to Settings → Your connectors

  2. Enable the "Chameleon" connector

  3. Click "Save"

Step 4: Test the Connection

Ask Claude: "What Chameleon tools do you have?"

Claude Desktop (Local)

Step 1: Get Your API Token

Follow the same process as Claude.ai Web above.

Step 2: Configure Claude Desktop

  1. Open Claude Desktop configuration file:

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

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

  2. Add this configuration:

    { "mcpServers": { "chameleon": { "command": "npx", "args": ["-y", "@chameleonhq/mcp"], "env": { "CHAMELEON_API_TOKEN": "your_token_here" } } } }

Step 3: Test the Connection

  1. Restart Claude Desktop completely

  2. Ask: "What Chameleon tools do you have?"

ChatGPT Enterprise/Team

Requirements: ChatGPT Enterprise, Education, or Team plan

Step 1: Get Your API Token

Follow the same process as Claude.ai Web above.

Step 2: Create Custom Connector (Admin Required)

  1. Go to ChatGPT workspace settings

  2. Navigate to Connectors

  3. Go to My Connectors → Create a Connector
    ​

  4. Add details:

Step 3: Test the Connection

Enable workspace-wide and test with the Deep Research feature.

Note: ChatGPT MCP setup may vary by organization. Contact your workspace admin for specific configuration steps.

Security & Privacy

Your data stays secure:

  • API tokens are transmitted securely and never logged

  • All connections use encrypted HTTPS/WSS protocols

  • No analytics data is stored permanently on our servers

  • Each user gets an isolated server instance

  • Built-in rate limiting prevents API abuse

Available Analytics Tools

Our MCP server provides 20 specialized tools across these categories:

Core Analytics

  • Account performance overview and health metrics

  • Experience completion rates and engagement trends

  • User search and activity pattern analysis

  • Survey response insights and feedback analysis

  • Company-level analytics and segmentation

Smart User Intelligence

  • Find engaged or inactive users using natural language queries

  • Churn risk analysis with actionable recommendations

  • User investigation tools for comprehensive health checks

Performance Intelligence

  • Universal analytics engine for complex, multi-faceted queries

  • Smart query pre-evaluation to ensure optimal tool selection

  • Intelligent caching for faster response times

Example Queries

User Analysis:

  • "Show me users who started tours in the last week but didn't finish them"

  • "Find my most engaged users from the enterprise segment"

  • "Who are my power users based on feature adoption?"

Performance Insights:

  • "Which tours have completion rates below 50%?"

  • "How is user engagement trending this month?"

  • "What are the top reasons users abandon our onboarding flow?"

Business Intelligence:

  • "Which companies are getting the most value from our experiences?"

  • "Show me survey responses mentioning 'confusing' or 'difficult'"

  • "What's our overall product adoption score?"

Troubleshooting

Common Issues

"No tools showing" in Claude:

  • Ensure you completely restarted Claude Desktop (quit and relaunch)

  • Verify the configuration file is saved properly

  • Check that your API token is valid

"Authentication failed" errors:

  • Verify your API token has Analytics permissions in Chameleon

  • Make sure there are no extra spaces in the token

  • Confirm the token hasn't expired

"Connection timeout" issues:

  • Check your internet connection

  • Verify the MCP server URL is correct

  • Try again in a few minutes (temporary server issues)

Getting Help

If you continue experiencing issues:

  1. Verify your API token permissions in Chameleon Settings → Integrations → API Tokens

  2. Check that your AI assistant plan supports custom connectors

  3. Contact support with the specific error message you're seeing

Technical Details

Server Information:

  • Hosted on secure cloud infrastructure

  • Supports both MCP and REST API protocols

  • Real-time connection to Chameleon's analytics APIs

  • Built-in caching with 5-minute refresh intervals

Supported Platforms:

  • Claude.ai (web browser)

  • Claude Desktop application

  • ChatGPT Enterprise/Team workspaces

  • OpenAI API and Realtime API integrations

This integration is maintained by the Chameleon team. For technical questions or feature requests, please contact our support team.

Did this answer your question?