# Heap setup for PopMCP Nothing has to be typed into PopMCP to ask questions. You click Sign in with Heap, sign in and approve. There is no developer app or callback URL to set up. To send events and properties or delete users, you use an App ID and API key under More options instead, which a Heap admin finds under Account, Manage, Privacy & Security. - Auth: OAuth authorization - Setup time: 1 min - API base URL: https://mcp.heapanalytics.com/mcp - Credentials screen: https://heapanalytics.com/app/manage/privacy-and-security - Provider docs: https://help.heap.io/hc/en-us/articles/50560292050321-Heap-MCP-overview ## Before you begin - A Heap account with access to Heap MCP. If you cannot find it, look under Integrations, then MCP, in Heap, or ask your Heap admin - Pop-up blockers must allow the Heap sign-in window to open - Only to send data or delete users: a Heap admin, who can make the API key, and an owner or admin in PopMCP to allow write actions ## Get your credentials ### 1. Start the connection from PopMCP Open the Heap connector in PopMCP and click Sign in with Heap. There are no fields to fill in. If you sign in to Heap at eu.heapanalytics.com, open More options first and type EU under Data region. ### 2. Sign in to Heap and approve If you are not signed in to Heap in this browser, Heap shows its normal login page first. Then approve the access PopMCP asks for. One sign-in reaches the Heap projects your own account can see. ### 3. Back in PopMCP You return to PopMCP, connected, with the tools Heap offers your account. If you have several Heap environments, your AI asks which one to use, and Heap remembers the choice. This connection only reads aggregated numbers. ### 4. Or connect with an App ID and API key Optional, instead of signing in, to send events and properties or delete users. A Heap admin opens Account, Manage, Privacy & Security. The App ID is on this page. Under Delete End User Data, choose to use the API and generate a key if there is none yet. Copy both, open More options in PopMCP and paste them. Use the App ID of your Main Production environment, because the key works with no other. This connection cannot read Heap: to have both, add a second connection. Screen: https://heapanalytics.com/app/manage/privacy-and-security ### 5. Send to a development environment Optional, to test what you send before it reaches production. Find the ID of a development environment under Account, Manage, Projects in Heap, and put it in Send events to another environment. The App ID and API key stay the ones from Main Production. Heap cannot confirm the ID is yours, so check it first. Screen: https://heapanalytics.com/app/manage/projects ## Fields PopMCP asks for - How you connect (connectionType): Click Sign in with Heap, sign in and approve. There is nothing to copy or paste. If you sign in to Heap at eu.heapanalytics.com, open More options and type EU first. - Data region (region): Leave this blank for the US. Type EU if you sign in to Heap at eu.heapanalytics.com. - App ID (to send data, instead of signing in) (appId): Signing in reads your data. To send events and properties or delete users, paste your App ID and API key here instead. In Heap, open Account, Manage, Privacy & Security. Use the App ID of Main Production. - API key (with the App ID) (apiKey): On the same page, under the option to use the API. An admin can make one. Stored encrypted and used only on our servers. - Send events to another environment (environmentId): To test on a development environment first. Find its ID under Account, Manage, Projects in Heap. ## Scopes requested - heap.mcp ## Verify The Heap card in PopMCP shows Connected. A signed-in connection shows how many tools Heap offers, and asking the AI for the connection profile (`heap_connection_profile`) lists them. A connection made with an App ID and API key is checked by asking Heap for a token, and the profile says where events are sent. ## Troubleshooting ### The sign-in window never opens Cause: A pop-up blocker is stopping the Heap sign-in window. Fix: Allow pop-ups for PopMCP in your browser and click Sign in with Heap again. ### Heap will not sign you in, or says it does not know your account Cause: Your Heap data is in the EU data center, and the connection went to the US. Fix: Open More options, type EU under Data region and sign in again. You are on the EU data center if you normally sign in at eu.heapanalytics.com. ### Heap signed me in, but PopMCP says it offered no tools Cause: Your Heap account does not have access to Heap MCP yet. Fix: Look under Integrations, then MCP, in Heap, or ask your Heap admin to turn it on. Then connect again. ### Heap did not accept this App ID and API key Cause: The App ID is not the one for Main Production, the key was replaced, or part of it was not copied. Fix: Copy both again from Account, Manage, Privacy & Security in Heap. The App ID on that page is the right one. Only an admin can see the key. ### The AI says it cannot read events or reports Cause: This connection was made with an App ID and API key, which only send data. Fix: Add a second Heap connection by clicking Sign in with Heap. To ask questions you need the signed-in one. ### The AI says it cannot send an event Cause: This connection was made by signing in, which only reads, or it is a key connection still set to read-only. Fix: Add a connection with an App ID and API key, and have an owner or admin in PopMCP allow write actions on it. ### Events I sent do not appear in Heap Cause: They may still be processing, they went to another data region or environment, or the identity is spelled differently. Identities are case-sensitive. Fix: Wait a little and check again. Ask the AI for the connection profile to see the data region and where events are sent, and reconnect with the right region if it is wrong. ### Heap will not take a new identity for a user Cause: Heap maps a user_id to one identity only, and drops later attempts without an error. An identity also takes at most 10 user_ids a month. Fix: Check the spelling before you identify someone. A mapping cannot be changed through the API. --- Source: https://www.docs.popmcp.com/docs/integrations/heap/