Skip to content

docs: document per-user OAuth for MCP servers#691

Merged
notgiorgi merged 3 commits into
mainfrom
mintlify/303f565f
May 22, 2026
Merged

docs: document per-user OAuth for MCP servers#691
notgiorgi merged 3 commits into
mainfrom
mintlify/303f565f

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 22, 2026

Summary

Documents the new per-user OAuth credential flow for MCP servers attached to AI agents, alongside the existing shared-credential flow.

Context

Source PR: lightdash/lightdash#23443 — adds backend support for personal (user-scoped) OAuth credentials on MCP servers, plus an opt-in Allow shared OAuth credential flag on the server. Each project member can now connect their own account; managers can additionally connect a shared fallback account when the server allows it. The agent uses the user's personal credential first and falls back to the shared one if available.

Changes

  • Updated guides/ai-agents/mcp-servers.mdx:
    • Removed the outdated note that per-user OAuth is "planned but not yet supported".
    • Added an "OAuth credential scopes" table comparing personal vs shared scopes (who connects, who uses, attribution).
    • Updated the "Add an MCP server" steps to cover the new Allow shared OAuth credential option and the per-user Connect action.
    • Expanded the Security section to explain that personal credentials are isolated to the user who connected them, and that only managers can enable or connect shared credentials.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 timezones-draft.mdx

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 22, 2026

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

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 22, 2026, 2:15 PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 timezones-draft.mdx

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 timezones-draft.mdx

@notgiorgi notgiorgi merged commit 7504e14 into main May 22, 2026
4 of 5 checks passed
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.

2 participants