[PR #5949] docs(mcp): adding more clear instructions and details #31944

New Issue

2026-04-17T22:49:09-05:00

GiteaMirror commented

2026-04-17 22:49:09 -05:00

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/5949
Author: @okisdev
Created: 11/13/2025
Status: 🔄 Open

Base: main ← Head: docs(mcp)/enhance-docs

📝 Commits (5)

820f138 docs(mcp): enhance docs
641659b docs(mcp): enhance docs
28b3b05 docs(mcp): enhance docs
78f65aa Merge branch 'canary' into docs(mcp)/enhance-docs
65d48ab Merge branch 'canary' into docs(mcp)/enhance-docs

📊 Changes

1 file changed (+377 additions, -49 deletions)

View changed files

📝 docs/content/docs/plugins/mcp.mdx (+377 -49)

📄 Description

This PR adds some clear instructions and technical details for MCP docs.

Summary by cubic

Enhanced MCP plugin docs with setup and endpoint protection via withMcpAuth, including automatic 401/WWW-Authenticate handling, manual session use, and scope-based checks. Adds OAuth flow reference, discovery endpoints, client registration (public vs confidential), PKCE options, refresh-token guidance, advanced OIDC config, security best practices, and updated install/migration notes.

^{Written for commit 65d48ab187. Summary will update automatically on new commits.}

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/better-auth/better-auth/pull/5949 **Author:** [@okisdev](https://github.com/okisdev) **Created:** 11/13/2025 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs(mcp)/enhance-docs` --- ### 📝 Commits (5) - [`820f138`](https://github.com/better-auth/better-auth/commit/820f1387fc6e7eaf6cdec91b25b8dc6e8baffb19) docs(mcp): enhance docs - [`641659b`](https://github.com/better-auth/better-auth/commit/641659b780aab24221c95971d9772dea9ef928e3) docs(mcp): enhance docs - [`28b3b05`](https://github.com/better-auth/better-auth/commit/28b3b05b059ac8ebba5f0aa55a0ea47acac9a39c) docs(mcp): enhance docs - [`78f65aa`](https://github.com/better-auth/better-auth/commit/78f65aa58a127f708b1f41bf20ad4ef3aa48fa5d) Merge branch 'canary' into docs(mcp)/enhance-docs - [`65d48ab`](https://github.com/better-auth/better-auth/commit/65d48ab187f8329af5b8901b217b2930a1a0f28f) Merge branch 'canary' into docs(mcp)/enhance-docs ### 📊 Changes **1 file changed** (+377 additions, -49 deletions) <details> <summary>View changed files</summary> 📝 `docs/content/docs/plugins/mcp.mdx` (+377 -49) </details> ### 📄 Description This PR adds some clear instructions and technical details for MCP docs.  --- ## Summary by cubic Enhanced MCP plugin docs with setup and endpoint protection via withMcpAuth, including automatic 401/WWW-Authenticate handling, manual session use, and scope-based checks. Adds OAuth flow reference, discovery endpoints, client registration (public vs confidential), PKCE options, refresh-token guidance, advanced OIDC config, security best practices, and updated install/migration notes. <sup>Written for commit 65d48ab187f8329af5b8901b217b2930a1a0f28f. Summary will update automatically on new commits.</sup>  --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

GiteaMirror added the pull-request label 2026-04-17 22:49:09 -05:00

Sign in to join this conversation.

Branches Tags

2026-08-23/fix/respect-configured-logger

2026-08-23/refactor/auth-endpoint-context

2026-08-24/fix/validate-null-origin

changeset-release/main

main

dependabot/npm_and_yarn/demo/electron/demo-minor-patch-ff609372a3

dependabot/github_actions/github-actions-1ace875667

2026-08-22/fix/drizzle-v2-relation-keys

2026-08-22/fix/respect-configured-logger

feat/provider-scoped-account-identity

feat/1-7-migration-validation

2026-08-19/fix/mysql-disabled-index-introspection

2026-08-18/refactor/simplify-cloudflare-fixture

2026-08-19/ci/stabilize-mssql-startup

docs/1-7-release

2026-08-14/fix/standardize-plugin-types

2026-08-13/fix/dpop-public-url

2026-08-13/fix/acr-values-voluntary

starsling/CHG-forget-processed-cleanup-rows-b8077b74ef9a-4971f8e41755

refactor/device-authorization-oauth-boundary

2026-08-11/fix/api-key-rate-limit-window

feat/oauth-provider-custom-subject

pr-9793-merge

2026-07-31/chore/bump-better-call

2026-07-30/chore/upgrade-better-call

2026-07-30/fix/nextjs-rsc-session-refresh

2026-07-29/refactor/centralize-placeholder-email-generation

refactor/oauth-client-application-type

2026-07-28/fix/anonymous-oauth-proxy-linking

feat/agent-feedback-endpoint

fix/oauth-provider-session-deletion

feat/scim-demo-workflow

feat/scim-active-user-link

feat/sso-provider-user-resolution

feat/identity-provider-accounts

feat/oauth-provider-remove-silence-warnings

changeset-release/release/vercel-announcement

release/vercel-announcement

2026-06-29/docs/optimize-og-images

feat/yandex-social-provider

feat/ssrf-fetch-boundary

codex/pr-10225-next-comments

fix/phone-number-disable-input

perf/router-build-once

fix/oauth-user-provisioning-fields

codex/ignore-compose-override-spellcheck

2026-06-19/fix/stripe-org-reference-scope

feat/webhooks

feat/baseurl-canonical-serving-split

feat/magic-link-expires-in

fix/esbuild-security-bump

chore/sync-main-to-next-20260615

chore/revert-10053

codex/fix-expo-sdk56-dynamic-import

refactor/oauth-provider-client-authentication-module

fix/oauth-no-store-headers

claude/slack-update-stripe-docs-consistency-8Sc0w

local/fix-invite-accept-idempotency

docs/beta-mdx-component-fallback

fix/dependabot-hono-shell-quote

codex/stateless-account-cookie-resolution

fix/admin-create-user-role-escalation

feat/oauth-provider-oidc-acr

refactor/sign-in-challenges

refactor/optional-kysely-dependency

2026-06-06/chore/kysely-changeset

copilot/fix-code-review-comment

starsling/prisma-migration-reset

2026-06-02/fix/next-cookies-defer-rsc

feat/oauth-contribution-protocol

ping-maxwell/c-ping-maxwell/fix-kysely-adapter-core-utils-string-resolution-68c5

temp/server-only-test

2026-05-31/refactor/kysely-joins-json-helpers

2026-04-29/feat/google-include-granted-scopes

2026-04-29/fix/oauth-account-scope-semantics

fix/oauth-callback-path-declarative

2026-05-31/fix/sqlite-dialect-affected-rows

fix/next-cookie-separator

2026-05-29/fix/last-login-method-cookie-prefix

ping-maxwell/c-ping-maxwell/fix-error-link-apostrophe-f89a

client-assertions-main

2026-05-15/ci/fix-sqlite-abi-mismatch

2026-05-15/fix/organization-team-add-cascade

2026-05-15/fix/parse-set-cookie-value-validation

2026-05-13/feat/captcha-wildcard-endpoints

fix/i18n-before-hook-translation

fix/disable-migration-generate

2026-05-10/fix/cookie-drain-order

2026-05-10/feat/hooks-finally

2026-05-09/fix/cookie-drain-order

2026-05-09/feat/hooks-finally

2026-05-08/feat/register-before-send

fix/stripe/subscription-data-merge

2026-05-01/chore/pnpm-v11-harden

chore/pnpm-v11

2026-04-27/fix/nextcookies-idempotent-writes

2026-04-26/fix/harden-proxy-host-validation

2026-04-26/refactor/stripe-callback-signature-cleanup

2026-04-26/fix/stripe-subscription-callback-timing

2026-04-11/fix/sveltekit-app-modules

feat/open-api-zod-contract

feat/oauth-idp-initiated-bounce

2026-04-21/fix/oauth-rfc-input-validation

fix/two-factor-identity-guard

fix/resource

feat/emailpassword-authorize

feat/oauth-provider-at-hash-v2

fix/release-grep-fallback

claude/address-review-comments-JhFLr

feat/async-auth

fix/two-factor-totp-verified-enrollment

feat/plugin-ui

codex/blog-1-6-release-post

2026-04-06/fix/type-any-guards

2026-04-05/chore/downgrade-better-call

2026-04-04/ci/skip-vercel-fork-prs

2026-03-28/ci/add-autofix-ci

chore/release-preview-script

himself65/2026/02/19/role

2026-03-20/docs/improve-website

2026-03-20/fix/anonymous-onlinkaccount-expo

2026-02-17/fix/anonymous-link-state

fix/8607-saml-inresponseto

fix/8549-scim-patch-noop

v1.4.x

refactor/migration-snapshot-tests

worktree-magic-link-additional-data

chore/migrate-build-to-rollup

worktree-fix-dynamic-baseurl-8447

2026-03-06/chore/public-api-check

fix/close-8156-regression-test

fix/secondary-storage-json-error-handling

himself65/verification-namespace

cursor/issue-8307-validation-79a3

himself65/2026/01/30/error-mdx

v1.4.x-staging

fix/email-otp-user

fix/restrict-full-organization-access-roles

himself65/2026/02/12/count

himself65/2026/02/04/define-plugin

2026-02-04/feat/add-pluralize

cursor/better-auth-js-integration-ec21

cursor/expo-state-mismatch-394c

2026-02-01/fix/org-update-role-sync-members

cursor/issue-7607-investigation-e146

cursor/email-generation-helper-0ff6

himself65/2026/01/21/avoid-spread-operator

himself65/2026/01/14/cli

claude/slack-add-docs-pr-NMvgO

claude/slack-add-advanced-useplural-WHKYL

feat/hooks-pos

feat/2fa-phone

feat/2fa

fix/rotation

fix/username-check

v1.3.x

refactor/organization

feat/multiple-client-ids-social-providers

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/better-auth#31944