Skip to content

docs(enterprise): Azure APIM deployment guide#2636

Merged
enesakar merged 2 commits into
masterfrom
ctx7-1655-docs-azure-apim
May 18, 2026
Merged

docs(enterprise): Azure APIM deployment guide#2636
enesakar merged 2 commits into
masterfrom
ctx7-1655-docs-azure-apim

Conversation

@fahreddinozcan
Copy link
Copy Markdown
Contributor

Summary

  • Step-by-step guide for deploying Context7 behind Azure API Management with Microsoft Entra ID per-user auth (On-Behalf-Of token exchange).
  • Covers APIM provisioning, Entra app registrations, policy wiring (with named-value resolution + XML escape gotchas documented), OAuth discovery surfaces (PRM + AS metadata), and connecting MCP clients through the gateway.
  • Split from feat(mcp): multi-tenant Entra ID validation #2629 so it can land first and be shared with the customer ahead of the MCP code changes.

Test plan

  • Mintlify renders the new page under Enterprise → Azure APIM
  • Mermaid sequence diagram renders correctly
  • Internal links resolve

Step-by-step guide for deploying Context7 behind Azure API Management
with Microsoft Entra ID per-user authentication via On-Behalf-Of (OBO)
token exchange. Covers APIM provisioning, Entra app registrations,
policy wiring, OAuth discovery surfaces, and connecting MCP clients
(VS Code Copilot, Cursor) through the gateway.
@linear
Copy link
Copy Markdown

linear Bot commented May 18, 2026

CTX7-1655

@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 18, 2026

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

Project Status Preview Updated (UTC)
context7 🟢 Ready View Preview May 18, 2026, 3:51 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

- Restructure Part 4 into two steps: tenant config + pre-provisioning
  users via the new dashboard card. Calls out that Context7 rejects
  unmapped oids — there is no auto-provisioning.
- Add troubleshooting entry for the unmapped-user 401 (most common
  failure once tenant config is correct).
- Fix \$APIM_NAME → \$APIM typo in the OAuth proxy provisioning
  commands; the rest of the doc uses \$APIM so the OAuth proxy
  commands would have failed as written.
@enesakar enesakar merged commit 6f0f8b7 into master May 18, 2026
3 of 4 checks passed
@enesakar enesakar deleted the ctx7-1655-docs-azure-apim branch May 18, 2026 15:59
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