Gemini CLI

Configure mcpServers in ~/.gemini/settings.json (user) or .gemini/settings.json (project). Streamable HTTP uses httpUrl. The url field is the legacy SSE transport and will not work against Servicebay.

{
  "mcpServers": {
    "servicebay": {
      "httpUrl": "https://oauth.servicebay.io/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}

CLI (writes the same config; default scope is the project):

gemini mcp add --transport http servicebay https://oauth.servicebay.io/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

OAuth is supported for httpUrl when you omit the header; the handshake needs a local browser. Headless CI should use a static key.

Compatibility matrix · Troubleshooting