Quick Start: Connect Your Code Editor

Connect your editor to Zephex in under 2 minutes.

Step 1: Get Your API Key

Go to Dashboard → API Keys
Create a new API key and copy it (shown once)
Store it securely (treat it like a password)

Step 2: Generate a Config Snippet

Editor

Proxy URL

Server name

API key (optional)

Leave blank to generate a placeholder snippet. If you paste a real key here, it will appear in the snippet you copy.

VS Code

Full guide →

Add this to .vscode/mcp.json (workspace) or MCP: Open User Configuration (global):

VS Code prompts for the API key via inputs (recommended so you don't store it in plain text).

{
  "inputs": [
    {
      "type": "promptString",
      "id": "mcp-proxy-api-key",
      "description": "Zephex API key",
      "password": true
    }
  ],
  "servers": {
    "unified-proxy": {
      "type": "http",
      "url": "https://zephex.dev/mcp/mcp",
      "headers": {
        "Authorization": "Bearer ${input:mcp-proxy-api-key}",
        "X-API-Source": "vscode"
      }
    }
  }
}

Step 3: Verify It Works

Restart your editor completely
Start a new chat
Ask: “What tools do you have available?”

Troubleshooting

Connection refused: check proxy health at https://zephex.dev/mcp/health and verify the URL ends in /mcp.
401 Unauthorized: verify the key is correct, not revoked/expired, and the header is Authorization: Bearer ….
Tools not showing up: restart the editor and start a new chat; wait ~10 seconds after restart.

More help: Connection Issues.