:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
chore(infra): add mw and infra-dev Grafana regions to MCP helpers (#121926)
Michia3d43eb1b4b9
diff --git a/tools/infra-scripts/mcp/README.md b/tools/infra-scripts/mcp/README.mdindex 6a22cd65e60d..65ac203003da 100644--- a/tools/infra-scripts/mcp/README.md+++ b/tools/infra-scripts/mcp/README.md@@ -5,7 +5,7 @@ Scripts for connecting AI assistants (Claude Code, Cursor, etc.) to PostHog's in## Why these scripts existPostHog's Grafana instances are reachable directly over Tailscale at plain HTTP hostnames-(`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`).+(`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-dev`, `grafana-mw-prod-us`, `grafana-mw-prod-eu`, `grafana-infra-dev`, `grafana-infra-dev-wl`).Authentication is handled at the Grafana layer via a service account Bearer token,which the Grafana MCP server supports natively.@@ -47,7 +47,7 @@ The wrapper does not add a proxy, tunnel, or authentication bypass.## Prerequisites-- **Tailscale** connected, with access to the selected Grafana host (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, or `grafana-internal`)+- **Tailscale** connected, with access to the selected Grafana host (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-dev`, `grafana-mw-prod-us`, `grafana-mw-prod-eu`, `grafana-infra-dev`, or `grafana-infra-dev-wl`)- **mcp-grafana** binary installed- **macOS** (for Keychain-based token storage) or Linux with environment variables@@ -92,6 +92,11 @@ grafana-token us <your-us-token>grafana-token eu <your-eu-token>grafana-token dev <your-dev-token> # optionalgrafana-token internal <your-internal-token> # optional+grafana-token mw-dev <your-mw-dev-token> # optional+grafana-token mw-prod-us <your-mw-prod-us-token> # optional+grafana-token mw-prod-eu <your-mw-prod-eu-token> # optional+grafana-token infra-dev <your-infra-dev-token> # optional+grafana-token infra-dev-wl <your-infra-dev-wl-token> # optional```### 4. Configure your MCP client@@ -123,12 +128,17 @@ The wrapper script determines which Grafana region to connect to using (in orderRegion → host mapping:-| Region | Tailscale host |-| ---------- | ------------------------- |-| `us` | `http://grafana-prod-us` |-| `eu` | `http://grafana-prod-eu` |-| `dev` | `http://grafana-dev` |-| `internal` | `http://grafana-internal` |+| Region | Tailscale host |+| -------------- | ----------------------------- |+| `us` | `http://grafana-prod-us` |+| `eu` | `http://grafana-prod-eu` |+| `dev` | `http://grafana-dev` |+| `internal` | `http://grafana-internal` |+| `mw-dev` | `http://grafana-mw-dev` |+| `mw-prod-us` | `http://grafana-mw-prod-us` |+| `mw-prod-eu` | `http://grafana-mw-prod-eu` |+| `infra-dev` | `http://grafana-infra-dev` |+| `infra-dev-wl` | `http://grafana-infra-dev-wl` |#### Single-server setup (switching regions manually)@@ -140,6 +150,7 @@ grafana-region us # Switch to prod-us (us-east-1)grafana-region eu # Switch to prod-eu (eu-central-1)grafana-region dev # Switch to dev environmentgrafana-region internal # Switch to internal environment+grafana-region mw-dev # Switch to mw-dev (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)```**Important: Restart required after switching regions**@@ -189,6 +200,7 @@ To add internal alongside those servers, add a `grafana-internal` entry to `mcpS```Store its token with `grafana-token internal <your-internal-token>`, then restart your MCP client.+The `mw-dev`, `mw-prod-us`, `mw-prod-eu`, `infra-dev`, and `infra-dev-wl` regions work the same way: set `GRAFANA_REGION` to the region and store its token with `grafana-token <region> <token>`.Supported regions are explicit so each selection maps to a known host and its own Keychain token.#### Migrating from single-server to multi-server@@ -233,7 +245,7 @@ You may want to use a secrets manager or encrypted file for production use.### Hostname doesn't resolve / connection refused-The Tailscale hostnames (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`) only resolve when Tailscale is connected to the PostHog tailnet. Check with:+The Tailscale hostnames (`grafana-prod-us`, `grafana-prod-eu`, `grafana-dev`, `grafana-internal`, `grafana-mw-*`, `grafana-infra-dev*`) only resolve when Tailscale is connected to the PostHog tailnet. Check with:```bashtailscale statusdiff --git a/tools/infra-scripts/mcp/grafana-region b/tools/infra-scripts/mcp/grafana-regionindex 4c6bf1ce6e83..356a47dd3e8a 100755--- a/tools/infra-scripts/mcp/grafana-region+++ b/tools/infra-scripts/mcp/grafana-region@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Switch Grafana MCP server between prod-us, prod-eu, dev, and internal+# Switch Grafana MCP server between prod-us, prod-eu, dev, internal, mw-dev, mw-prod-us, mw-prod-eu, infra-dev, and infra-dev-wl## Usage:# grafana-region # Show current region@@ -7,6 +7,7 @@# grafana-region eu # Switch to prod-eu# grafana-region dev # Switch to dev# grafana-region internal # Switch to internal+# grafana-region mw-dev # Switch to mw-dev (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)## After switching, restart your MCP client (e.g., Claude Code: /exit)@@ -14,7 +15,7 @@ REGION_FILE="$HOME/.grafana-region"show_current() {if [ -f "$REGION_FILE" ] && [ -s "$REGION_FILE" ]; then- local region=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]')+ local region=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]-')echo "Current Grafana region: $region"elseecho "Current Grafana region: us (default)"@@ -22,14 +23,19 @@ show_current() {}show_usage() {- echo "Usage: grafana-region [us|eu|dev|internal]"+ echo "Usage: grafana-region [us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl]"echo ""echo "Commands:"- echo " (no args) Show current region"- echo " us Switch to prod-us (us-east-1)"- echo " eu Switch to prod-eu (eu-central-1)"- echo " dev Switch to dev (us-east-1)"- echo " internal Switch to internal"+ echo " (no args) Show current region"+ echo " us Switch to prod-us (us-east-1)"+ echo " eu Switch to prod-eu (eu-central-1)"+ echo " dev Switch to dev (us-east-1)"+ echo " internal Switch to internal"+ echo " mw-dev Switch to mw-dev"+ echo " mw-prod-us Switch to mw-prod-us"+ echo " mw-prod-eu Switch to mw-prod-eu"+ echo " infra-dev Switch to infra-dev"+ echo " infra-dev-wl Switch to infra-dev-wl"echo ""echo "After switching, restart your MCP client to apply the change."}@@ -38,7 +44,7 @@ case "${1:-}" in"")show_current;;- us|eu|dev|internal)+ us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)echo "$1" > "$REGION_FILE"echo "Switched Grafana region to: $1"echo ""@@ -48,7 +54,7 @@ case "${1:-}" inshow_usage;;*)- echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', or 'internal'." >&2+ echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2echo ""show_usageexit 1diff --git a/tools/infra-scripts/mcp/grafana-token b/tools/infra-scripts/mcp/grafana-tokenindex 8d011c2822a9..5731a43d38aa 100755--- a/tools/infra-scripts/mcp/grafana-token+++ b/tools/infra-scripts/mcp/grafana-token@@ -7,10 +7,12 @@# grafana-token eu # Show if EU token exists# grafana-token dev # Show if dev token exists# grafana-token internal # Show if internal token exists+# grafana-token mw-dev # Show if mw-dev token exists# grafana-token us <token> # Set prod-us token# grafana-token eu <token> # Set prod-eu token# grafana-token dev <token> # Set dev token# grafana-token internal <token> # Set internal token+# grafana-token mw-dev <token> # Set mw-dev token (same for mw-prod-us, mw-prod-eu, infra-dev, infra-dev-wl)## Note: This script requires macOS (uses Keychain).# On Linux, set the GRAFANA_SERVICE_ACCOUNT_TOKEN environment variable instead.@@ -51,35 +53,53 @@ show_status() {elseecho " internal: not configured"fi++ for region in mw-dev mw-prod-us mw-prod-eu infra-dev infra-dev-wl; do+ if security find-generic-password -a "$USER" -s "grafana-service-account-token-$region" &>/dev/null; then+ printf " %-14s configured\n" "$region:"+ else+ printf " %-14s not configured\n" "$region:"+ fi+ done}show_usage() {- echo "Usage: grafana-token [us|eu|dev|internal] [token]"+ echo "Usage: grafana-token [us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl] [token]"echo ""echo "Commands:"- echo " (no args) Show token status for all regions"- echo " us Show if US token is configured"- echo " eu Show if EU token is configured"- echo " dev Show if dev token is configured"- echo " internal Show if internal token is configured"- echo " us <token> Set prod-us token"- echo " eu <token> Set prod-eu token"- echo " dev <token> Set dev token"- echo " internal <token> Set internal token"+ echo " (no args) Show token status for all regions"+ echo " us Show if US token is configured"+ echo " eu Show if EU token is configured"+ echo " dev Show if dev token is configured"+ echo " internal Show if internal token is configured"+ echo " mw-dev Show if mw-dev token is configured"+ echo " mw-prod-us Show if mw-prod-us token is configured"+ echo " mw-prod-eu Show if mw-prod-eu token is configured"+ echo " infra-dev Show if infra-dev token is configured"+ echo " infra-dev-wl Show if infra-dev-wl token is configured"+ echo " us <token> Set prod-us token"+ echo " eu <token> Set prod-eu token"+ echo " dev <token> Set dev token"+ echo " internal <token> Set internal token"+ echo " mw-dev <token> Set mw-dev token"+ echo " mw-prod-us <token> Set mw-prod-us token"+ echo " mw-prod-eu <token> Set mw-prod-eu token"+ echo " infra-dev <token> Set infra-dev token"+ echo " infra-dev-wl <token> Set infra-dev-wl token"echo ""echo "After setting a token, restart your MCP client to pick it up."echo ""echo "To create a service account token in Grafana:"- echo " 1. Go to Administration > Service accounts"- echo " 2. Create a new service account or use an existing one"- echo " 3. Add a token with appropriate permissions"+ echo " 1. Go to Administration > Service accounts"+ echo " 2. Create a new service account or use an existing one"+ echo " 3. Add a token with appropriate permissions"}case "${1:-}" in"")show_status;;- us|eu|dev|internal)+ us|eu|dev|internal|mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)REGION="$1"SERVICE="grafana-service-account-token-$REGION"@@ -119,7 +139,7 @@ case "${1:-}" inshow_usage;;*)- echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', or 'internal'." >&2+ echo "Error: Invalid region '$1'. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2echo ""show_usageexit 1diff --git a/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh b/tools/infra-scripts/mcp/mcp-grafana-wrapper.shindex 711d1e2ebcd4..3a4aad7e4024 100755--- a/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh+++ b/tools/infra-scripts/mcp/mcp-grafana-wrapper.sh@@ -2,10 +2,13 @@# Wrapper script for mcp-grafana that connects to PostHog Grafana via Tailscale.## PostHog's Grafana instances are reachable over Tailscale at plain HTTP hostnames-# (grafana-prod-us, grafana-prod-eu, grafana-dev, grafana-internal). This wrapper looks up a service+# (grafana-prod-us, grafana-prod-eu, grafana-dev, grafana-internal, grafana-mw-dev,+# grafana-mw-prod-us, grafana-mw-prod-eu, grafana-infra-dev, grafana-infra-dev-wl). This wrapper looks up a service# account token from macOS Keychain and hands both the URL and token to mcp-grafana.#-# Supports switching between prod-us, prod-eu, dev, and internal via GRAFANA_REGION env var+# Supports switching between prod-us, prod-eu, dev, internal, mw-dev, mw-prod-us, mw-prod-eu,+# infra-dev, and infra-dev-wl+# via GRAFANA_REGION env var# or ~/.grafana-region file (env var takes precedence). Use `grafana-region <region>`# to switch, then restart your MCP client.#@@ -22,7 +25,7 @@ DEFAULT_REGION="us"# Read current region (default to us if file missing or empty)if [ -f "$REGION_FILE" ] && [ -s "$REGION_FILE" ]; then- CURRENT_REGION=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]')+ CURRENT_REGION=$(head -n1 "$REGION_FILE" | tr -cd '[:alnum:]-')elseCURRENT_REGION="$DEFAULT_REGION"fi@@ -34,12 +37,6 @@ if [ -n "${GRAFANA_REGION:-}" ]; thenREGION_SOURCE="GRAFANA_REGION env var"fi-# Validate region-if [[ "$CURRENT_REGION" != "us" && "$CURRENT_REGION" != "eu" && "$CURRENT_REGION" != "dev" && "$CURRENT_REGION" != "internal" ]]; then- echo "Error: Invalid region '$CURRENT_REGION' from $REGION_SOURCE. Must be 'us', 'eu', 'dev', or 'internal'." >&2- exit 1-fi-# Region-specific configurationcase "$CURRENT_REGION" inus)@@ -58,6 +55,14 @@ case "$CURRENT_REGION" inGRAFANA_HOST="grafana-internal"KEYCHAIN_SERVICE="grafana-service-account-token-internal";;+ mw-dev|mw-prod-us|mw-prod-eu|infra-dev|infra-dev-wl)+ GRAFANA_HOST="grafana-$CURRENT_REGION"+ KEYCHAIN_SERVICE="grafana-service-account-token-$CURRENT_REGION"+ ;;+ *)+ echo "Error: Invalid region '$CURRENT_REGION' from $REGION_SOURCE. Must be 'us', 'eu', 'dev', 'internal', 'mw-dev', 'mw-prod-us', 'mw-prod-eu', 'infra-dev', or 'infra-dev-wl'." >&2+ exit 1+ ;;esac# Find mcp-grafana binary