Universal Requirements (All Editors)

Backend Endpoint

Your MCP Unified Proxy endpoint is POST https://zephex.dev /mcp.

MCP uses Streamable HTTP sessions. After initialize, clients should forward the MCP-Session-Id response header on subsequent requests (the official editor integrations do this automatically).

Required MCP Methods

Example Initialize Request

curl -sS -D /tmp/mcp.headers -o /tmp/mcp.init.json -X POST "https://zephex.dev
/mcp" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"initialize",
    "params":{
      "protocolVersion":"2025-11-25",
      "capabilities":{},
      "clientInfo":{"name":"Test","version":"1.0.0"}
    }
  }'

Example tools/list Request (with Session)

SESSION_ID="$(awk 'BEGIN{IGNORECASE=1} $1 ~ /^mcp-session-id:$/ {sid=$2} END{print sid}' /tmp/mcp.headers | tr -d '\r')"

curl -sS -X POST "https://zephex.dev
/mcp" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -H "MCP-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Universal Test Script

Use the built-in script (recommended): mcp-proxy/scripts/test-editor-compatibility.sh.

API_KEY="mcp_sk_..." \
PROXY_URL="https://zephex.dev
/mcp" \
bash mcp-proxy/scripts/test-editor-compatibility.sh

Common User Issues