Skip to content

docs: clarify MCP content filtering for authenticated users#5666

Merged
ethanpalm merged 3 commits into
mainfrom
docs/mcp-content-filtering-clarification
May 7, 2026
Merged

docs: clarify MCP content filtering for authenticated users#5666
ethanpalm merged 3 commits into
mainfrom
docs/mcp-content-filtering-clarification

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 4, 2026

Updates the "Content filtering and indexing" section of the Model Context Protocol page to fix inaccurate and confusing language about what the authenticated MCP server indexes.

Feedback addressed

From @andrew Tsai (with @dean), based on troubleshooting this Sardine issue and this thread:

  • The term "public user groups" conflates groups of pages (public: true on a page or nav group) with groups of users (auth user groups).
  • The previous wording said the authed MCP "only indexes pages in public user groups," but in practice the authed MCP also serves any pages the authenticated user has permission to access based on their user group — including private page groups they belong to.
  • The partial-auth sentence was missing the user-group access detail.

Changes

Rewrote the paragraph to:

  • Use the correct term "public pages and groups" (matching the linked #make-pages-public section).
  • Clarify that authenticated users also see pages they have permission to access via their user groups, with a link to the user-group restriction docs.
  • Split the partial-auth case into its own sentence and include the user-group access detail.

Note

Low Risk
Documentation-only wording changes; no runtime or behavior changes, with minimal risk beyond potential confusion if the new guidance is misunderstood.

Overview
Clarifies the Content filtering and indexing section of ai/model-context-protocol.mdx to correctly describe what the MCP server makes searchable for authenticated users.

Updates the wording to state that authenticated MCP access includes public pages plus any pages permitted by the user’s auth user groups, and splits the partial-auth case into explicit unauthenticated vs authenticated search behavior with links to the relevant auth docs.

Reviewed by Cursor Bugbot for commit 9d78812. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 4, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 4, 2026, 11:50 PM

@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented May 4, 2026

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

Project Status Preview Updated (UTC)
userauth 🟢 Ready View Preview May 4, 2026, 11:51 PM

@andrew-mintlify-cs
Copy link
Copy Markdown
Contributor

@ethanpalm lmk if this is confusing and you want to chat about it in person.

@ethanpalm ethanpalm self-requested a review May 7, 2026 17:41
@ethanpalm ethanpalm merged commit 4894456 into main May 7, 2026
4 of 5 checks passed
@ethanpalm ethanpalm deleted the docs/mcp-content-filtering-clarification branch May 7, 2026 21:58
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.

3 participants