Skip to content

Document enterprise-managed connections for Mixpanel MCP - #362

Open
tiffanyqi wants to merge 13 commits into
mainfrom
mcp-enterprise-managed-connections
Open

tiffanyqi wants to merge 13 commits into
mainfrom
mcp-enterprise-managed-connections

Conversation

@tiffanyqi

@tiffanyqi tiffanyqi commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

To be deployed on November 2

Before: The docs had no page on enterprise-managed connections. That is the setup where admins connect Claude to the Mixpanel MCP Server for a whole organization, so members don't each sign in and approve the connection. The content existed only in an internal Notion draft.

After: A new page, /docs/mcp/claude-enterprise-managed-auth, covers:

  • prerequisites
  • how the connection works
  • setup with Claude as the issuer
  • setup with Okta as the issuer (OIDC or SAML)
  • a Run Test troubleshooting table
  • an FAQ

The MCP Server page's Claude section links to it.

How:

  • New file docs/mcp/claude-enterprise-managed-auth.mdx.
  • In docs.json, "MCP Server" is now a group with docs/mcp as its main page, so /docs/mcp keeps its URL. This follows the "MCP Connections" group's layout.
  • A Note callout under "Connecting with OAuth → Claude" in docs/mcp.mdx links to the new page.
  • The audit-log guide says connections are recorded (only disconnecting is not).
  • mint broken-links passes.

Notes for reviewers:

  • The "How it works" section is generalized to cover both issuers. The Notion draft described only the Okta flow.
  • The Notion draft has open comment threads that are not reflected here.

🤖 Generated with Claude Code

Add a page explaining how Claude and Mixpanel admins connect Claude to
the Mixpanel MCP Server for a whole organization, with Claude or Okta as
the issuer. Nest it under the MCP Server page in the sidebar and link it
from the Claude connection instructions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mixpanel-docs 🟢 Ready View Preview Oct 30, 2026, 10:35 PM

@greptile-apps

greptile-apps Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The PR appears safe to merge.

Reviews (11) · Last reviewed commit: "Update docs/mcp/claude-enterprise-manage..." · Reviewed by Greptile

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tiffanyqi and others added 2 commits October 27, 2026 23:13
…ed-auth

Updates the nav entry and the MCP page's link, and redirects
/mcp/claude-enterprise-managed-auth to the new path.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Each MCP connection, interactive or enterprise-managed, writes an
mcp_client.authorized entry to every organization the member belongs to.
Only disconnecting is still unrecorded.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tiffanyqi and others added 2 commits October 30, 2026 01:49
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread docs/access-security/audit-log.mdx Resolved
* **Claude as the issuer:** remove them from your Claude organization.
* **Okta as the issuer:** remove them from Okta, or unassign them from the Mixpanel MCP app.

If you use directory sync (SCIM), Claude removes a member when your directory deletes them, but not when it only suspends them or marks them inactive.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to be describing Claude's SCIM integration rather than Mixpanel? Is this relevant?

| Check | Usual cause | What to do |
| - | - | - |
| **Check eligibility** | This organization or connector can't use Claude as the issuer. | Contact Claude support, or set up with Okta. |
| **Discover authorization server** | Mixpanel didn't publish its sign-in details. | Contact Mixpanel support. |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| **Discover authorization server** | Mixpanel didn't publish its sign-in details. | Contact Mixpanel support. |
| **Discover authorization server** | Mixpanel's sign-in details are unavailable. | Contact Mixpanel support. |


1. **Create the Mixpanel MCP app (Okta admin)**

Mixpanel isn't in Okta's app catalog with Cross App Access (XAA), Okta's feature that lets one app reach another app on a user's behalf without a separate sign-in or consent screen. Instead, create a custom app integration using either OIDC or SAML 2.0. See [Okta's guide to creating an app integration](https://developer.okta.com/docs/guides/create-an-app-integration/openidconnect/main/). Use the values in the Okta tables above.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mixpanel isn't in Okta's app catalog with Cross App Access (XAA), Okta's feature that lets one app reach another app on a user's behalf without a separate sign-in or consent screen.

Do we have plans to get this in place that we can mention it in the FAQ section?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good call out! will add that


## Set up with Okta as the issuer

### Settings

@coltonb-mixpanel coltonb-mixpanel Oct 30, 2026 •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The settings should probably follow the step where they're required, rather than being presented without context up front.

Does it matter which they're using (OIDC vs SAML)? If OIDC is easier and changes nothing for the setup, we should probably just point people that way until XAA is enabled on the official mixpanel app.

| Setting | Value |
| - | - |
| **Single sign-on URL** | `https://mixpanel.com/` |
| **Audience URI (SP Entity ID)** | `https://auth.mixpanel.com` |

@coltonb-mixpanel coltonb-mixpanel Oct 30, 2026 •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

More concretely re: OIDC vs SAML -- we provide explicit Mixpanel app setup instructions here: https://docs.mixpanel.com/docs/access-security/single-sign-on/okta#configure-saml -- these values shouldn't impact EMA MCP auth + the ones provided here won't work for login.

If someone is already using a custom app, they can add the XAA config there, rather than making a new app basically.

This reverts commit 872cb10.
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

This branch was successfully deployed

1 active deployment
staging — 9a33e373 Deployed Oct 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants