Skip to content

: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.

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.yml
index 05d92c30fd49..6ffcfccfe329 100644
--- a/frontend/snapshots.yml
+++ b/frontend/snapshots.yml
@@ -1908,6 +1908,14 @@ snapshots:
hash: v1.k794b7964.7adaad1e91b71d0b933afe541a20fd43112e39d56d6638abadfae6a830bb0c15.TxnbKwXIG1XbB5e4KpRJa4-PA-wl-kKOWbtX1ERVqLU
components-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.GUMmYHl2A9KpkmV3yDJfircUAJlr6RSFPGSRmV1ATXY
components-navpanelproductpush--all-products--dark:
hash: v1.k794b7964.d6cc4da0e30950f4e3bf7338d86856529e48c45785bae5a85ccf4fd3ed7c3ad0.8n61Z9x6l3I3qfdAzk46yr7fAFHoYNdo3tjEKyJlcIo
components-navpanelproductpush--all-products--light:
diff --git a/frontend/src/lib/components/CommandBlock/CommandBlock.tsx b/frontend/src/lib/components/CommandBlock/CommandBlock.tsx
index 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)
+ : command
const 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]')}>
<code
className={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 && (
<code
key={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.tsx
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
index 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 dashboards
export const NAV_PANEL_CARD_TYPE = {
BROADCAST: 'broadcast',
+ MCP_CONNECT: 'mcp_connect',
PRODUCT_PUSH: 'product_push',
} as const