MCP clients (Claude, Cursor, Windsurf…)

Vlozi MCP speaks the standard Streamable HTTP transport at https://mcp.vlozi.app/mcp. Every modern MCP client connects with one command or one config block — no bridges, no proxies, no local processes.

IMPORTANT

Replace YOUR_VLOZI_KEY with your secret key from Settings → API Keys at vlozi.app. It starts with ls_.

Claude Code

claude mcp add --transport http vlozi https://mcp.vlozi.app/mcp \
  --header "Authorization: Bearer YOUR_VLOZI_KEY"

claude mcp list    # vlozi    https://mcp.vlozi.app/mcp    ✓ connected

Claude Desktop

Settings → Developer → Edit Config:

{
  "mcpServers": {
    "vlozi": {
      "url": "https://mcp.vlozi.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_VLOZI_KEY" }
    }
  }
}

Restart Claude Desktop.

Cursor

Settings → Cursor Settings → MCP:

{
  "mcpServers": {
    "vlozi": {
      "type": "http",
      "url": "https://mcp.vlozi.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_VLOZI_KEY" }
    }
  }
}

Windsurf

Windsurf Settings → MCP servers → Add server:

{
  "mcpServers": {
    "vlozi": {
      "serverUrl": "https://mcp.vlozi.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_VLOZI_KEY" }
    }
  }
}

Antigravity

Add a .mcp.json to your project root:

{
  "mcpServers": {
    "vlozi": {
      "type": "http",
      "url": "https://mcp.vlozi.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_VLOZI_KEY" }
    }
  }
}

Codex CLI

Edit ~/.codex/mcp.json:

{
  "servers": {
    "vlozi": {
      "transport": "http",
      "url": "https://mcp.vlozi.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_VLOZI_KEY" }
    }
  }
}

codex --reload

Continue.dev

Edit ~/.continue/config.yaml:

mcpServers:
  - name: vlozi
    url: https://mcp.vlozi.app/mcp
    headers:
      Authorization: Bearer YOUR_VLOZI_KEY

Other MCP clients

Any client that supports MCP Streamable HTTP (spec rev 2024-11-05+):

Field	Value
URL	`https://mcp.vlozi.app/mcp`
Method	`POST` (JSON-RPC)
Header	`Authorization: Bearer YOUR_VLOZI_KEY`

First test

In any of the clients above:

Use the vlozi tools to list my blog categories and any drafts I have.

A working setup calls blog.list_categories then blog.list_posts and reports back.

Troubleshooting

Symptom	Fix
All calls return `-32001`	Key missing/wrong — test with curl first (see Quickstart)
Some tools missing	Key missing scopes — see Authentication
`-32601 Method not found`	Client speaks legacy SSE — use `mcp-remote` as a bridge
Connection timeout	Corporate proxy — whitelist `mcp.vlozi.app`