More updates

Author: irvinebroque

src/content/docs/agents/model-context-protocol/mcp-server/authentication/index.mdx

@@ -0,0 +1,17 @@
+---
+title: Authentication
+sidebar:
+  order: 4
+  group:
+    hideIndex: false
+---
+
+import { DirectoryListing } from "~/components";
+
+WIP
+
+Explain / reiterate difference between authN and authz
+
+This section should have some examples of using other services / libraries for authentication.
+
+It should show you how to rip out the mock auth from the example project, and replace it with your own.

src/content/docs/agents/model-context-protocol/mcp-server/authorization/index.mdx

@@ -16,9 +16,9 @@ When building a [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
 
 The Model Context Protocol uses [a subset of OAuth 2.1 for authorization](https://spec.modelcontextprotocol.io/specification/draft/basic/authorization/). OAuth allows your users to grant limited access to resources, without them having to share API keys or other credentials.
 
-Cloudflare provides an OAuth SDK that implements the provider side of the OAuth 2.1 protocol, allowing you to easily add authorization to your MCP server.
+Cloudflare provides an [OAuth Provider Library](https://github.com/geelen/mcp-remote-examples/tree/main/.vendor/workers-oauth-provider) that implements the provider side of the OAuth 2.1 protocol, allowing you to easily add authorization to your MCP server.
 
-You can use the OAuth SDK in three ways:
+You can use the OAuth Provider Library in three ways:
 
 1. **Your Worker handles authorization itself.** Your MCP server, running on Cloudflare, handles the complete OAuth flow. ([Example](/agents/model-context-protocol/mcp-server/getting-started/))
 2. **Integrate with a third-party OAuth provider**, such as GitHub or Google. ([Example](/agents/model-context-protocol/mcp-server/examples/third-party-oauth-provider/))
@@ -30,12 +30,12 @@ The following sections describe each of these options and link to runnable code
 
 ### (1) Your MCP Server handles authorization itself
 
-Your MCP Server, using the Cloudflare MCP Server and OAuth Provider SDKs, can handle the complete OAuth authorization flow, without any third-party involvement.
+Your MCP Server, using the Cloudflare [MCP Server SDK](/agents/model-context-protocol/mcp-server/getting-started/) and [OAuth Provider Library](/agents/model-context-protocol/mcp-server/authorization/oauth-provider-api-reference/), can handle the complete OAuth authorization flow, without any third-party involvement.
 
-The [Workers OAuth Provider SDK](/agents/model-context-protocol/mcp-server/authorization/oauth-sdk/) is a Cloudflare Worker that implements a [`fetch()` handler](/workers/runtime-apis/handlers/fetch/), and handles incoming requests to your MCP server. You provide your own handlers for your MCP Server's API, and autentication and authorization logic, and URI paths for the OAuth endpoints, and the SDK handles the rest.
+The [Workers OAuth Provider Library](/agents/model-context-protocol/mcp-server/authorization/oauth-provider-api-reference/) is a Cloudflare Worker that implements a [`fetch()` handler](/workers/runtime-apis/handlers/fetch/), and handles incoming requests to your MCP server. You provide your own handlers for your MCP Server's API, and autentication and authorization logic, and URI paths for the OAuth endpoints, and the SDK handles the rest.
 
 {/* TODO: Update link */}
-The OAuth Provider SDK comes with an [example handler implementation](https://github.com/geelen/mcp-remote-examples/tree/main/02-user-password/src/routes) for autentication and authorization, referenced below as `defaultHandler`:
+The OAuth Provider Library comes with an [example handler implementation](https://github.com/geelen/mcp-remote-examples/tree/main/02-user-password/src/routes) for autentication and authorization, referenced below as `defaultHandler`:
 
 {/* TODO: GithubCodeComponent */}
 
@@ -82,7 +82,7 @@ For a step-by-step example, refer to the [Worker as OAuth Provider](/agents/mode
 
 ### (2) Third-party OAuth Provider
 
-The OAuth Provider SDK can be configured to use a third-party OAuth provider, such as [GitHub](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) or [Google](https://developers.google.com/identity/protocols/oauth2).
+The OAuth Provider Library can be configured to use a third-party OAuth provider, such as [GitHub](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) or [Google](https://developers.google.com/identity/protocols/oauth2).
 
 When you use a third-party OAuth provider, you must provide a handler to the `OAuthProvider` that implements the OAuth flow for the third-party provider.
 
@@ -128,19 +128,19 @@ sequenceDiagram
     M->>C: MCP access token
 ```
 
-Read the docs for the [Workers oAuth Provider SDK](/agents/model-context-protocol/mcp-server/authorization/oauth-sdk/) for more details.
+Read the docs for the [Workers oAuth Provider Library](/agents/model-context-protocol/mcp-server/authorization/oauth-provider-api-reference/) for more details.
 
 ### (3) Bring your own OAuth Provider
 
-If your application already implements an Oauth Provider itself, or you use Stytch, Auth0, or authorization-as-a-service provider, you can use this in the same way that you would use a third-party OAuth provider, described above.
+If your application already implements an Oauth Provider itself, or you use Stytch, Auth0, or authorization-as-a-service provider, you can use this in the same way that you would use a third-party OAuth provider, described above in (2).
 
-The following examples show how to use the OAuth Provider SDK with an external OAuth provider:
+The following examples show how to use the OAuth Provider Library with an external OAuth provider:
 
 - [Stytch](/agents/model-context-protocol/mcp-server/examples/stytch/)
 - [Auth0](/agents/model-context-protocol/mcp-server/examples/auth0/)
 
 ## Next steps
 
-- [Learn how to use the OAuth Provider SDK](/agents/model-context-protocol/mcp-server/authorization/oauth-sdk/)
+- [Learn how to use the OAuth Provider SDK](/agents/model-context-protocol/mcp-server/authorization/oauth-provider-api-reference/)
 - [Learn how to use a third-party OAuth provider](/agents/model-context-protocol/mcp-server/examples/third-party-oauth-provider/)
 - [Learn how to bring your own OAuth provider](/agents/model-context-protocol/mcp-server/examples/external-oauth-provider/)

src/content/docs/agents/model-context-protocol/mcp-server/authorization/oauth-provider-api-reference.mdx

@@ -0,0 +1,9 @@
+---
+pcx_content_type: navigation
+title: OAuth Provider Library
+# TODO: Update link to published library
+external_link: https://github.com/geelen/mcp-remote-examples/tree/main/.vendor/workers-oauth-provider
+sidebar:
+  order: 5
+head: []
+---

src/content/docs/agents/model-context-protocol/mcp-server/authorization/oauth-sdk.mdx

@@ -9,6 +9,10 @@ import { Render, GitHubCode } from "~/components";
 
 {/* TODO: Why doesn't GitHub Code Component work? */}
 
+WIP
+
+Refer to the [GitHub OAuth Provider example](https://github.com/geelen/mcp-remote-examples/tree/main/04-oauth-pivot) for a complete example of how to use a third-party OAuth provider with the MCP Server SDK.
+
 ```ts
 import OAuthProvider, {
 	AuthRequest,