Skip to content

docs: clarify MCP content filtering for authenticated users#5666

Open
mintlify[bot] wants to merge 1 commit intomainfrom
docs/mcp-content-filtering-clarification
Open

docs: clarify MCP content filtering for authenticated users#5666
mintlify[bot] wants to merge 1 commit intomainfrom
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
Low risk documentation-only change that clarifies which pages are indexed/searchable for authenticated vs unauthenticated MCP access; no product or runtime behavior changes.

Overview
Clarifies the Content filtering and indexing documentation for hosted MCP servers by replacing the ambiguous “public user groups” language with public pages and groups (those marked public: true).

Updates the auth and partial-auth descriptions to explicitly state that authenticated users can also search any additional pages they’re permitted to access via their configured user groups, and splits the partial-auth case into separate unauthenticated vs authenticated behavior.

Reviewed by Cursor Bugbot for commit 4ec8724. 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

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

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