Skip to content

Add IdP integration guides for vMCP (Entra ID and Okta)#810

Open
jhrozek wants to merge 1 commit intomainfrom
entra-guides
Open

Add IdP integration guides for vMCP (Entra ID and Okta)#810
jhrozek wants to merge 1 commit intomainfrom
entra-guides

Conversation

@jhrozek
Copy link
Copy Markdown
Contributor

@jhrozek jhrozek commented Apr 27, 2026

Summary

  • Adds step-by-step guides for connecting a VirtualMCPServer to Microsoft Entra ID and Okta using the embedded OAuth 2.0 authorization server
  • The guides cover the full setup path: configure the IdP to include group/role membership in access tokens, deploy the VirtualMCPServer with the embedded auth server as the broker, and write Cedar policies that map IdP groups to fine-grained per-tool access control
  • Adds a lightweight landing page (vmcp-idp-overview.mdx) as an IdP picker with prerequisites, linking to the per-IdP guides

Closes #407

Files added

  • integrations/vmcp-idp-overview.mdx — landing page, prerequisites, IdP picker
  • integrations/vmcp-entra-id.mdx — app registration, API scope exposure, App Roles, user/group assignments, VirtualMCPServer YAML; all portal steps have CLI equivalents in collapsible blocks; uses the roles claim
  • integrations/vmcp-okta.mdx — custom authorization server, OIDC app, groups scope and claim, access policy, VirtualMCPServer YAML; uses the groups claim; documents API Access Management add-on requirement

Both guides include consistency checklists (group name matching across IdP, claim filter, and Cedar policies), deployment steps, and troubleshooting sections.

Files updated

  • guides-vmcp/authentication.mdx and guides-vmcp/intro.mdx — inbound links to the new guides
  • sidebars.ts — nested "Identity provider integration" sub-category under Integrations

Test plan

  • npm run build passes with no new broken anchors
  • IdP integration sub-category appears in the sidebar under Integrations
  • Overview page links to both IdP-specific guides
  • Both guides link forward to Cedar policies and auth framework docs
  • CLI collapsibles in the Entra guide render and collapse correctly

🤖 Generated with Claude Code

Teams running VirtualMCPServer on Kubernetes want to use their existing
corporate SSO (Entra ID or Okta) instead of maintaining a separate
credential store. These guides cover the full setup: configuring the IdP
to issue group membership in access tokens, deploying the VirtualMCPServer
with the embedded auth server as the broker, and writing Cedar policies
that map IdP groups to fine-grained per-tool access control.

Three new pages under integrations/:

- vmcp-idp-overview.mdx: landing page with prerequisites and IdP picker
- vmcp-entra-id.mdx: app registration, API scope exposure, App Roles,
  user/group assignments, VirtualMCPServer YAML; all portal steps have
  CLI equivalents in collapsible blocks; uses the roles claim
- vmcp-okta.mdx: custom authorization server, OIDC app, groups scope and
  claim, access policy, VirtualMCPServer YAML; uses the groups claim;
  documents API Access Management add-on requirement for custom AS

Both guides include consistency checklists (group name matching across
IdP, claim filter, and Cedar policies), deploy steps with a Kubernetes
secret for the client secret, and troubleshooting sections covering the
most common configuration mistakes.

Also: inbound links from guides-vmcp/authentication.mdx and intro.mdx,
nested "Identity provider integration" sub-category in sidebars.ts.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 27, 2026 21:40
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 27, 2026

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Apr 27, 2026 9:40pm

Request Review

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.

[Gap]: Improve Entra ID authentication docs for ToolHive

1 participant