Skip to content

docs(okta): expand the Okta MCP server setup page - #431

Open
leet-c1 wants to merge 1 commit into
mainfrom
leet/okta-mcp-docs
Open

docs(okta): expand the Okta MCP server setup page#431
leet-c1 wants to merge 1 commit into
mainfrom
leet/okta-mcp-docs

Conversation

@leet-c1

@leet-c1 leet-c1 commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Expands the Okta MCP server setup page with accurate scope documentation and a tighter app-creation flow. Okta isn't multi-product like the Google Cloud setup guide, so this stays a single, detailed page.

What changed

  • New "Okta API scopes" section — a table of the 15 read scopes C1 requests by default and what each grants, sourced from Okta's scope definitions. Notes that these are Okta administrator scopes (each token is limited by the authorizing account's admin role) and how to add okta.*.manage scopes to enable write tools.
  • Precise OIDC app steps — grant scopes on the app's Okta API Scopes tab (the step the page previously glossed over), the exact redirect URI, client ID/secret retrieval, and links to Okta's Create OIDC app + OAuth for Okta docs.
  • Clearer auth choice — read-only by default, with guidance on per-user OAuth vs service mode given that Okta management scopes require an admin role.

Verified with mint broken-links (no new broken links; in-page anchors resolve). Scope set and read-only default reflect the connector's configured scopes.

Opening as a draft for review.

@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jul 30, 2026, 12:05 AM

Add accurate Okta API scope documentation and tighten the OIDC app setup:
- New "Okta API scopes" section: a table of the 15 default read scopes and
  what each grants, a note that they are Okta administrator scopes limited by
  the authorizing account's admin role, and how to add okta.*.manage scopes
  for write tools.
- Precise app-creation steps: grant scopes on the app's "Okta API Scopes" tab,
  the exact redirect URI, and client ID/secret retrieval.
- Clarify the read-only default and the per-user vs service-mode choice given
  that Okta management scopes require an admin role.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@leet-c1
leet-c1 force-pushed the leet/okta-mcp-docs branch from fae73c6 to 265daa4 Compare July 30, 2026 00:11
@leet-c1
leet-c1 requested a review from socialyadept July 30, 2026 00:12
@leet-c1
leet-c1 marked this pull request as ready for review July 30, 2026 00:12
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