diff --git a/docs.json b/docs.json index 7eca5601..3acf12c5 100644 --- a/docs.json +++ b/docs.json @@ -446,6 +446,7 @@ "pages": [ "reference/mcp-server/clients/claude", "reference/mcp-server/clients/cursor", + "reference/mcp-server/clients/antigravity", "reference/mcp-server/clients/opencode", "reference/mcp-server/clients/fx", "reference/mcp-server/clients/goose", diff --git a/reference/cli/mcp.mdx b/reference/cli/mcp.mdx index ba5240cb..a7268f25 100644 --- a/reference/cli/mcp.mdx +++ b/reference/cli/mcp.mdx @@ -15,6 +15,7 @@ Install Kernel MCP server configuration for a supported AI development tool. Thi - `cursor` - Cursor editor - `claude` - Claude Desktop app - `claude-code` - Claude Code CLI +- `antigravity` - Google Antigravity - `windsurf` - Windsurf editor - `vscode` - Visual Studio Code - `goose` - Goose AI @@ -51,6 +52,7 @@ The `mcp install` command: The command automatically configures the appropriate transport and settings for each tool: - **Cursor, Claude Code, VS Code, fx**: Uses HTTP transport (`https://mcp.onkernel.com/mcp`) +- **Antigravity**: Uses HTTP transport, keyed off `serverUrl` rather than `url` - **Claude Desktop, Windsurf, Goose, Zed**: Uses stdio transport via `mcp-remote` ### Next Steps diff --git a/reference/mcp-server/clients/antigravity.mdx b/reference/mcp-server/clients/antigravity.mdx new file mode 100644 index 00000000..5bf0a941 --- /dev/null +++ b/reference/mcp-server/clients/antigravity.mdx @@ -0,0 +1,59 @@ +--- +title: "Google Antigravity" +description: "Connect Google Antigravity to the Kernel MCP server" +--- + + +Antigravity can complete the OAuth flow and still send `initialize` without the bearer token attached, which comes back as `401 Unauthorized` ([antigravity-cli#25](https://github.com/google-antigravity/antigravity-cli/issues/25)). + +If you hit that, [connect with an API key](#connect-with-an-api-key-workaround) instead of OAuth. + + +## Install with the Kernel CLI + +Run the following command: + +```bash +kernel mcp install --target antigravity +``` + +## Configure manually + +Alternatively, open the agent side panel, click the ellipsis (**…**) menu, and select **MCP Servers**, then **Manage MCP Servers → View raw config**. Add Kernel to the `mcpServers` map in `mcp_config.json` — `~/.gemini/config/mcp_config.json` globally, or `.agents/mcp_config.json` for a single workspace: + +```json +{ + "mcpServers": { + "kernel": { + "serverUrl": "https://mcp.onkernel.com/mcp" + } + } +} +``` + +Antigravity uses `serverUrl` for remote servers; `url` and `httpUrl` are ignored. Reload the window to pick up the change. + +## Connect + +Press **⌘/Ctrl ,** to open agent settings, go to the **Customizations** tab, and click **Authenticate** next to **kernel**. + +Authorize access in the browser window that opens, then copy the authorization code, paste it back into the settings panel, and click **Submit**. Antigravity stores the tokens in `~/.gemini/antigravity/mcp_oauth_tokens.json` and refreshes them for you. + +## Connect with an API key (workaround) + +Get a project-scoped Kernel API key from the [Kernel Dashboard](https://dashboard.onkernel.com/api-keys) and pass it as a header instead of authenticating. `kernel mcp install --target antigravity` always writes the OAuth config, so add the `headers` block by hand: + +```json +{ + "mcpServers": { + "kernel": { + "serverUrl": "https://mcp.onkernel.com/mcp", + "headers": { + "Authorization": "Bearer YOUR_KERNEL_API_KEY" + } + } + } +} +``` + +Leave the **Authenticate** button alone when using this — Antigravity sends the header on every request, including `initialize`.