Skip to content

docs(antigravity): fix MCP config path and remote server key - #3840

Open
zhiganovsasha wants to merge 1 commit into
github:mainfrom
zhiganovsasha:docs/antigravity-mcp-config-path
Open

zhiganovsasha wants to merge 1 commit into
github:mainfrom
zhiganovsasha:docs/antigravity-mcp-config-path

Conversation

@zhiganovsasha

Copy link
Copy Markdown

Summary

Fix the Antigravity installation guide to point at the MCP configuration file Antigravity actually reads, and to describe the accepted remote-server keys correctly.

Why

Fixes #3839

What changed

  • Point the configuration path at ~/.gemini/config/mcp_config.json (C:\Users\<USERNAME>\.gemini\config\mcp_config.json on Windows) instead of ~/.gemini/antigravity/mcp_config.json, which is not a file Antigravity reads.
  • Note that Antigravity accepts serverUrl and also the standard url key for remote servers, instead of stating that serverUrl replaces url.
  • Link to the Antigravity MCP documentation for the full configuration schema, and mention that the global file can be created if it does not exist yet.
  • Replace the troubleshooting entry that quotes the no-longer-current error message ("Error: serverUrl or command must be specified") with a check that serverUrl/url points at the Streamable HTTP endpoint, plus a reminder of the config file location.

MCP impact

  • No tool or API changes
  • Tool schema or behavior changed
  • New tool added

Prompts tested (tool changes only)

Not applicable: this is a documentation-only change, no tools are added or modified.

Security / limits

  • No security or limits impact
  • Auth / permissions considered
  • Data exposure, filtering, or token/size limits considered

Tool renaming

  • I am renaming tools as part of this PR (e.g. a part of a consolidation effort)
    • I have added the new tool aliases in deprecated_tool_aliases.go
  • I am not renaming tools as part of this PR

Lint & tests

  • Linted locally with ./script/lint
  • Tested locally with ./script/test

Not run, and not needed for this change: the diff touches one Markdown file in docs/installation-guides/ and no Go or UI code, so neither script covers it. The file was verified to remain UTF-8 without BOM and LF line endings.

Docs

  • Not needed
  • Updated (README / docs / examples)

The Antigravity guide pointed at ~/.gemini/antigravity/mcp_config.json, a path
that does not exist: Antigravity's global MCP configuration lives at
~/.gemini/config/mcp_config.json.

The guide also stated that Antigravity uses serverUrl instead of url for
remote servers. Antigravity accepts both, so the note now says that either
key works and links to the Antigravity MCP documentation.
@zhiganovsasha
zhiganovsasha requested a review from a team as a code owner November 13, 2026 06:24
Copilot AI adaptive review requested due to automatic review settings November 13, 2026 06:24

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues remain, and the installation guide updates address the documented configuration paths, supported remote-server keys, and troubleshooting guidance.

No open issues 🎉

What changed in this PR

Updates the Antigravity installation guide to use the correct MCP configuration path and accurately document supported remote-server keys and troubleshooting steps.

Changes:

  • Corrects global configuration paths for Windows and macOS/Linux.
  • Documents support for both serverUrl and url, with a link to Antigravity’s schema documentation.
  • Refreshes troubleshooting guidance for Streamable HTTP and the current configuration location.
File Description
docs/​installation-guides/​install-antigravity.md Updates Antigravity configuration paths, remote-server key guidance, troubleshooting instructions, schema documentation links, and IDE differences documentation.

Review effort: Lite (dynamic)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Antigravity guide points at a config file path that does not exist

2 participants