Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) allows AI assistants like Claude, ChatGPT and Cline to access external tools and services. By adding the Enigma MCP server, you give these assistants the ability to browse the web autonomously.

​
Setup (2 minutes)

​
Claude Desktop

Step 1: Open Configuration File
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Step 2: Add Enigma Server 
{
  "mcpServers": {
    "enigma": {
      "url": "https://connect.enigma.click/mcp/sse?apiKey=YOUR_API_KEY"
    }
  }
}
Step 3: Restart Claude Desktop Close and reopen the application. You’ll see Enigma tools available in the tool picker.

​
Cline (VS Code Extension)

Step 1: Open VS Code Settings
  • Press Cmd/Ctrl + Shift + P
  • Search for “Cline: Settings”
Step 2: Add MCP Server In the MCP Servers section, add: 
{
  "enigma": {
    "url": "https://connect.enigma.click/mcp/sse?apiKey=YOUR_API_KEY"
  }
}
Step 3: Reload Cline Reload the extension or restart VS Code.

​
Your First Browser Task

Once configured, you can ask Claude to browse the web: Example Prompts:
  • “Search Google for Anthropic and summarize the first result”
  • “Go to example.com and extract all the product prices”
  • “Navigate to LinkedIn, search for software engineers in SF, and list the top 5 results”
What happens:
  1. Claude recognizes your request requires web browsing
  2. It calls the Enigma MCP tool with your task
  3. An AI agent executes the task in a real browser
  4. Results are returned to Claude
  5. Claude presents the information to you

​
Available Tools (Summary)

The Enigma MCP server provides several tools:
ToolDescriptionUse Case
browser_taskExecute a single browser taskQuick one-off automations
create_sessionStart a persistent browser sessionMulti-step workflows
send_task_to_sessionSend a task to an existing sessionFollow-up actions
get_task_statusCheck the status of a running taskMonitoring long tasks
control_sessionPause, resume, or stop a sessionManual control
take_over_sessionEnable manual browser controlHuman-in-the-loop
Full MCP Reference →

​
Example Conversations

​
Simple Research

You: “Use Enigma to search for ‘Claude AI features’ on Google and tell me what you find.” Claude: (Uses browser_task tool) “I’ve searched Google for ‘Claude AI features’. Here’s what I found: Claude is Anthropic’s AI assistant with features including…”

​
Multi-Step Workflow

You: “Create a browser session, go to Amazon, search for wireless keyboards, and tell me the top 3 results.” Claude: (Uses create_session, then send_task_to_session) “I’ve navigated to Amazon and searched for wireless keyboards. Here are the top 3 results:
  1. Logitech K380 - $29.99
  2. Keychron K2 - $79.00
  3. …
Would you like me to get more details on any of these?”

​
Troubleshooting

​
Tools not appearing in Claude Desktop?

  1. Check config file path: Ensure you edited the correct file location
  2. Verify JSON syntax: Use a JSON validator to check for syntax errors
  3. Restart Claude: Fully quit and reopen the application
  4. Check API key: Ensure your API key is valid and starts with enig_

​
Authentication errors?

  • Verify your API key in the configuration
  • Check that you have sufficient balance in your Enigma account
  • Ensure the API key has not expired

​
Session timeout errors?

  • Enigma sessions have a maximum duration of 5 minutes
  • For long tasks, break them into smaller sub-tasks
  • Use get_task_status to monitor progress

​
Advanced Usage

For advanced MCP features like video streaming, manual control, and custom workflows, see the Full MCP Server Documentation.

​
Next Steps

Full MCP Reference

All tools, parameters, and advanced patterns

Multi-Task Workflows

Chain multiple browser tasks

Handling Guardrails

Respond to human-in-the-loop requests

Video Streaming

Watch browser sessions live