By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Perplexity to PostHog, create a personal API key in PostHog and connect it in a Ryze AI workspace with your host and project, then in Perplexity open Plugins, choose Add custom, Add MCP connector, Remote, and enter https://connector.get-ryze.ai/mcp with OAuth, Streamable HTTP and Public network access.
- In PostHog create a personal API key with the Query and Insight scopes and copy the phx_ key
- In Ryze AI open Integrations, click Connect on PostHog, paste the key, enter the host, pick the Project and save
- In Perplexity open Plugins, Add custom, Add MCP connector, Remote, and enter the name and URL
- Set Authentication to OAuth, tick the acknowledgement, click Add, then select the connector card to sign in to Ryze AI
Before you start
- A Perplexity plan that allows custom connectors. Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector by MCP server URL. In an Enterprise organization, members can add one for their own account only if an administrator turns on Allow members to add custom connectors (off by default). Only administrators can add organization-wide connectors.
- A PostHog personal API key. Ryze AI connects PostHog with a key that starts with phx_ and has read access to the projects you want, including the Query and Insight scopes. You also need the host of your instance: https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud, or your self-hosted URL.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Connecting the connector is free; the PostHog tools need an active plan or trial.
- Trust in the server. Perplexity's help center says to use only connectors from sources you trust, because Perplexity cannot verify third-party servers. Check who runs a server before you add it.
How to connect Perplexity to PostHog
Setup has two parts. PostHog is connected inside Ryze AI with an API key, then Perplexity is pointed at the Ryze AI connector. The Perplexity steps follow its help center for your own account. Ryze AI sign-in was not tested inside Perplexity while this page was written, so use the troubleshooting list below if a step differs on your screen.
Create a personal API key in PostHog
In PostHog go to Settings, then Personal API keys, and click Create key. Grant read access to the projects you want, including the Query and Insight scopes. Add write scopes only for objects you want Perplexity to change. Copy the key, which starts with phx_.
Connect PostHog in Ryze AI
Sign in to Ryze AI (or create an account), open Integrations, click Connect on the PostHog card and paste the key. Enter the Host (https://us.posthog.com, https://eu.posthog.com or your self-hosted URL) and click Continue. Pick the Project and click Save.
Open Plugins in Perplexity
Open Plugins in the sidebar. If Plugins is not shown, open Customize, then Connectors.
Add a remote MCP connector
Select Add custom, then Add MCP connector, and choose Remote. Enter the name Ryze AI and the MCP server URL https://connector.get-ryze.ai/mcp.
Set the advanced options
Under Advanced set Authentication to OAuth, Transport to Streamable HTTP and Network access to Public. Ryze AI supports dynamic client registration, so you enter no client ID or secret. Do not pick API Key: the form has no field for custom headers, and your PostHog key goes into Ryze AI instead.
Add the connector and sign in
Select the acknowledgement checkbox, then select Add. Select the connector card on the Plugins page to start the Ryze AI sign-in, choose the workspace that holds your PostHog connection and enable the connector.
Sources: Perplexity help: adding custom remote connectors, Perplexity changelog, March 13, 2026. The Ryze AI PostHog guide covers the API key and host fields on the Ryze AI side.
Enterprise organization setup
An Enterprise administrator can add the connector for the whole organization instead of each member adding it:
- Open Organization settings, then Connectors, and select Custom connector.
- Enter the name and URL, set the advanced options as above, select the acknowledgement checkbox and select Add.
- New organization connectors start turned off. Turn the connector on in Organization settings, then Connectors.
- Choose whether to authenticate once for the organization or require each member to sign in. The PostHog key sits in the Ryze AI workspace, so everyone who reaches that workspace through the connector uses the same key and its scopes.
Perplexity's help center also describes a Cloudflare Access network option and AWS PrivateLink for Enterprise. The Ryze AI connector is a public URL, so Public is the setting to use.
Local MCP and other surfaces
Local MCP servers and the Mac app
Perplexity's help center says local MCP servers work only in the Mac app. The Ryze AI connector is a remote server, so it uses the Plugins flow above and needs no local helper. A remote connector connected anywhere is connected for the account everywhere, including inside plugins.
Other Perplexity surfaces
This guide covers the web flow in Perplexity and the Enterprise organization flow. Ryze AI documents no other Perplexity surface, so this page gives no steps for them.
PostHog access and scopes
Perplexity reaches PostHog through two separate logins. The PostHog API key decides what the PostHog side may do. What the agent can change is limited by the scopes on the key.
- Personal API key
- Created in PostHog under Settings, Personal API keys. It needs read access to the wanted projects, including the Query and Insight scopes. Keep it to read scopes and PostHog rejects any change, which gives you a read-only connection.
- Write scopes
- Add write scopes only if Perplexity should create or edit insights, dashboards, feature flags or cohorts. What the agent can change is limited by the scopes on the key.
- Host and project
- The host is https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud or a self-hosted URL. One connection holds one PostHog project, which you pick after connecting.
- Perplexity connector settings
- Remote connectors in Perplexity take OAuth, API Key or None. Choose OAuth for Ryze AI. In an Enterprise organization an administrator controls who may add connectors and whether sign-in is shared or per member.
PostHog's API documentation lists the regional hosts and the rate limits for personal API keys. The Ryze AI help center page for PostHog describes the same key and host fields.
Sources: PostHog API docs.
Removing access
To remove access, delete the personal API key in PostHog, click View on the PostHog card in Ryze AI and disconnect with the trash icon, or remove the Ryze AI connector in Perplexity under Plugins.
What Perplexity can do in PostHog
The Ryze AI connector gives Perplexity 3 PostHog tools: 1 that reads, 1 that writes and 1 that deletes. Every call runs with the personal API key you connected in Ryze AI.
| Tool | Type | What it does |
|---|---|---|
| posthog__read | Read | Reads projects, insights, dashboards, feature flags, cohorts, persons and event definitions for the connected project, and runs HogQL analytics queries. |
| posthog__write | Write | Creates or updates PostHog objects such as insights, dashboards, feature flags and cohorts. |
| posthog__delete | Delete | Deletes a PostHog object by path, for example a cohort. The deletion is irreversible. |
Perplexity's connector help page does not say how it confirms write actions, so do not assume a confirmation step. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals, so approval there is a setting you choose. For a hard guarantee, connect a personal API key with read scopes only, because PostHog then rejects any change.
First 3 prompts to run
The prompts below describe what each one asks for. Answers come from your own PostHog project, so this page shows no sample numbers. PostHog stops unbounded HogQL queries, so name a time window and a row limit of 1,000 at most.
1. Funnel and event check
Using the Ryze AI connector, list the event definitions in my PostHog project, then run a HogQL query that counts the top 10 events over the last 14 days with a limit of 10 rows.
Tools used: posthog__read
What comes back: The event definitions for the connected project, followed by a short table of event names and counts for the window you named.
2. Review saved insights and dashboards
Using the Ryze AI connector, list my PostHog dashboards and the insights on each one, and point out insights whose names suggest they overlap.
Tools used: posthog__read
What comes back: A list of dashboards with their insights, read from the project. The overlap judgment comes from names only, so open any pair you want to merge.
3. Check a feature flag and a cohort
Using the Ryze AI connector, show the feature flags in my PostHog project with their current state, then list my cohorts.
Tools used: posthog__read
What comes back: Feature flags and cohorts for the connected project. Ask for a change only after you read the list, and name the exact flag or cohort.
Start with read prompts. Once you trust the setup and have added write scopes to the key, you can ask for changes such as a new insight, and name the object so the request is specific.
Ryze AI vs PostHog's own MCP server
PostHog runs its own MCP server, and it differs from the Ryze AI connector in sign-in and in what it covers.
| Option | Setup | PostHog coverage | Works in |
|---|---|---|---|
| Ryze AI connector | PostHog personal API key and host entered in Ryze AI, then the URL https://connector.get-ryze.ai/mcp as a remote connector in Perplexity with OAuth | 3 tools: read (including HogQL queries), write and delete for insights, dashboards, feature flags and cohorts in one project. US Cloud, EU Cloud or self-hosted | Perplexity remote connectors, plus Claude, ChatGPT and other MCP clients |
| PostHog MCP server | Server URL https://mcp.posthog.com/mcp. PostHog lists OAuth sign-in, which routes to your US or EU region, and also describes personal API keys sent as a Bearer header | Error tracking, analytics queries, feature flags, experiments, HogQL, CDP destinations, support tickets and semantic layer metrics. PostHog supports read-only mode and project pinning by header or query parameter | Clients PostHog lists, such as Claude Code, Claude Desktop, Cursor, Codex, VS Code and Windsurf. Perplexity is not on that list |
PostHog's server covers more PostHog features, so it fits if you work only inside PostHog and your client can reach it. Its documentation does not mention self-hosted deployments, and this page did not verify that Perplexity's connector form can sign in to it. The Perplexity form has no header field, so the Bearer key option would not apply there. The Ryze AI connector is the route confirmed for Perplexity, and it works with a self-hosted PostHog.
Sources: PostHog MCP server docs, PostHog MCP FAQ, Ryze AI PostHog guide. Checked November 14, 2026.
Errors and fixes
- Add MCP connector is missing in Perplexity
- Check your plan. Perplexity's changelog names Pro, Max and Enterprise for custom remote connectors. In an Enterprise organization, ask an administrator to turn on Allow members to add custom connectors, or to add the connector for the organization.
- PostHog rejects the key in Ryze AI
- Check that the key starts with phx_ and that the Host matches where your project lives: https://us.posthog.com, https://eu.posthog.com or your self-hosted URL. A mismatch between the key's region and the host is a common cause, so check both.
- The key connects but queries fail
- The key needs read access to the project with the Query and Insight scopes. Create a new key with those scopes, then reconnect PostHog in Ryze AI.
- A query is refused as unbounded
- PostHog stops unbounded HogQL queries. Ask Perplexity for a time window and a row limit of 1,000 at most.
- A change is rejected
- The key only has read scopes. Add write scopes for the object type in PostHog, or keep the connection read-only on purpose.
- The wrong project shows up
- One connection holds one project. Click View on the PostHog card in Ryze AI, disconnect with the trash icon and connect again, picking the right Project. Another project can live in another workspace.
- Sign-in fails with API Key selected
- Use OAuth. The Perplexity form has no field for custom request headers, and its documentation does not say which header the API Key option sends.
- Perplexity asks for a client ID and secret
- Perplexity asks for them only for OAuth servers without dynamic client registration. Ryze AI supports dynamic client registration, so leave them empty. If a server needs a redirect URL, Perplexity's is https://www.perplexity.ai/rest/connections/oauth_callback.
- PostHog tools do not appear in Perplexity
- If PostHog was connected in Ryze AI after you added the connector, remove the Ryze AI connector under Plugins, add it again and start a new thread.
- The Ryze AI connection link is refused
- The one-time connection link does not work while PostHog is already connected in the workspace. Switch projects or keys in the Ryze AI app.
- Perplexity says a subscription is required
- The tools sit behind an active Ryze AI plan or free trial. Start the trial, then ask again.
Frequently asked questions
How do I connect Perplexity to PostHog?
Create a personal API key in PostHog, then in Ryze AI open Integrations, click Connect on PostHog, paste the key, enter the host and pick the Project. Then in Perplexity open Plugins, Add custom, Add MCP connector, Remote, enter https://connector.get-ryze.ai/mcp, set Authentication to OAuth and select Add. Select the connector card to sign in.
Is there a Perplexity PostHog connector?
Perplexity lets Pro, Max and Enterprise subscribers add a custom remote MCP connector by URL, and the Ryze AI connector is one you can add that way. PostHog also runs its own MCP server at https://mcp.posthog.com/mcp, but PostHog does not list Perplexity among its clients and this page did not verify it there.
Which PostHog connector should I use with Perplexity?
Ryze AI is the best PostHog connector for Perplexity when you want HogQL queries and object changes in one thread through a URL that Perplexity can add, though it covers 3 tools for one project and needs a Ryze AI plan or trial. PostHog's own server covers more PostHog features but is not confirmed for Perplexity.
Which Perplexity plan do I need?
Perplexity's March 2026 changelog says Pro, Max and Enterprise subscribers can add a custom remote connector. In an Enterprise organization, members need an administrator to turn on Allow members to add custom connectors, which is off by default.
What PostHog access do I need?
A personal API key that starts with phx_ and has read access to the wanted projects, including the Query and Insight scopes, plus the host: https://us.posthog.com, https://eu.posthog.com or your self-hosted URL. Add write scopes only if Perplexity should make changes.
Can Perplexity change my PostHog project?
Yes, when the key has write scopes. Through Ryze AI it can create or update insights, dashboards, feature flags and cohorts, and delete those objects when you ask. Deletion is irreversible. Perplexity's connector help page does not describe a confirmation step, so name the exact objects in your request, or use a read-only key.
Can I make the connection read-only?
Yes. Create the personal API key with read scopes only. PostHog then rejects any change, whatever Perplexity asks for.
Does it work with EU Cloud and self-hosted PostHog?
Yes. Enter https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud or your self-hosted URL as the Host when you connect PostHog in Ryze AI.
Can I connect more than one PostHog project?
Each workspace holds one PostHog connection with one Project picked after connecting. To switch, click View on the card, disconnect with the trash icon and connect again. Another project can live in another workspace.
Why do the PostHog tools not show up in Perplexity?
If you connected PostHog in Ryze AI after adding the connector, remove the Ryze AI connector under Plugins, add it again and start a new thread. Also check that the Ryze AI workspace has an active plan or free trial.
How much does it cost to connect Perplexity to PostHog?
Adding the connector costs nothing, but the PostHog tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year. PostHog says connecting to its own MCP server is free, though some of its tools may bill as PostHog AI spend.
How do I disconnect PostHog from Perplexity?
Delete the Ryze AI connector in Perplexity under Plugins. To cut PostHog off at the source, disconnect it with the trash icon on the PostHog card in Ryze AI or delete the personal API key in PostHog.