Skip to content

📘 docs: Document MCP OAuth Sign-In on First Tool Use - #852

Merged
berry-13 merged 3 commits into
mainfrom
docs/mcp-oauth-on-use
Oct 21, 2026
Merged

berry-13 merged 3 commits into
mainfrom
docs/mcp-oauth-on-use

Conversation

@berry-13

Copy link
Copy Markdown
Collaborator

Summary

LibreChat-AI/LibreChat#17225 added two mcpServers keys that were not documented: oauthPrompt (on_start or on_use) and oauthToolCatalog. With on_use, an OAuth server asks the user to sign in when the agent first calls one of its tools instead of at turn start.

The MCP Servers page now covers both keys in the option table and in their own sections: when each mode prompts, the conditions on_use needs (every selected tool deferred, a declared catalog that covers them, an operator-defined server without per-user connection settings), the fallback to the turn-start prompt, and the bounded, strict tool schema the catalog accepts. An example mirrors librechat.example.yaml. Only the English page changed; the translation workflow updates the other locales.

Change Type

  • Documentation update

Testing

  • pnpm exec prettier --check on the page: clean.
  • pnpm exec fumadocs-mdx and an @mdx-js/mdx compile of the page: clean.
  • pnpm test: 436 passed.
  • Parsed the page's YAML examples with the merged MCPOptionsSchema: they validate, and a misspelled input_schema key or a minLength keyword is rejected as the page states.

@vercel

vercel Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
librechat-ai Ready Ready Preview Oct 21, 2026 7:12pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-21T19:30:22.074444Z f9533e6 Manual request
🔒 Security Review ✅ Completed 2026-10-21T16:25:28.204637Z bc04e29 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 15845763ca

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/docs/configuration/librechat_yaml/object_structure/mcp_servers.mdx Outdated
@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@github-actions

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@berry-13

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the current PR head f9533e6. State the exact reviewed commit and ignore findings that apply only to earlier heads.

Purpose supplied by the requester: Same-head round on f9533e6: the automatic round after the admin-servers fix posted no new findings and no verdict; all threads resolved

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Bravo.

Reviewed commit: f9533e68fd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@berry-13
berry-13 merged commit 48f78d1 into main Oct 21, 2026
5 checks passed
@berry-13
berry-13 deleted the docs/mcp-oauth-on-use branch October 21, 2026 20:33

This branch was successfully deployed

1 active deployment
Preview — f9533e68 Deployed Oct 21, 2026 by vercel[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.

1 participant