Universal Model Context Protocol (MCP) Setup for Previews

Previews provides a universal Model Context Protocol (MCP) server supporting:

1. Local Stdio Transport: Standard stdio subprocess bridge (npx preview-mcp) for all AI coding environments, IDEs, and CLI tools.

2. Remote Transports: Direct SSE (/mcp/sse) and HTTP JSON-RPC (/mcp) hosted on Cloudflare Workers edge for remote agents, cloud runtimes, and webhook integrations.

Authentication is powered entirely by your Google Account, reusing the existing session flow without custom token tables or passwords.

1. Zero-Friction Desktop Setup (Claude Desktop, Cursor, Windsurf)

To configure your desktop AI apps and authenticate with Google in one single step, run:

npx preview-mcp setup

This auto-detects installed desktop apps (such as Claude Desktop and Cursor), writes or updates their MCP configurations safely, and launches the browser to sign in with your Google Account.

To target a specific app:

npx preview-mcp setup claude    # Configure Claude Desktop
npx preview-mcp setup cursor    # Configure Cursor
npx preview-mcp setup all       # Configure all detected clients

Related MCP server: Gemini-Cloud-Agent-MCP

2. Quick Authentication & Re-authentication (Google Login)

Run this command anytime to sign in or re-authenticate:

npx preview-mcp login

(Or alias npx preview-mcp reauthenticate)

This opens your browser to sign in with Google. Once verified, credentials are automatically saved to ~/.preview/config.json.

Alternatively, if you're already logged into the Previews web dashboard, click "MCP / AI Agents" in the top navigation bar to copy your Google session token directly.

3. Manual Agent & IDE Configurations

All tools support the standard MCP JSON configuration format.

Antigravity / Gemini Code Assist

Add to your project's .gemini/settings.json or workspace MCP configuration:

{
  "mcpServers": {
    "preview": {
      "command": "npx",
      "args": ["-y", "preview-mcp"],
      "env": {
        "PREVIEWS_BASE_URL": "https://previews.kartikarora.me"
      }
    }
  }
}

Or connect directly to the remote SSE endpoint without a local Node.js process:

{
  "mcpServers": {
    "preview": {
      "url": "https://previews.kartikarora.me/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GOOGLE_SESSION_TOKEN"
      }
    }
  }
}

Cursor (.cursor/mcp.json or Settings → MCP)

{
  "mcpServers": {
    "preview": {
      "command": "npx",
      "args": ["-y", "preview-mcp"],
      "env": {
        "PREVIEWS_BASE_URL": "https://previews.kartikarora.me"
      }
    }
  }
}

OpenAI Codex / ChatGPT Desktop

Add to your client configuration:

{
  "mcpServers": {
    "preview": {
      "command": "npx",
      "args": ["-y", "preview-mcp"],
      "env": {
        "PREVIEWS_BASE_URL": "https://previews.kartikarora.me"
      }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "preview": {
      "command": "npx",
      "args": ["-y", "preview-mcp"],
      "env": {
        "PREVIEWS_BASE_URL": "https://previews.kartikarora.me"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

Run npx preview-mcp setup to automatically configure Claude Desktop.

Or configure manually in:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "preview": {
      "command": "npx",
      "args": ["-y", "preview-mcp"],
      "env": {
        "PREVIEWS_BASE_URL": "https://previews.kartikarora.me"
      }
    }
  }
}

Claude Plugin (Claude Code & Claude Desktop)

Install Previews as a native Claude plugin directly from GitHub:

claude plugin add kartikarora/preview-mcp

(Or clone https://github.com/kartikarora/preview-mcp into your Claude plugins directory)

Claude Code (.mcp.json or CLI)

Claude Code supports both standard HTTP transport with native Authenticate / Re-authenticate prompts, and local stdio:

# Direct HTTP transport with OAuth discovery:
claude mcp add --transport http preview https://previews.kartikarora.me/mcp

# Or stdio CLI transport:
claude mcp add preview -- npx -y preview-mcp

Inside your Claude Code session, type /mcp and select Authenticate or Re-authenticate to sign in directly with Google in your browser.

Zed Editor (~/.config/zed/settings.json)

{
  "experimental.features": {
    "model_context_protocol": true
  },
  "context_servers": {
    "preview": {
      "command": {
        "path": "npx",
        "args": ["-y", "preview-mcp"]
      }
    }
  }
}

3. Remote Cloud Agents (Direct Network / SSE)

For automated cloud agents (Antigravity, Gemini, OpenAI Codex, LangChain, LlamaIndex, Anthropic SDK, or custom scripts), no Node.js process is required. Connect directly over HTTP:

• SSE Endpoint: https://previews.kartikarora.me/mcp

• HTTP POST Endpoint: https://previews.kartikarora.me/mcp

• Header:

  Authorization: Bearer <GOOGLE_SESSION_TOKEN>

  (Or query parameter ?token=<GOOGLE_SESSION_TOKEN> on SSE connection)

4. Available MCP Tools

5. Prototyping & Voice Workflow Prompts

Previews exposes MCP Prompts for zero-friction prototyping: