docs: tighten setup prompt + measure the copy button

RhysSullivan · RhysSullivan · commit 164792dcc7a6 · 2026-06-22T14:50:31.000-07:00
Prompt (marketing + docs): note that MCP clients load servers at startup, so the user likely needs to restart their client or open a new chat before Executor tools appear, and recommend Executor Cloud as the fastest path. Marketing: complete the scaffolded PostHog wiring (gated on PUBLIC_POSTHOG_KEY, first-party proxied, autocapture and pageviews off) and capture a marketing_setup_prompt_copied event when the prompt is copied.
diff --git a/apps/docs/index.mdx b/apps/docs/index.mdx
@@ -28,7 +28,7 @@ Help me set up Executor and get my first connection working.
 
 Executor is an open source integration layer for AI agents: one place to configure every integration (MCP servers, OpenAPI specs, GraphQL APIs) and connect to them over MCP.
 
-Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. All forms expose the same functionality, just packaged differently:
+Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. If I just want the fastest path, suggest Executor Cloud (free tier, nothing to install). All forms expose the same functionality, just packaged differently:
 
 Local (everything stays on my machine):
 - Desktop app: a native app for Mac, Windows, and Linux. Best for a regular desktop environment.
@@ -50,8 +50,8 @@ Terms you'll come across:
 
 Once you know which form I want:
 1. Walk me through installing it.
-2. Connect Executor to you over MCP.
-3. Help me add my first integration and get one tool working end to end.
+2. Connect Executor to you over MCP. Most MCP clients only load servers at startup, so after adding it I may need to restart the client or open a new chat before the Executor tools appear. Tell me if that's needed and wait for me to do it before continuing.
+3. Once the tools are available, help me add my first integration and get one tool working end to end.
 
 Docs: https://executor.sh/docs
 Source (and the place to start if something breaks): https://github.com/RhysSullivan/executor
diff --git a/apps/marketing/src/layouts/Layout.astro b/apps/marketing/src/layouts/Layout.astro
@@ -45,5 +45,31 @@ const canonical = new URL(Astro.url.pathname, Astro.site ?? Astro.url).toString(
   </head>
   <body class="antialiased">
     <slot />
+    <script>
+      // Gated PostHog init. Runs only when PUBLIC_POSTHOG_KEY is set in the
+      // deploy env, so it's a no-op in dev / unconfigured builds (and the SDK
+      // isn't even shipped, thanks to the dynamic import). Events are proxied
+      // first-party through src/middleware.ts to survive adblockers.
+      // autocapture and pageviews are off on purpose: we only send the explicit
+      // events the page fires (e.g. the "Set up with your agent" copy). Flip
+      // capture_pageview on if you want a denominator for conversion.
+      const phKey = import.meta.env.PUBLIC_POSTHOG_KEY;
+      if (phKey) {
+        const phPath = (import.meta.env.PUBLIC_ANALYTICS_PATH ?? "a").replace(
+          /^\/+|\/+$/g,
+          "",
+        );
+        void import("posthog-js").then(({ default: posthog }) => {
+          posthog.init(phKey, {
+            api_host: `${window.location.origin}/api/${phPath}`,
+            ui_host: import.meta.env.PUBLIC_POSTHOG_HOST ?? "https://us.posthog.com",
+            autocapture: false,
+            capture_pageview: false,
+            persistence: "localStorage",
+          });
+          Object.assign(window, { posthog });
+        });
+      }
+    </script>
   </body>
 </html>
diff --git a/apps/marketing/src/pages/index.astro b/apps/marketing/src/pages/index.astro
@@ -12,7 +12,7 @@ const setupPrompt = `Help me set up Executor and get my first connection working
 
 Executor is an open source integration layer for AI agents: one place to configure every integration (MCP servers, OpenAPI specs, GraphQL APIs) and connect to them over MCP.
 
-Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. All forms expose the same functionality, just packaged differently:
+Start by helping me pick the right form to run it in. Chat with me about it rather than jumping straight to a yes/no question, and recommend one. If I just want the fastest path, suggest Executor Cloud (free tier, nothing to install). All forms expose the same functionality, just packaged differently:
 
 Local (everything stays on my machine):
 - Desktop app: a native app for Mac, Windows, and Linux. Best for a regular desktop environment.
@@ -34,8 +34,8 @@ Terms you'll come across:
 
 Once you know which form I want:
 1. Walk me through installing it.
-2. Connect Executor to you over MCP.
-3. Help me add my first integration and get one tool working end to end.
+2. Connect Executor to you over MCP. Most MCP clients only load servers at startup, so after adding it I may need to restart the client or open a new chat before the Executor tools appear. Tell me if that's needed and wait for me to do it before continuing.
+3. Once the tools are available, help me add my first integration and get one tool working end to end.
 
 Docs: https://executor.sh/docs
 Source (and the place to start if something breaks): https://github.com/RhysSullivan/executor`;
@@ -204,6 +204,7 @@ Source (and the place to start if something breaks): https://github.com/RhysSull
                 type="button"
                 class="btn-secondary copy-btn"
                 data-copy={setupPrompt}
+                data-event="marketing_setup_prompt_copied"
               >
                 Set up with your agent
                 <span class="copy-icons" aria-hidden="true">
@@ -439,6 +440,16 @@ Source (and the place to start if something breaks): https://github.com/RhysSull
         try {
           await navigator.clipboard.writeText(text);
           btn.dataset.copied = "true";
+          const event = btn.dataset.event;
+          if (event) {
+            (
+              window as unknown as {
+                posthog?: {
+                  capture: (e: string, p?: Record<string, unknown>) => void;
+                };
+              }
+            ).posthog?.capture(event, { surface: "marketing_hero" });
+          }
         } catch {
           btn.dataset.copied = "false";
         }
