docs: oauth2-provider fixes (#19170)

hugodutka · web-flow · commit c94333d9b5db · 2025-08-04T21:20:51.000+02:00
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.
diff --git 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
@@ -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
@@ -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"
 						}
 					]
 				},

Original file line number	Diff line number	Diff line change
`@@ -718,6 +718,11 @@`
`718`	`718`	`"title": "Hashicorp Vault",`
`719`	`719`	`"description": "Integrate Coder with Hashicorp Vault",`
`720`	`720`	`"path": "./admin/integrations/vault.md"`
	`721`	`+ },`
	`722`	`+ {`
	`723`	`+ "title": "OAuth2 Provider",`
	`724`	`+ "description": "Use Coder as an OAuth2 provider",`
	`725`	`+ "path": "./admin/integrations/oauth2-provider.md"`
`721`	`726`	`}`
`722`	`727`	`]`
`723`	`728`	`},`