From 50e48a679a36e9c51916b8009fff182fa7c09b96 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Jul 2026 17:44:43 +0000
Subject: [PATCH 1/2] Initial plan


From 25d30c152de6ddcd419038ec90aa817a9601b0af Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 17 Jul 2026 17:53:43 +0000
Subject: [PATCH 2/2] GRO-107: Update MCP docs to recommend direct connection
 for Cursor and Gemini CLI

- Cursor OAuth: use direct `url` format instead of `npx mcp-remote`
- Gemini CLI OAuth: use `--transport http` and `httpUrl` instead of `npx mcp-remote`
- Gemini CLI Service Accounts: use `--transport http --header` and `httpUrl`/`headers` instead of mcp-remote with stdio args

Fixes https://linear.app/mixpanel/issue/GRO-107/update-mcp-docs-to-recommend-direct-connection
---
 docs/mcp.mdx | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/docs/mcp.mdx b/docs/mcp.mdx
index a29a638c..957d465d 100644
--- a/docs/mcp.mdx
+++ b/docs/mcp.mdx
@@ -152,7 +152,7 @@ codex mcp login mixpanel
 ### Gemini CLI
 
 ```bash
-gemini mcp add mixpanel npx -y mcp-remote https://mcp.mixpanel.com/mcp
+gemini mcp add --transport http mixpanel https://mcp.mixpanel.com/mcp
 ```
 
 Or edit `~/.gemini/settings.json` manually and add:
@@ -161,8 +161,7 @@ Or edit `~/.gemini/settings.json` manually and add:
 {
   "mcpServers": {
     "mixpanel": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.mixpanel.com/mcp"]
+      "httpUrl": "https://mcp.mixpanel.com/mcp"
     }
   }
 }
@@ -177,8 +176,7 @@ Or edit `~/.gemini/settings.json` manually and add:
 {
   "mcpServers": {
     "mixpanel": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.mixpanel.com/mcp"]
+      "url": "https://mcp.mixpanel.com/mcp"
     }
   }
 }
@@ -306,8 +304,7 @@ Service accounts are not supported through the Notion agent connector. Use [Curs
 ### Gemini CLI
 
 ```bash
-gemini mcp add mixpanel npx -y mcp-remote https://mcp.mixpanel.com/mcp \
-  --header "Authorization:Bearer Basic <base64-encoded-credentials>"
+gemini mcp add --transport http --header "Authorization: ****** <base64-encoded-credentials>" mixpanel https://mcp.mixpanel.com/mcp
 ```
 
 Or edit `~/.gemini/settings.json` manually and add (use the EU or IN URL if needed):
@@ -316,14 +313,9 @@ Or edit `~/.gemini/settings.json` manually and add (use the EU or IN URL if need
 {
   "mcpServers": {
     "mixpanel": {
-      "command": "npx",
-      "args": [
-        "-y", "mcp-remote",
-        "https://mcp.mixpanel.com/mcp",
-        "--header", "Authorization:${AUTH_HEADER}"
-      ],
-      "env": {
-        "AUTH_HEADER": "Bearer Basic <base64-encoded-credentials>"
+      "httpUrl": "https://mcp.mixpanel.com/mcp",
+      "headers": {
+        "Authorization": "****** <base64-encoded-credentials>"
       }
     }
   }