From c94333d9b5db165fcaf449b1e19159d98c308f17 Mon Sep 17 00:00:00 2001 From: Hugo Dutka Date: Mon, 4 Aug 2025 21:20:51 +0200 Subject: [PATCH] docs: oauth2-provider fixes (#19170) Adds the oauth2-provider doc page to the manifest so it's rendered in the docs, fixes formatting in the oauth2-provider doc, and links to it from the MCP doc. To see the formatting issues, visit https://coder.com/docs/@4bcf44a/admin/integrations/oauth2-provider. To see the doc after the fixes, visit https://coder.com/docs/@f05969a/admin/integrations/oauth2-provider. --- docs/admin/integrations/oauth2-provider.md | 9 +++------ docs/ai-coder/mcp-server.md | 2 +- docs/manifest.json | 5 +++++ 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/admin/integrations/oauth2-provider.md b/docs/admin/integrations/oauth2-provider.md index fb98e1520b..e526490429 100644 --- a/docs/admin/integrations/oauth2-provider.md +++ b/docs/admin/integrations/oauth2-provider.md @@ -1,7 +1,6 @@ # OAuth2 Provider (Experimental) -> ⚠️ **Experimental Feature** -> +> [!WARNING] > The OAuth2 provider functionality is currently **experimental and unstable**. This feature: > > - Is subject to breaking changes without notice @@ -232,8 +231,6 @@ This implementation follows established OAuth2 standards including [RFC 6749](ht - Check [External Authentication](../external-auth/index.md) for configuring Coder as an OAuth2 client - See [Security Best Practices](../security/index.md) for deployment security guidance ---- +## Feedback -> 📝 **Feedback** -> -> This is an experimental feature under active development. Please report issues and feedback through [GitHub Issues](https://github.com/coder/coder/issues) with the `oauth2` label. +This is an experimental feature under active development. Please report issues and feedback through [GitHub Issues](https://github.com/coder/coder/issues) with the `oauth2` label. diff --git a/docs/ai-coder/mcp-server.md b/docs/ai-coder/mcp-server.md index e4ce4c25d7..fdfadb4117 100644 --- a/docs/ai-coder/mcp-server.md +++ b/docs/ai-coder/mcp-server.md @@ -55,4 +55,4 @@ https://coder.example.com/api/experimental/mcp/http > [!NOTE] > At this time, the remote MCP server is not compatible with web-based ChatGPT. -Users can authenticate applications to use the remote MCP server with OAuth2. An authenticated application can perform any action on the user's behalf. Fine-grained permissions are in development. +Users can authenticate applications to use the remote MCP server with [OAuth2](../admin/integrations/oauth2-provider.md). An authenticated application can perform any action on the user's behalf. Fine-grained permissions are in development. diff --git a/docs/manifest.json b/docs/manifest.json index 189614f919..a8dffe2f7a 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -718,6 +718,11 @@ "title": "Hashicorp Vault", "description": "Integrate Coder with Hashicorp Vault", "path": "./admin/integrations/vault.md" + }, + { + "title": "OAuth2 Provider", + "description": "Use Coder as an OAuth2 provider", + "path": "./admin/integrations/oauth2-provider.md" } ] },