From 51302b02dddbcbace80cb1223d4f082ad8b706c2 Mon Sep 17 00:00:00 2001 From: Suryansh Garg Date: Sat, 27 Sep 2025 15:06:50 +0530 Subject: [PATCH 1/6] up --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 62e44bf..58770c3 100644 --- a/README.md +++ b/README.md @@ -171,6 +171,24 @@ The configuration for Claude Desktop and Cline is the same (provided below for [ Please refer to the [README file](./run-with-google-adk/README.md) for both - locally running the prebuilt agent and [Cloud Run](https://cloud.google.com/run) deployment. +## MCP Client Config Locations + +MCP clients all use the same JSON configuration format (see the [MCP Server Configuration Reference](https://google.github.io/mcp-security/usage_guide.html#mcp-server-configuration-reference)), but they expect the file in different locations. + +| Client Application | Scope | macOS / Linux Location | Windows Location | Notes | +| ------------------------ | --------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Gemini CLI** | Global | `~/.gemini/settings.json` | Likely `%APPDATA%\Gemini\settings.json` (not officially documented) | File must include `mcpServers`. Confirmed in [Google Security Ops post](https://security.googlecloudcommunity.com/google-security-operations-2/google-cloud-security-mcp-servers-in-gemini-cli-922). | +| **Claude Desktop** | Global | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` | Config accessible via *Claude > Settings > Developer > Edit Config*. | +| **Claude Code** | Global | `~/.claude.json` | Possibly `%APPDATA%\claude.json` (unverified) | Primary config file for Claude Code CLI and extensions. | +| **Cursor IDE (Global)** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | Enables MCP servers globally across all projects. | +| **Cursor IDE (Project)** | Project | `/.cursor/mcp.json` | `/.cursor/mcp.json` | Workspace-specific config file. | +| **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Used when an MCP extension (like **Cline**) is installed. | +| **Cline (VS Code Ext.)** | Global | Inside VS Code extension data | `%APPDATA%\Code(-Insiders)\User\globalStorage\...\cline_mcp_settings.json` | Exact path varies by VS Code variant and platform. | + +### Tip: Single Config with Symlinks + +If you use multiple MCP clients, you can maintain a **single config file** and symlink it into each expected location. This avoids drift and keeps your server definitions consistent. + ### Using uv (Recommended) From 9a7e3ae842898c0f34ba3e3eebdab9a89f947908 Mon Sep 17 00:00:00 2001 From: Suryansh Garg Date: Thu, 2 Oct 2025 22:51:17 +0530 Subject: [PATCH 2/6] requested edits --- README.md | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 58770c3..5422d37 100644 --- a/README.md +++ b/README.md @@ -175,15 +175,22 @@ Please refer to the [README file](./run-with-google-adk/README.md) for both - lo MCP clients all use the same JSON configuration format (see the [MCP Server Configuration Reference](https://google.github.io/mcp-security/usage_guide.html#mcp-server-configuration-reference)), but they expect the file in different locations. -| Client Application | Scope | macOS / Linux Location | Windows Location | Notes | -| ------------------------ | --------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Gemini CLI** | Global | `~/.gemini/settings.json` | Likely `%APPDATA%\Gemini\settings.json` (not officially documented) | File must include `mcpServers`. Confirmed in [Google Security Ops post](https://security.googlecloudcommunity.com/google-security-operations-2/google-cloud-security-mcp-servers-in-gemini-cli-922). | -| **Claude Desktop** | Global | `~/Library/Application Support/Claude/claude_desktop_config.json` | `%APPDATA%\Claude\claude_desktop_config.json` | Config accessible via *Claude > Settings > Developer > Edit Config*. | -| **Claude Code** | Global | `~/.claude.json` | Possibly `%APPDATA%\claude.json` (unverified) | Primary config file for Claude Code CLI and extensions. | -| **Cursor IDE (Global)** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | Enables MCP servers globally across all projects. | -| **Cursor IDE (Project)** | Project | `/.cursor/mcp.json` | `/.cursor/mcp.json` | Workspace-specific config file. | -| **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Used when an MCP extension (like **Cline**) is installed. | -| **Cline (VS Code Ext.)** | Global | Inside VS Code extension data | `%APPDATA%\Code(-Insiders)\User\globalStorage\...\cline_mcp_settings.json` | Exact path varies by VS Code variant and platform. | +| Client Application | Scope | macOS / Linux Location | Windows Location | Notes | +| ------------------------ | --------- | ------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Gemini CLI** | Global | `~/.gemini/settings.json` | `%USERPROFILE%\.gemini\settings.json` | File must include `mcpServers`. Confirmed in [Google Security Ops post](https://security.googlecloudcommunity.com/google-security-operations-2/google-cloud-security-mcp-servers-in-gemini-cli-922). | +| **Claude Desktop** | Global | `~/Claude/claude_desktop_config.json` | `%USERPROFILE%\Claude\claude_desktop_config.json` | Config accessible via *Claude > Settings > Developer > Edit Config*. | +| **Claude Code** | Global | `~/.claude.json` | `%APPDATA%\claude.json` | Primary config file for Claude Code CLI and extensions. | +| **Cursor IDE (Global)** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | Enables MCP servers globally across all projects. | +| **Cursor IDE (Project)** | Project | `/.cursor/mcp.json` | `/.cursor/mcp.json` | Workspace/project-specific config file. | +| **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Workspace-level config used when an MCP extension (like **Cline**) is installed. Overrides global config if present. | +| **Cline (VS Code Ext.)** | Global | Inside VS Code extension data | `%APPDATA%\Code\User\globalStorage\\settings\cline_mcp_settings.json` | Exact path varies by VS Code variant and platform. `` corresponds to the installed extension folder (e.g., `saoudrizwan.claude-dev`). | + +### Additional Notes for Testing on Windows + +- `%USERPROFILE%` → `C:\Users\` +- `%APPDATA%` → `C:\Users\\AppData\Roaming` +- `` → folder opened in VS Code or IDE for the project +- `` → name of the installed extension folder (e.g., `saoudrizwan.claude-dev` for Claude/Cline) ### Tip: Single Config with Symlinks From 0fa17677c6c5aefafbcdede3e760185ef4601220 Mon Sep 17 00:00:00 2001 From: Suryansh Garg Date: Thu, 2 Oct 2025 22:56:55 +0530 Subject: [PATCH 3/6] Update README.md From beebdd3f33f003056fe0c1ce83fffb11647f977a Mon Sep 17 00:00:00 2001 From: Suryansh Garg Date: Mon, 6 Oct 2025 17:36:47 +0530 Subject: [PATCH 4/6] Update Windows location for Claude Code config --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5422d37..3706049 100644 --- a/README.md +++ b/README.md @@ -179,7 +179,7 @@ MCP clients all use the same JSON configuration format (see the [MCP Server Conf | ------------------------ | --------- | ------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Gemini CLI** | Global | `~/.gemini/settings.json` | `%USERPROFILE%\.gemini\settings.json` | File must include `mcpServers`. Confirmed in [Google Security Ops post](https://security.googlecloudcommunity.com/google-security-operations-2/google-cloud-security-mcp-servers-in-gemini-cli-922). | | **Claude Desktop** | Global | `~/Claude/claude_desktop_config.json` | `%USERPROFILE%\Claude\claude_desktop_config.json` | Config accessible via *Claude > Settings > Developer > Edit Config*. | -| **Claude Code** | Global | `~/.claude.json` | `%APPDATA%\claude.json` | Primary config file for Claude Code CLI and extensions. | +| **Claude Code** | Global | `~/.claude.json` | `%USERPROFILE%\claude.json` | Primary config file for Claude Code CLI and extensions. | | **Cursor IDE (Global)** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | Enables MCP servers globally across all projects. | | **Cursor IDE (Project)** | Project | `/.cursor/mcp.json` | `/.cursor/mcp.json` | Workspace/project-specific config file. | | **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Workspace-level config used when an MCP extension (like **Cline**) is installed. Overrides global config if present. | From 8bdb618a2c2828e872173d0275aa17d25aecb3ea Mon Sep 17 00:00:00 2001 From: Mihir Vala <179564180+mihirvala-crestdata@users.noreply.github.com> Date: Mon, 6 Oct 2025 17:56:33 +0530 Subject: [PATCH 5/6] chore: minor claude code windows path correction --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3706049..44e70f0 100644 --- a/README.md +++ b/README.md @@ -179,7 +179,7 @@ MCP clients all use the same JSON configuration format (see the [MCP Server Conf | ------------------------ | --------- | ------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Gemini CLI** | Global | `~/.gemini/settings.json` | `%USERPROFILE%\.gemini\settings.json` | File must include `mcpServers`. Confirmed in [Google Security Ops post](https://security.googlecloudcommunity.com/google-security-operations-2/google-cloud-security-mcp-servers-in-gemini-cli-922). | | **Claude Desktop** | Global | `~/Claude/claude_desktop_config.json` | `%USERPROFILE%\Claude\claude_desktop_config.json` | Config accessible via *Claude > Settings > Developer > Edit Config*. | -| **Claude Code** | Global | `~/.claude.json` | `%USERPROFILE%\claude.json` | Primary config file for Claude Code CLI and extensions. | +| **Claude Code** | Global | `~/.claude.json` | `%USERPROFILE%\.claude.json` | Primary config file for Claude Code CLI and extensions. | | **Cursor IDE (Global)** | Global | `~/.cursor/mcp.json` | `%USERPROFILE%\.cursor\mcp.json` | Enables MCP servers globally across all projects. | | **Cursor IDE (Project)** | Project | `/.cursor/mcp.json` | `/.cursor/mcp.json` | Workspace/project-specific config file. | | **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Workspace-level config used when an MCP extension (like **Cline**) is installed. Overrides global config if present. | From 4d6d34155bd06d6e57962711403abc74d53cb3f5 Mon Sep 17 00:00:00 2001 From: Mihir Vala <179564180+mihirvala-crestdata@users.noreply.github.com> Date: Mon, 6 Oct 2025 17:59:34 +0530 Subject: [PATCH 6/6] docs: simplify Windows section heading in README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 44e70f0..382f543 100644 --- a/README.md +++ b/README.md @@ -185,7 +185,7 @@ MCP clients all use the same JSON configuration format (see the [MCP Server Conf | **VS Code (Workspace)** | Workspace | `/.vscode/mcp.json` | `/.vscode/mcp.json` | Workspace-level config used when an MCP extension (like **Cline**) is installed. Overrides global config if present. | | **Cline (VS Code Ext.)** | Global | Inside VS Code extension data | `%APPDATA%\Code\User\globalStorage\\settings\cline_mcp_settings.json` | Exact path varies by VS Code variant and platform. `` corresponds to the installed extension folder (e.g., `saoudrizwan.claude-dev`). | -### Additional Notes for Testing on Windows +### Additional Notes for Windows - `%USERPROFILE%` → `C:\Users\` - `%APPDATA%` → `C:\Users\\AppData\Roaming`