: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
feat(growth): add a sidebar card that asks users to connect the mcp (#118247)
Rafael Audibertb47396dfdf1a
diff --git a/frontend/snapshots.yml b/frontend/snapshots.ymlindex 05d92c30fd49..6ffcfccfe329 100644--- a/frontend/snapshots.yml+++ b/frontend/snapshots.yml@@ -1908,6 +1908,14 @@ snapshots:hash: v1.k794b7964.7adaad1e91b71d0b933afe541a20fd43112e39d56d6638abadfae6a830bb0c15.TxnbKwXIG1XbB5e4KpRJa4-PA-wl-kKOWbtX1ERVqLUcomponents-message-tool-calls-editor--editable-tool-calls--light:hash: v1.k794b7964.4a10839159f5b3f989112539bb2a720f04460890fae5914a3516457e7cba92f3.Snir6e_iAMVVl1tdItfy70BRcAHw5Zem9Kk0ujjMQIo+ components-navpanelmcpad--not-connected--dark:+ hash: v1.k794b7964.704819a375969f766b8dec0d21588c27aaab2bc811b94b191727b95df8748c09.Ej5UHe0Fu_Nb_S0DDqZOw37Lc1qDALEN1Oo_PHQB_Oc+ components-navpanelmcpad--not-connected--light:+ hash: v1.k794b7964.6b7bcdcbd722e9a91f36207e3f74a7fcc6bcc12839c37edd38170c9c448df872._bRFkSRl0DNIZ8z0MdlZGIZbLvlwAV55XLr4W3wbn60+ components-navpanelmcpad--not-connected-narrow-sidebar--dark:+ hash: v1.k794b7964.ba80c959f1550045d79414b44d74c32f73409ee72b47c784d8b7c162d761a5f5.ByHZ3_-05n_pwZXB1wOAMunF7Wkw6Y7G-l2GtuYFnHY+ components-navpanelmcpad--not-connected-narrow-sidebar--light:+ hash: v1.k794b7964.ef30728718218a74fc89dc3fb2f77cac633c9801df3ba459f468b1b8e7cdd51e.GUMmYHl2A9KpkmV3yDJfircUAJlr6RSFPGSRmV1ATXYcomponents-navpanelproductpush--all-products--dark:hash: v1.k794b7964.d6cc4da0e30950f4e3bf7338d86856529e48c45785bae5a85ccf4fd3ed7c3ad0.8n61Z9x6l3I3qfdAzk46yr7fAFHoYNdo3tjEKyJlcIocomponents-navpanelproductpush--all-products--light:diff --git a/frontend/src/lib/components/CommandBlock/CommandBlock.tsx b/frontend/src/lib/components/CommandBlock/CommandBlock.tsxindex 4d5e157966be..78563f479a04 100644--- a/frontend/src/lib/components/CommandBlock/CommandBlock.tsx+++ b/frontend/src/lib/components/CommandBlock/CommandBlock.tsx@@ -47,6 +47,8 @@ interface CommandBlockProps {/** Hide noise (`-y` flags, `@latest` version pins, `--project-id` targeting) from the* displayed text to keep the block compact. The full `command` is still what gets copied. */condensed?: boolean+ /** Show the command split over these lines, for a narrow column. The copy is still `command`. */+ displayLines?: string[]}/** Strips display noise (`-y`, `@latest`, `--project-id=N`) from a command; copy the original, show this. */@@ -67,12 +69,21 @@ export function CommandBlock({onCopy,silentCopy = false,condensed = false,+ displayLines,}: CommandBlockProps): JSX.Element {const [copyKey, setCopyKey] = useState(0)const buttonRef = useRef<HTMLButtonElement>(null)const sizeStyle = SIZE_STYLES[size]const isStorybook = inStorybook() || inStorybookTestRunner()- const displayCommand = condensed ? condenseCommand(command) : command+ const displayCommand = displayLines+ ? displayLines.map((line) => (+ <span key={line} className="block">+ {line}+ </span>+ ))+ : condensed+ ? condenseCommand(command)+ : commandconst handleCopy = (): void => {void copyToClipboard(command, copyLabel, { silent: silentCopy })@@ -100,10 +111,14 @@ export function CommandBlock({type="button"aria-label={ariaLabel}>- <IconTerminal className={cn(sizeStyle.icon, 'text-muted')} />- <span className="relative">+ {/* A narrow column needs the width for the command more than for the terminal icon. */}+ {!displayLines && <IconTerminal className={cn(sizeStyle.icon, 'text-muted')} />}+ <span className={cn('relative', displayLines && 'min-w-0 [overflow-wrap:anywhere]')}><codeclassName={cn('!bg-transparent !p-0 !border-0 select-all', {+ // The rainbow gradient is clipped to the text of this element, which an inline+ // box cannot paint across block-level lines.+ 'inline-block': !!displayLines,'text-default': decoration === 'plain','rainbow-text': decoration === 'rainbow','rainbow-text-animating': decoration === 'rainbow' && !isStorybook,@@ -114,7 +129,9 @@ export function CommandBlock({{copyKey > 0 && (<codekey={copyKey}- className="CommandBlock__flash !bg-transparent !p-0 !border-0"+ className={cn('CommandBlock__flash !bg-transparent !p-0 !border-0', {+ 'inline-block': !!displayLines,+ })}aria-hidden="true">{displayCommand}diff --git a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelAdvertisement.tsx b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelAdvertisement.tsxindex ad66c42a3466..e6b6cc38af38 100644--- a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelAdvertisement.tsx+++ b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelAdvertisement.tsx@@ -9,6 +9,7 @@ import { panelLayoutLogic } from '~/layout/panel-layout/panelLayoutLogic'import { BroadcastPayload, isBroadcastPayload } from './navPanelAdShared'import { NavPanelBroadcastAd } from './NavPanelBroadcastAd'+import { NavPanelMcpAd } from './NavPanelMcpAd'import { NavPanelProductPushAd } from './NavPanelProductPushAd'import { navPanelProductPushLogic } from './navPanelProductPushLogic'@@ -38,5 +39,10 @@ export function NavPanelAdvertisement(): JSX.Element | null {return <NavPanelProductPushAd campaign={activeCampaign} />}+ // Fills the gaps between campaigns. The MCP server only serves cloud and dev instances.+ if (isCloudOrDev && user) {+ return <NavPanelMcpAd />+ }+return null}diff --git a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.stories.tsx b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.stories.tsxnew file mode 100644index 000000000000..ccac34dcced1--- /dev/null+++ b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.stories.tsx@@ -0,0 +1,30 @@+import type { Meta, StoryObj } from '@storybook/react'++import { mswDecorator } from '~/mocks/browser'++import { NavPanelMcpAd } from './NavPanelMcpAd'++const meta = {+ title: 'Components/NavPanelMcpAd',+ parameters: { layout: 'padded' },+ decorators: [mswDecorator({ get: { '/api/oauth/connected-apps/': [] } })],+} satisfies Meta++export default meta+type Story = StoryObj<{}>++// The card's width in the sidebar at its default width (215px) and at its minimum (160px).+const notConnectedStory = (width: string): Story => ({+ render: (): JSX.Element => (+ <div className={width}>+ <NavPanelMcpAd />+ </div>+ ),+ parameters: {+ testOptions: { waitForSelector: '[aria-label="Copy MCP install command"]' },+ },+})++export const NotConnected: Story = notConnectedStory('w-[199px]')++export const NotConnectedNarrowSidebar: Story = notConnectedStory('w-[144px]')diff --git a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.test.tsx b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.test.tsxnew file mode 100644index 000000000000..dc3318af0204--- /dev/null+++ b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.test.tsx@@ -0,0 +1,67 @@+import '@testing-library/jest-dom'++import { cleanup, render, screen, waitFor } from '@testing-library/react'+import { Provider } from 'kea'++import { agentConnectionLogic } from 'lib/components/MCPHint/agentConnectionLogic'++import type { ConnectedAppApi } from '~/generated/core/api.schemas'+import { useMocks } from '~/mocks/jest'+import { initKeaTests } from '~/test/init'++import { navPanelAdvertisementLogic } from './NavPanelAdvertisementLogic'+import { NavPanelMcpAd } from './NavPanelMcpAd'+import { MCP_AD_LOGIC_PROPS } from './NavPanelMcpCard'++const AGENT_APP: ConnectedAppApi = {+ id: 'agent',+ name: 'Claude Code',+ logo_uri: null,+ scopes: ['openid'],+ authorized_at: '2026-06-18T00:00:00Z',+ is_verified: false,+ is_first_party: false,+ requires_access_confirmation: false,+ is_self_registered: true,+}++describe('NavPanelMcpAd', () => {+ afterEach(() => {+ cleanup()+ })++ it.each([+ ['no agent connected', [200, []], false, 1, true],+ ['an agent connected', [200, [AGENT_APP]], false, 1, false],+ ['a failed lookup', [500, { detail: 'boom' }], false, 1, false],+ ['a dismissed card', [200, []], true, 0, false],+ ] as const)('with %s', async (_, response, dismissed, expectedRequests, shown) => {+ let requests = 0+ useMocks({+ get: {+ '/api/oauth/connected-apps/': () => {+ requests += 1+ return response+ },+ },+ })+ initKeaTests()+ if (dismissed) {+ const dismissLogic = navPanelAdvertisementLogic(MCP_AD_LOGIC_PROPS)+ dismissLogic.mount()+ dismissLogic.actions.hideAdvertisement()+ }++ render(+ <Provider>+ <NavPanelMcpAd />+ </Provider>+ )++ await waitFor(() => expect(requests).toBe(expectedRequests))+ await waitFor(() =>+ expect(agentConnectionLogic.findMounted()?.values.connectedAppsLoading ?? false).toBe(false)+ )+ expect(screen.queryByText('Connect your AI agent') !== null).toBe(shown)+ })+})diff --git a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.tsx b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.tsxnew file mode 100644index 000000000000..8e0ff9119811--- /dev/null+++ b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpAd.tsx@@ -0,0 +1,11 @@+import { useValues } from 'kea'++import { navPanelAdvertisementLogic } from './NavPanelAdvertisementLogic'+import { MCP_AD_LOGIC_PROPS, NavPanelMcpCard } from './NavPanelMcpCard'++/** Asks users whose agent has not connected to connect the PostHog MCP server. */+export function NavPanelMcpAd(): JSX.Element | null {+ const { hidden } = useValues(navPanelAdvertisementLogic(MCP_AD_LOGIC_PROPS))+ // Checked before the connection lookup mounts, so a dismissed card never fetches connected apps.+ return hidden ? null : <NavPanelMcpCard />+}diff --git a/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpCard.tsx b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpCard.tsxnew file mode 100644index 000000000000..2d251e48e843--- /dev/null+++ b/frontend/src/lib/components/NavPanelAdvertisement/NavPanelMcpCard.tsx@@ -0,0 +1,70 @@+import { BindLogic, useValues } from 'kea'+import posthog from 'posthog-js'+import { useEffect } from 'react'++import * as wizardPng from '@posthog/brand/hoggies/png/wizard-1'++import { pngHoggie } from 'lib/brand/hoggies'+import { CommandBlock } from 'lib/components/CommandBlock/CommandBlock'+import { agentConnectionLogic } from 'lib/components/MCPHint/agentConnectionLogic'+import { MCP_INSTALL_COMMAND } from 'lib/components/MCPHint/constants'++import { AdvertisementCard, NAV_PANEL_CARD_TYPE, ProductPushDisplay } from './navPanelAdShared'+import { navPanelAdvertisementLogic } from './NavPanelAdvertisementLogic'++export const MCP_AD_LOGIC_PROPS = { dismissKey: 'mcp-connect' }++const MCP_HERO: ProductPushDisplay = {+ Hoggie: pngHoggie(wizardPng),+ accentColor: 'var(--color-accent)',+ tagline: '',+}++export function NavPanelMcpCard(): JSX.Element | null {+ const { hasConnectedAgent } = useValues(agentConnectionLogic)+ // `null` means no lookup has succeeded, which never counts as eligible.+ const shouldShow = hasConnectedAgent === false++ useEffect(() => {+ if (shouldShow) {+ posthog.capture('nav panel mcp card shown', { card_type: NAV_PANEL_CARD_TYPE.MCP_CONNECT })+ }+ }, [shouldShow])++ if (!shouldShow) {+ return null+ }++ return (+ <BindLogic logic={navPanelAdvertisementLogic} props={MCP_AD_LOGIC_PROPS}>+ <AdvertisementCard+ title="Connect your AI agent"+ hero={MCP_HERO}+ text={+ <span className="flex flex-col items-start gap-2">+ <span>+ Let Claude Code, Cursor, or Codex work with your PostHog data. Run this in your terminal:+ </span>+ <CommandBlock+ command={MCP_INSTALL_COMMAND}+ displayLines={['npx @posthog/wizard', 'mcp add']}+ copyLabel="MCP install command"+ ariaLabel="Copy MCP install command"+ size="sm"+ decoration="rainbow"+ className="bg-surface-secondary border border-primary !m-0 max-w-full text-[11px] hover:border-accent"+ onCopy={() =>+ posthog.capture('nav panel mcp card command copied', {+ card_type: NAV_PANEL_CARD_TYPE.MCP_CONNECT,+ })+ }+ />+ </span>+ }+ onClose={() => {+ posthog.capture('nav panel mcp card dismissed', { card_type: NAV_PANEL_CARD_TYPE.MCP_CONNECT })+ }}+ />+ </BindLogic>+ )+}diff --git a/frontend/src/lib/components/NavPanelAdvertisement/navPanelAdShared.tsx b/frontend/src/lib/components/NavPanelAdvertisement/navPanelAdShared.tsxindex a62822ccc254..2f3174214c5d 100644--- a/frontend/src/lib/components/NavPanelAdvertisement/navPanelAdShared.tsx+++ b/frontend/src/lib/components/NavPanelAdvertisement/navPanelAdShared.tsx@@ -18,6 +18,7 @@ import { navPanelAdvertisementLogic } from './NavPanelAdvertisementLogic'// pinned: analytics property values — renaming breaks dashboardsexport const NAV_PANEL_CARD_TYPE = {BROADCAST: 'broadcast',+ MCP_CONNECT: 'mcp_connect',PRODUCT_PUSH: 'product_push',} as const