Model Context Protocol

ESAI MCP Server

Connect your IDE to this MCP server to access upgrade profiles, documentation, and AI-powered migration tools. Choose your IDE below for setup instructions.

IDE Configuration

Config file: %USERPROFILE%.claude.json · Docs →

First, install mcp-remote globally (requires Node.js):

npm install -g mcp-remote

Method 1 — PowerShell (one command):

claude mcp add esai-mcp -s user -- "%USERPROFILE%mcp-remote.cmd" https://esai.optimizely.com/mcp --header "X-API-Key:YOUR_API_KEY"

Method 2 — Add to ~/.claude.json directly:

{
  "mcpServers": {
    "esai-mcp": {
      "command": "%USERPROFILE%\mcp-remote.cmd",
      "args": [
        "https://esai.optimizely.com/mcp",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your actual key. After either method, reload VS Code — Ctrl+Shift+P → Developer: Reload Window. The 🔨 hammer icon confirms MCP tools are connected.

Config file: .vscode/mcp.json · Docs →

{
  "servers": {
    "acs": {
      "type": "http",
      "url": "https://esai.optimizely.com/mcp",
      "headers": {
        "X-API-Key": "${input:acs-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "acs-api-key",
      "type": "promptString",
      "description": "ACS MCP Server API Key",
      "password": true
    }
  ]
}

VS Code will prompt for your API key on first connection. You can also run MCP: Add Server from the Command Palette.

⬇ Download mcp.json

Config file: <SolutionDir>\.mcp.json or %USERPROFILE%\.mcp.json · Docs →

{
  "servers": {
    "acs": {
      "type": "http",
      "url": "https://esai.optimizely.com/mcp",
      "headers": {
        "X-API-Key": "${input:acs-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "acs-api-key",
      "type": "promptString",
      "description": "ACS MCP Server API Key",
      "password": true
    }
  ]
}

Works with Visual Studio 2022 (17.14+) and Visual Studio 2026. Place the file in your solution directory or user profile. VS also reads .vscode/mcp.json and .vs/mcp.json.

⬇ Download .mcp.json

Config file: .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) · Docs →

{
  "mcpServers": {
    "acs": {
      "url": "https://esai.optimizely.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual key, or use ${env:ACS_API_KEY} to reference an environment variable.

⬇ Download mcp.json

Config file: ~/.codeium/windsurf/mcp_config.json · Docs →

{
  "mcpServers": {
    "acs": {
      "serverUrl": "https://esai.optimizely.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual key, or use ${env:ACS_API_KEY} to reference an environment variable. You can also add MCPs from the Cascade panel → MCPs icon.

⬇ Download mcp_config.json

Config file: .mcp.json (project root) · Docs →

{
  "servers": {
    "acs": {
      "type": "http",
      "url": "https://esai.optimizely.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Works with IntelliJ IDEA, Rider, WebStorm, and other JetBrains IDEs with AI Assistant. You can also add servers via Settings → Tools → AI Assistant → MCP Servers.

⬇ Download .mcp.json