By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect ChatGPT to PostHog, save a PostHog personal API key and host in a Ryze AI workspace, then add https://connector.get-ryze.ai/mcp as a custom MCP server in ChatGPT Plugins with OAuth, allow the workspace and start a new conversation.
- In PostHog create a personal API key with read access and the Query and Insight scopes
- In Ryze AI open Integrations, click Connect on PostHog, paste the key, enter the host and pick the project
- In ChatGPT open Plugins, add a custom MCP server with the URL and OAuth
- Sign in to Ryze AI, click Allow connection, install the plugin and start a new conversation
Before you start
- A ChatGPT plan that allows custom MCP servers. OpenAI states that custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise/Edu customers on the web. Pro users can connect custom MCP servers with read and fetch permissions only. OpenAI's article does not mention Free, Go or Plus. On Business only admins and owners can create and publish plugins for custom MCP servers; on Enterprise/Edu admins and owners can, and admins can grant other members permission through RBAC.
- A PostHog personal API key. The key starts with phx_ and needs read access to the project you want, including the Query and Insight scopes. Add write scopes only if ChatGPT should change objects. You also need the host: 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; Agency ($279 per month) and SEO Starter ($129 per month, 3-day free trial) also work. Connecting is free. Without a plan the connector can only list workspaces and connect platforms, so the PostHog tools stay unavailable.
How to connect ChatGPT to PostHog with Plugins
Steps 1 to 3 happen in PostHog and Ryze AI, steps 4 to 6 in ChatGPT on the web. The connector URL is the same for every user.
Create a personal API key in PostHog
In PostHog go to Settings, Personal API keys and click Create key. Grant read access to the projects you want, with the Query and Insight scopes. Add write scopes only for the objects ChatGPT should change. Copy the phx_ key.
Connect PostHog in Ryze AI
In the Ryze AI app open Integrations, click Connect on the PostHog card, paste the key, enter the host (US Cloud, EU Cloud or your self-hosted URL) and click Continue. Pick the Project and click Save.
Open Plugins in ChatGPT and add the server
On the ChatGPT web app go to Plugins (chatgpt.com/plugins), select the plus button and choose Add custom MCP server. Enter the name Ryze AI, then under Connection enter the public URL https://connector.get-ryze.ai/mcp. Developer Mode does not need to be turned on first, though account and workspace policies still apply.
Choose OAuth and create the plugin
Configure authentication as OAuth. ChatGPT shows a risk warning; select I understand and want to continue, then Create as a plugin and review the tools it discovered.
Sign in to Ryze AI and allow the workspace
When ChatGPT asks, sign in to Ryze AI, choose the workspace that holds your PostHog connection and click Allow connection. One connection can cover up to 20 workspaces.
Install the plugin and start a new conversation
Install the plugin, open a new conversation, type @ and select Ryze AI. Then ask your first question, for example: List the dashboards in my PostHog project.
The Ryze AI help center PostHog article covers the PostHog side of the connection, and the Ryze AI help center ChatGPT guide covers the ChatGPT side. OpenAI documents the same flow in Connecting custom MCP servers in ChatGPT.
The older Settings, Apps flow
Some accounts still show the earlier custom app flow. The Ryze AI help center documents it with Developer mode, and OpenAI's current steps use Plugins as above. If your account has Settings, Apps, the flow looks like this:
- Open Settings, Apps, Advanced settings and turn on Developer mode.
- Click Create app.
- Enter the name Ryze AI and the MCP server URL https://connector.get-ryze.ai/mcp. Keep Server URL, not Tunnel, and set Authentication to OAuth.
- Tick I understand and want to continue, then click Create.
- Click Sign in with Ryze AI, log in, choose the workspaces and click Allow connection.
- Start a new chat.
Both flows end at the same Ryze AI sign-in page. The Plans rule from OpenAI applies to both, so this page does not claim that Plus accounts can connect.
Business and Enterprise/Edu publishing
On Business and Enterprise/Edu the workspace admin or owner connects and tests Ryze AI first, then publishes it so members can use it.
- The admin or owner adds Ryze AI as above and checks that the PostHog tools appear.
- To publish for the workspace, open Admin Console, select the workspace, then Plugins, Manage Legacy Apps, Drafts and click Publish. Review the safety warnings for write actions.
- Enterprise/Edu admins can use Configure Actions and Configure Access before publishing.
- Members find published apps under Settings, Plugins.
OpenAI notes that after an admin approves a connection for a workspace, ChatGPT uses a frozen snapshot of its tools. If you connect PostHog in Ryze AI afterwards, an admin has to refresh and publish an update before members see the new tools.
Other AI clients
The same URL works in other MCP clients. PostHog is connected once in Ryze AI, so nothing changes on the PostHog side.
Claude
In claude.ai open Customize, Connectors, click + Add, choose Add custom connector, enter the name Ryze AI and the URL, and click Connect on the new connector. PostHog stays connected in Ryze AI, so you do not repeat the key step.
Cursor
Add the server to .cursor/mcp.json, then sign in on the Ryze AI page when Cursor asks.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }PostHog key, host and project
Three settings decide what ChatGPT can reach in PostHog.
- The personal API key
- The phx_ key you save in Ryze AI is what PostHog checks on every call. A key with read scopes only keeps ChatGPT read-only, because PostHog rejects any change. Keys with write scopes let it create or update objects.
- The host
- Enter https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud, or your own URL for a self-hosted instance.
- The project
- Ryze AI connects one PostHog project per connection. After you save the key, pick the Project. To use another project, disconnect PostHog with the trash icon under View on the card and connect again, or use another Ryze AI workspace.
Hosts and limits
Values below come from PostHog's API documentation and the Ryze AI help center.
| Item | Value |
|---|---|
| US Cloud private endpoints | https://us.posthog.com |
| EU Cloud private endpoints | https://eu.posthog.com |
| Key prefix | phx_. PostHog says exposed phx_ keys found by GitHub secret scanning are rolled automatically and the owner is emailed. |
| Analytics endpoint limit | 240 per minute and 1,200 per hour, per key |
| Query endpoint limit | 2,400 per hour, per key |
| CRUD endpoint limit | 480 per minute and 4,800 per hour, per key |
| HogQL queries through Ryze AI | Queries need a time window and a row limit of 1,000 at most, because PostHog stops unbounded queries (Ryze AI help center) |
Sources: PostHog's API overview and Ryze AI help center PostHog article. Checked November 10, 2026.
Removing access
To remove access, delete the personal API key in PostHog under Settings, Personal API keys. In Ryze AI, click View on the PostHog card and use the trash icon. In ChatGPT, open Plugins, open Ryze AI and remove it.
What ChatGPT can do in PostHog
The Ryze AI connector exposes 3 PostHog tools. They run with the key you saved, so the key's scopes set the limit.
| Tool | Type | What it does |
|---|---|---|
| posthog__read | Read | Reads PostHog data for the connected project (projects, insights, dashboards, feature flags, cohorts, persons, event definitions) 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. |
On Pro, OpenAI limits custom MCP servers to read and fetch, so the write and delete tools are not usable there. On other plans, OpenAI says write actions may ask for confirmation and some risky actions may be blocked. In the Ryze AI chat, the Tool approvals picker starts on Skip all approvals; switch it to Approve write & delete or Manual approve if you want to confirm changes. Scheduled tasks run without an approval step. The surest control is a read-only PostHog key.
First 3 prompts to run
Each prompt below only describes what to ask. Answers come from your own PostHog project, so the page shows no sample numbers.
1. Find what exists first
List the dashboards, feature flags and cohorts in my PostHog project, with names and the date each was created.
Tools used: posthog__read
What comes back: Lists of dashboards, feature flags and cohorts from the one connected project, so you can name the right object in later questions.
2. Run a bounded HogQL query
Run a HogQL query on my PostHog events for the last 7 days: count pageview events per day, limit 1,000 rows, and show the result as a table.
Tools used: posthog__read
What comes back: A table of daily pageview counts. The time window and row limit keep the query inside what PostHog accepts.
3. Review a flag before changing it
Show the feature flag named in my last message with its current rollout settings. Then tell me what you would change to roll it out to 10% of users, and wait for me to confirm.
Tools used: posthog__read, then posthog__write only after you agree
What comes back: The flag's current settings and a proposed change. Nothing is written unless your key has write scopes and you confirm.
Replace the flag wording with the real flag key. If your PostHog key is read-only, the third prompt stops at the proposal.
Ryze AI vs PostHog's own MCP server
PostHog runs its own hosted MCP server. It suits different clients and jobs than the Ryze AI connector.
| Option | Setup | PostHog coverage | Auth | Listed clients |
|---|---|---|---|---|
| Ryze AI connector | Save a PostHog key, host and project in Ryze AI, then add https://connector.get-ryze.ai/mcp in ChatGPT Plugins | One project: reads of insights, dashboards, feature flags, cohorts, persons and event definitions, HogQL queries, plus create, update and delete of those objects when asked | OAuth with Ryze AI; PostHog personal API key stored in Ryze AI | ChatGPT, Claude, Cursor and others in the Ryze AI client list |
| PostHog hosted MCP server | Point a supported client at https://mcp.posthog.com/mcp | PostHog's own tools reference spans many products beyond analytics, such as flags, experiments, error tracking, surveys and SQL | PostHog sign-in routes you to the US or EU region | PostHog lists Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf and Zed; ChatGPT was not on the list when checked |
PostHog's server is free to connect to, though some of its tools use LLMs internally and may be billed as PostHog AI spend. If you need PostHog products outside analytics, use PostHog's server in a client it lists. If you want ChatGPT to reach PostHog, the Ryze AI connector is the path this page documents.
Sources: PostHog MCP server docs, OpenAI help article on custom MCP servers, Ryze AI help center PostHog article. Checked November 10, 2026.
PostHog errors and fixes
- ChatGPT has no Add custom MCP server option
- Custom MCP servers need a plan OpenAI lists for them: Business or Enterprise/Edu with full support, or Pro with read and fetch only. On Business, ask an admin or owner, because regular members cannot add it. Custom MCP servers are also web only, not on mobile.
- PostHog does not accept the key
- Check that the key starts with phx_, was created under Personal API keys and has read access to the project, with the Query and Insight scopes. Confirm the host matches your region: us.posthog.com, eu.posthog.com or your self-hosted URL.
- Writes fail but reads work
- The key has read scopes only. PostHog rejects any change from such a key. Create a key with the write scopes for the objects ChatGPT should change.
- A HogQL query is refused
- PostHog stops unbounded queries. Ask ChatGPT to add a time window and a row limit of at most 1,000.
- The wrong project shows up
- Each connection holds one project. Click View on the PostHog card in Ryze AI, disconnect with the trash icon and connect again with the right key, or use another workspace.
- PostHog tools do not appear in ChatGPT
- ChatGPT keeps the tool list from when the server was added. If you connected PostHog in Ryze AI afterwards, remove the app, install it again and start a new conversation. Directly connected servers can also be refreshed in Plugins with Refresh.
- A Business member cannot see Ryze AI
- An admin or owner has to publish it for the workspace first. After new tools are added, the admin refreshes and publishes an update.
- The tools say a subscription is required
- The PostHog tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
- The one-time connection link is refused
- Ryze AI can send a link for you to paste a PostHog key, valid once and for 24 hours. It is refused while PostHog is already connected in the workspace. Change the key or project in the Ryze AI app instead.
Frequently asked questions
How do I connect ChatGPT to PostHog?
Create a PostHog personal API key, save it with the host and project in Ryze AI under Integrations, then open Plugins in ChatGPT on the web, add a custom MCP server named Ryze AI with the URL https://connector.get-ryze.ai/mcp and OAuth, allow the workspace, install the plugin and start a new conversation.
Which should I use, Ryze AI or PostHog's own MCP server?
Ryze AI is the best way to reach PostHog from ChatGPT with one URL and one project, though PostHog's own server covers more PostHog products. PostHog's server is https://mcp.posthog.com/mcp and its docs list Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf and Zed, not ChatGPT.
Which ChatGPT plan do I need?
OpenAI states that custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise/Edu customers on the web. Pro users can connect custom MCP servers with read and fetch permissions only. OpenAI's article does not mention Free, Go or Plus.
Who can add Ryze AI in ChatGPT Business?
On Business only admins and owners can create and publish plugins for custom MCP servers. On Enterprise/Edu admins and owners can, and admins can grant other members permission through RBAC.
Does it work in the ChatGPT mobile app?
No. OpenAI says custom MCP servers cannot be connected on mobile. Set it up on ChatGPT web.
What PostHog access does the key need?
Read access to the project you want, including the Query and Insight scopes. Add write scopes only if ChatGPT should change insights, dashboards, feature flags or cohorts. A read-only key keeps ChatGPT read-only, because PostHog rejects any change.
Which PostHog host do I enter?
Use https://us.posthog.com for US Cloud, https://eu.posthog.com for EU Cloud, or your own URL for a self-hosted instance.
Can ChatGPT edit or delete things in PostHog?
Yes, when the key has write scopes and your ChatGPT plan allows write actions. Through Ryze AI it can create or edit insights, dashboards, feature flags and cohorts, and delete those objects when explicitly asked. Deletion is irreversible. Pro is limited to read and fetch.
Can I connect more than one PostHog project?
Not in one workspace. Ryze AI holds one PostHog project per connection. To switch, disconnect with the trash icon under View on the PostHog card and connect again. Another project can live in another Ryze AI workspace, and one ChatGPT connection can cover up to 20 workspaces.
Why do the PostHog tools not show up in ChatGPT?
ChatGPT keeps the tool list from when the server was added. If you connected PostHog in Ryze AI afterwards, remove the app, install it again and start a new conversation. On a published Business workspace an admin must refresh and publish an update.
How much does it cost?
Connecting is free, 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. Your ChatGPT plan is billed separately by OpenAI.
How do I disconnect PostHog from ChatGPT?
Delete the personal API key in PostHog, click View on the PostHog card in Ryze AI and use the trash icon, or remove Ryze AI from Plugins in ChatGPT.