From bfdc1a09281b2ca01014577c7b53c1d93814e230 Mon Sep 17 00:00:00 2001
From: Zach Leventer <zleventer@gmail.com>
Date: Fri, 24 Apr 2026 17:14:52 -0400
Subject: [PATCH] docs: add Claude Code and Cursor setup examples; fix bare
 except

- Add Claude Code and Cursor/VS Code configuration examples
- Rename "Configure Gemini" to "Configure your MCP client"
- Move credential/project substitution instructions above client configs
  to reduce duplication
- Replace bare except with except Exception in _get_package_version_with_fallback
---
 README.md                    | 48 +++++++++++++++++++++++++++---------
 analytics_mcp/tools/utils.py |  2 +-
 2 files changed, 38 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 8c37b0b..8239e2f 100644
--- a/README.md
+++ b/README.md
@@ -114,7 +114,14 @@ following message. You'll need this for the next step!
 Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
 ```
 
-### Configure Gemini
+### Configure your MCP client
+
+Add the server to your MCP client's configuration. Replace
+`PATH_TO_CREDENTIALS_JSON` with the path you copied in the previous step, and
+`YOUR_PROJECT_ID` with your
+[Google Cloud project ID](https://support.google.com/googleapi/answer/7014113).
+
+#### Gemini CLI / Gemini Code Assist
 
 1.  Install [Gemini
     CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/installation.md)
@@ -124,14 +131,6 @@ Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
 1.  Create or edit the file at `~/.gemini/settings.json`, adding your server
     to the `mcpServers` list.
 
-    Replace `PATH_TO_CREDENTIALS_JSON` with the path you copied in the previous
-    step.
-
-    We also recommend that you add a `GOOGLE_CLOUD_PROJECT` attribute to the
-    `env` object. Replace `YOUR_PROJECT_ID` in the following example with the
-    [project ID](https://support.google.com/googleapi/answer/7014113) of your
-    Google Cloud project.
-
     ```json
     {
       "mcpServers": {
@@ -150,10 +149,37 @@ Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
     }
     ```
 
+#### Claude Code (Anthropic)
+
+Add to your project's `.mcp.json` or `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "analytics-mcp": {
+      "command": "pipx",
+      "args": [
+        "run",
+        "analytics-mcp"
+      ],
+      "env": {
+        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
+        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
+      }
+    }
+  }
+}
+```
+
+#### Cursor / VS Code (Copilot)
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json` in your project root using
+the same `mcpServers` format shown above.
+
 ## Try it out 🥼
 
-Launch Gemini Code Assist or Gemini CLI and type `/mcp`. You should see
-`analytics-mcp` listed in the results.
+Launch your MCP client. You should see `analytics-mcp` listed in the
+available servers.
 
 Here are some sample prompts to get you started:
 
diff --git a/analytics_mcp/tools/utils.py b/analytics_mcp/tools/utils.py
index 0f35040..ecd0149 100644
--- a/analytics_mcp/tools/utils.py
+++ b/analytics_mcp/tools/utils.py
@@ -30,7 +30,7 @@ def _get_package_version_with_fallback():
     """
     try:
         return metadata.version("analytics-mcp")
-    except:
+    except Exception:
         return "unknown"