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, one config block, or — for clients with a native "Sign in" button — no manual setup at all.

Claude.ai (and other OAuth clients)

Some MCP clients — Claude.ai's remote-MCP connector, and any client built against the MCP authorization spec — connect with a real "Sign in with Vlozi" flow instead of a pasted key. There's no config to write: give the client the server URL, click Connect, and approve the request in your browser when it appears.

Server URL: https://mcp.vlozi.app/mcp

That's the only field a client like this asks for. Everything else — registration, the authorization redirect, token exchange — happens automatically:

1. The client discovers Vlozi's OAuth endpoints on its own (/.well-known/oauth-authorization-server) and registers itself.
2. It opens your browser to a Vlozi consent screen showing the client's name and exactly what it's asking to access.
3. You approve (choosing a role or hand-picking permissions, same picker as Settings → API Keys) or deny.
4. The client receives its own access token — no ls_ key ever touches its config.

The token is short-lived and refreshes itself automatically behind the scenes. To disconnect a client you've approved this way, go to Settings → API Keys → Connected apps and click Disconnect — this stops it from refreshing again (its current access token, valid for up to an hour, simply expires on its own shortly after), rather than making you wait out its full 90-day connection.

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+):

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