Agent Integration

Connect Your Agent

Configure your MCP client to give coding agents access to Stitch tools.

Connect Your Agent

Before connecting, make sure you have credentials configured. See Setup if you haven’t authenticated yet. For background on proxy vs direct connections, see Connection Modes.

Per-client configuration

The init wizard generates the right config for you:

TERMINAL

npx @_davideast/stitch-mcp init

Or manually configure your client below. If you haven’t decided between proxy and direct, read Connection Modes first. Each client below shows the proxy config first (with API key auth), then the direct config.

Claude Code

Proxy with API key:

TERMINAL

claude mcp add stitch -e STITCH_API_KEY=YOUR_API_KEY \
  -- npx @_davideast/stitch-mcp proxy

Proxy with OAuth:

TERMINAL

claude mcp add stitch -- npx @_davideast/stitch-mcp proxy

Direct with API key:

TERMINAL

claude mcp add stitch \
  --transport http https://stitch.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY" \
  -s user

-s user saves to $HOME/.claude.json. Use -s project for ./.mcp.json.

VS Code

Add to .vscode/mcp.json. Open with: Command Palette > “MCP: Open User Configuration” or “MCP: Open Workspace Folder Configuration”.

Proxy with API key:

JSON

{
  "servers": {
    "stitch": {
      "type": "stdio",
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Proxy with OAuth:

JSON

{
  "servers": {
    "stitch": {
      "type": "stdio",
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Direct with API key:

JSON

{
  "servers": {
    "stitch": {
      "type": "http",
      "url": "https://stitch.googleapis.com/mcp",
      "headers": {
        "Accept": "application/json",
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

Proxy with API key:

JSON

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Proxy with OAuth:

JSON

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Direct with API key:

JSON

{
  "mcpServers": {
    "stitch": {
      "url": "https://stitch.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI

Install the Stitch extension:

TERMINAL

gemini extensions install https://github.com/gemini-cli-extensions/stitch

No JSON config needed — the extension handles connectivity.

Codex

Add to ~/.codex/config.toml:

Proxy with API key:

TOML

[mcp_servers.stitch]
command = "npx"
args = ["@_davideast/stitch-mcp", "proxy"]

[mcp_servers.stitch.env]
STITCH_API_KEY = "YOUR_API_KEY"

Proxy with OAuth:

TOML

[mcp_servers.stitch]
command = "npx"
args = ["@_davideast/stitch-mcp", "proxy"]

[mcp_servers.stitch.env]
STITCH_PROJECT_ID = "YOUR_PROJECT_ID"

Direct with API key:

TOML

[mcp_servers.stitch]
url = "https://stitch.googleapis.com/mcp"

[mcp_servers.stitch.env_http_headers]
X-Goog-Api-Key = "YOUR_API_KEY"

OpenCode

Add to opencode.json in your project root:

Proxy with API key:

JSON

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stitch": {
      "type": "local",
      "command": ["npx", "@_davideast/stitch-mcp", "proxy"],
      "environment": {
        "STITCH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Proxy with OAuth:

JSON

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stitch": {
      "type": "local",
      "command": ["npx", "@_davideast/stitch-mcp", "proxy"],
      "environment": {
        "STITCH_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Direct with API key:

JSON

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stitch": {
      "type": "remote",
      "url": "https://stitch.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Antigravity

Add via: Agent Panel > three dots > MCP Servers > Manage MCP Servers > View raw config.

Proxy with API key:

JSON

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Proxy with OAuth:

JSON

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["@_davideast/stitch-mcp", "proxy"],
      "env": {
        "STITCH_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Direct with API key:

JSON

{
  "mcpServers": {
    "stitch": {
      "serverUrl": "https://stitch.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Note: Antigravity uses serverUrl instead of url for HTTP connections.

Verifying the connection

List available tools to confirm your agent can reach Stitch:

TERMINAL

npx @_davideast/stitch-mcp tool

If you see both upstream tools (like list_projects) and virtual tools (like build_site), the proxy is working. If you only see upstream tools, you’re connected directly.

Run doctor to diagnose authentication issues:

TERMINAL

npx @_davideast/stitch-mcp doctor --verbose