Skip to content

Add GitHub OAuth Provider tutorial#19

Merged
micheleRP merged 5 commits into
mainfrom
docs/github-oauth-tutorial
May 12, 2026
Merged

Add GitHub OAuth Provider tutorial#19
micheleRP merged 5 commits into
mainfrom
docs/github-oauth-tutorial

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented May 12, 2026

Preview pages

Summary

Add comprehensive tutorial for setting up GitHub OAuth provider and creating user-delegated GitHub MCP server in ADP.

Changes

  • New tutorial: modules/mcp/pages/github-oauth-tutorial.adoc

    • Complete end-to-end workflow from creating GitHub OAuth app to testing MCP server
    • Field-by-field guidance for OAuth provider configuration
    • Covers testing in My Connections before creating MCP server
    • Includes troubleshooting section with common issues
    • Follows docs-team-standards (no "via", no step numbering, active voice)
  • Navigation update: modules/ROOT/nav.adoc

    • Nest tutorial under "User-delegated OAuth" section
    • Logical ordering: OAuth Providers → User-delegated OAuth → Tutorial

Tutorial sections

  1. Create GitHub OAuth App
  2. Store Client Secret in ADP
  3. Create OAuth Provider in ADP
  4. Test connection in My Connections (optional but recommended)
  5. Create GitHub MCP Server with user-delegated OAuth
  6. Verify the MCP server works
  7. Troubleshooting
  8. Next steps
  9. Related topics

Learning objectives

  • Create a GitHub OAuth app and register it as an OAuth provider in ADP
  • Test the OAuth connection proactively using My Connections
  • Create and configure a GitHub managed MCP server with user-delegated OAuth

🤖 Generated with Claude Code

Add comprehensive tutorial for setting up GitHub OAuth provider and MCP server with user-delegated OAuth.

- Create new tutorial at modules/mcp/pages/github-oauth-tutorial.adoc
- Cover complete workflow: create OAuth app, register provider, test in My Connections, create MCP server
- Include field-by-field guidance for all configuration steps
- Add troubleshooting section and related topics
- Nest tutorial under User-delegated OAuth in navigation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@micheleRP micheleRP requested a review from a team as a code owner May 12, 2026 02:59
@netlify
Copy link
Copy Markdown

netlify Bot commented May 12, 2026

Deploy Preview for redpanda-agentic-data-plane ready!

Name Link
🔨 Latest commit 43cb382
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a038b5e07842300083daea0
😎 Deploy Preview https://deploy-preview-19--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

micheleRP and others added 2 commits May 11, 2026 21:10
Applied docs-team-standards review feedback: removed 'Copy it for later' as it's redundant with the instruction to 'note' the Client ID.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Restoring the phrase per user feedback - it provides helpful context for users.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@johnkennedy-cmyk
Copy link
Copy Markdown

1 and 2 can be combined, as you can create a new secret within the flow for OAuth provider creation.

micheleRP and others added 2 commits May 12, 2026 10:38
The Create OAuth Provider UI now includes an inline Client Secret Ref
field with New/Existing tabs, so users can create the secret directly
in the provider form without a separate Secrets Store visit first.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@micheleRP micheleRP merged commit 7363a67 into main May 12, 2026
4 checks passed
@micheleRP micheleRP deleted the docs/github-oauth-tutorial branch May 12, 2026 20:24
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