Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 2 additions & 0 deletions reference/cli/mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
59 changes: 59 additions & 0 deletions reference/mcp-server/clients/antigravity.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: "Google Antigravity"
description: "Connect Google Antigravity to the Kernel MCP server"
---

<Warning>
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.
</Warning>

## 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`.
Loading