Skip to content

docs(TOF-303): update MCP docs for default enablement - #102

Merged
myronkaifung merged 5 commits into
mainfrom
copilot/tof-303-update-docs-mcp-default-enablement
Jul 28, 2026
Merged

docs(TOF-303): update MCP docs for default enablement#102
myronkaifung merged 5 commits into
mainfrom
copilot/tof-303-update-docs-mcp-default-enablement

Conversation

Copilot AI commented Jul 17, 2026 •
edited by tylergoerzen-mxp
Loading

Copy link
Copy Markdown
Contributor

MCP is now enabled by default for all net new free & growth orgs — admins can disable it, but no setup is required to connect. The docs previously stated the opposite (off by default, admin must enable).

Changes in docs/mcp.mdx

  • Permissions & Access — Replaced "Admin setup required" note with "MCP is enabled by default; admins can disable in Settings → Org → Overview"
  • Service Accounts prerequisites — Removed the "MCP must be enabled by an org admin" step
  • Security Considerations — Updated access controls bullet from "off by default / must be explicitly enabled" → "on by default / can be disabled"
  • Troubleshooting — Reworded both MCP-access error entries to reflect disabled-not-missing framing

Fixes TOF-303

@linear-code

linear-code Bot commented Jul 17, 2026

Copy link
Copy Markdown

TOF-303

docs(TOF-303): update MCP docs for default enablement
ee36484 
MCP is now enabled by default for all organizations.
Admins can disable it in Settings → Org → Overview if needed.

- Update Permissions & Access note to reflect on-by-default
- Remove "MCP must be enabled" from Service Accounts prerequisites
- Update Security Considerations bullet from off-by-default to on-by-default
- Update Troubleshooting to say "disabled" instead of "not enabled"
Copilot AI changed the title [WIP] Update docs for MCP default enablement docs(TOF-303): update MCP docs for default enablement Jul 17, 2026
Copilot AI requested a review from tylergoerzen-mxp July 17, 2026 01:17
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mixpanel-docs 🟢 Ready View Preview Jul 17, 2026, 1:19 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

docs(TOF-303): correct MCP default enablement scope
3f2db3a 
MCP is only enabled by default for new free and growth accounts
created after August 1, 2026. All other accounts still require
an org admin to enable it.

- Permissions & Access: two-tier note distinguishing new free/growth
  accounts (on by default) from all others (admin required)
- Service Accounts prerequisites: restore step 4 requiring admin
  enablement, with caveat for new accounts
- Security Considerations: restore "must be enabled by admin" bullet
  with note about new account default
- Troubleshooting: restore original wording for admin enablement
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mixpanel-docs 🟡 Building – Jul 17, 2026, 1:16 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@myronkaifung
myronkaifung marked this pull request as ready for review July 22, 2026 22:18
@myronkaifung
myronkaifung requested a review from a team as a code owner July 22, 2026 22:18
@myronkaifung
myronkaifung requested a review from pmackle July 22, 2026 22:18
@greptile-apps

greptile-apps Bot commented Jul 22, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Confidence Score: 4/5

Safe to merge after updating the Troubleshooting section to match the new default-on framing.

The Troubleshooting section still directs users to 'enable MCP' without distinguishing new accounts (where MCP is on by default and may have been disabled) from legacy accounts (where it was never enabled). For a post-Aug 1, 2026 user hitting the 'MCP access is not enabled' error, the guidance is subtly misleading — they need to re-enable, not enable for the first time.

Files Needing Attention: docs/mcp.mdx — Troubleshooting entries at lines 451 and 453

Important Files Changed
Filename Overview
docs/mcp.mdx Updates MCP access docs for default enablement on new Free/Growth accounts (post Aug 1 2026); Troubleshooting section still references 'enable MCP' framing without accounting for the new default-on cohort where admins would need to re-enable, not enable

Reviews (2): Last reviewed commit: "Merge branch 'main' into copilot/tof-303..." | Re-trigger Greptile

@myronkaifung
myronkaifung enabled auto-merge (squash) July 28, 2026 23:20
@myronkaifung
myronkaifung disabled auto-merge July 28, 2026 23:31
@myronkaifung
myronkaifung merged commit 1011d97 into main Jul 28, 2026
6 checks passed
@myronkaifung
myronkaifung deleted the copilot/tof-303-update-docs-mcp-default-enablement branch July 28, 2026 23:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@myronkaifung myronkaifung myronkaifung approved these changes
@tylergoerzen-mxp tylergoerzen-mxp Awaiting requested review from tylergoerzen-mxp
@pmackle pmackle Awaiting requested review from pmackle pmackle is a code owner automatically assigned from mixpanel/docs-reviewers

Assignees

Copilot code review Copilot

@tylergoerzen-mxp tylergoerzen-mxp

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@myronkaifung @tylergoerzen-mxp