Skip to content

Commit 50ee195

Browse files
asoormasoorm
committed
docs(mcp): restructure MCP docs and add OAuth 2.1 authorization (ENG-9125)
Restructure MCP docs from single page into multi-page architecture (overview, quickstart, operations, configuration, oauth, ide-setup). Add OAuth 2.1 scope enforcement docs with JWKS config, multi-level scope gates, step-up authorization, and RFC 9728 metadata discovery. Ported from wundergraph/cosmo-docs#260.
1 parent 4e2b146 commit 50ee195

7 files changed

Lines changed: 1107 additions & 469 deletions

File tree

‎docs-website/docs.json‎

Lines changed: 30 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,10 @@
2626
"codeblocks": "system",
2727
"eyebrows": "breadcrumbs"
2828
},
29-
"banner": {
30-
"content": "Help map how teams scale Federated GraphQL in the State of Federation 2026 Survey. We donate $30 to UNICEF per response → [Take the survey](https://8bxwlo3ot55.typeform.com/to/zIJKRQUe).",
31-
"dismissible": false
32-
},
29+
"banner": {
30+
"content": "Help map how teams scale Federated GraphQL in the State of Federation 2026 Survey. We donate $30 to UNICEF per response → [Take the survey](https://8bxwlo3ot55.typeform.com/to/zIJKRQUe).",
31+
"dismissible": false
32+
},
3333
"contextual": {
3434
"options": ["copy", "view", "chatgpt", "claude"]
3535
},
@@ -41,13 +41,7 @@
4141
"groups": [
4242
{
4343
"group": " ",
44-
"pages": [
45-
"overview",
46-
"architecture",
47-
"enterprise",
48-
"security-and-compliance",
49-
"self-hosted"
50-
]
44+
"pages": ["overview", "architecture", "enterprise", "security-and-compliance", "self-hosted"]
5145
},
5246
{
5347
"group": "Getting Started",
@@ -70,11 +64,7 @@
7064
},
7165
{
7266
"group": "Cosmo Connect",
73-
"pages": [
74-
"connect/overview",
75-
"connect/plugins",
76-
"connect/grpc-services"
77-
]
67+
"pages": ["connect/overview", "connect/plugins", "connect/grpc-services"]
7868
},
7969
{
8070
"group": "Cosmo ConnectRPC",
@@ -102,15 +92,23 @@
10292
"router/configuration/template-expressions"
10393
]
10494
},
105-
"router/mcp",
10695
{
107-
"group": "Custom Modules",
108-
"icon": "cubes",
96+
"group": "MCP Gateway",
97+
"icon": "robot",
10998
"pages": [
110-
"router/custom-modules",
111-
"router/custom-modules-migration"
99+
"router/mcp",
100+
"router/mcp/quickstart",
101+
"router/mcp/operations",
102+
"router/mcp/configuration",
103+
"router/mcp/oauth",
104+
"router/mcp/ide-setup"
112105
]
113106
},
107+
{
108+
"group": "Custom Modules",
109+
"icon": "cubes",
110+
"pages": ["router/custom-modules", "router/custom-modules-migration"]
111+
},
114112
{
115113
"group": "Cosmo Connect",
116114
"icon": "network-wired",
@@ -214,10 +212,7 @@
214212
{
215213
"group": "Deployment",
216214
"icon": "truck-ramp-couch",
217-
"pages": [
218-
"router/deployment",
219-
"router/deployment/config-hot-reload"
220-
]
215+
"pages": ["router/deployment", "router/deployment/config-hot-reload"]
221216
},
222217
{
223218
"group": "Security",
@@ -233,22 +228,15 @@
233228
{
234229
"group": "Development",
235230
"icon": "flask-round-potion",
236-
"pages": [
237-
"router/development",
238-
"router/development/debugging",
239-
"router/development/development-mode"
240-
]
231+
"pages": ["router/development", "router/development/debugging", "router/development/development-mode"]
241232
},
242233
"router/request-deduplication",
243234
"router/performance-debugging",
244235
"router/advanced-request-tracing-art",
245236
{
246237
"group": "Query Plan",
247238
"icon": "file-contract",
248-
"pages": [
249-
"router/query-plan",
250-
"router/query-plan/batch-generate-query-plans"
251-
]
239+
"pages": ["router/query-plan", "router/query-plan/batch-generate-query-plans"]
252240
},
253241
{
254242
"group": "Cosmo Streams (EDFS)",
@@ -337,11 +325,7 @@
337325
{
338326
"group": "API Keys",
339327
"icon": "key",
340-
"pages": [
341-
"studio/api-keys",
342-
"studio/api-keys/api-key-permissions",
343-
"studio/api-keys/api-key-resources"
344-
]
328+
"pages": ["studio/api-keys", "studio/api-keys/api-key-permissions", "studio/api-keys/api-key-resources"]
345329
},
346330
"studio/migrate-from-apollo",
347331
{
@@ -376,11 +360,7 @@
376360
{
377361
"group": "SCIM",
378362
"icon": "file-user",
379-
"pages": [
380-
"studio/scim",
381-
"studio/scim/okta",
382-
"studio/scim/okta-oin-version"
383-
]
363+
"pages": ["studio/scim", "studio/scim/okta", "studio/scim/okta-oin-version"]
384364
},
385365
"studio/audit-log",
386366
"studio/cosmo-ai",
@@ -395,11 +375,7 @@
395375
},
396376
{
397377
"group": "Control Plane",
398-
"pages": [
399-
"control-plane/intro",
400-
"control-plane/configuration",
401-
"control-plane/webhooks"
402-
]
378+
"pages": ["control-plane/intro", "control-plane/configuration", "control-plane/webhooks"]
403379
},
404380
{
405381
"group": "GraphQL / Federation",
@@ -458,10 +434,7 @@
458434
{
459435
"group": "Terraform",
460436
"icon": "road-bridge",
461-
"pages": [
462-
"deployments-and-hosting/terraform",
463-
"deployments-and-hosting/terraform/aws-fargate"
464-
]
437+
"pages": ["deployments-and-hosting/terraform", "deployments-and-hosting/terraform/aws-fargate"]
465438
},
466439
"deployments-and-hosting/docker",
467440
"deployments-and-hosting/release-management",
@@ -553,11 +526,7 @@
553526
{
554527
"group": "Version",
555528
"icon": "code-branch",
556-
"pages": [
557-
"cli/monograph/version",
558-
"cli/monograph/version/get",
559-
"cli/monograph/version/set"
560-
]
529+
"pages": ["cli/monograph/version", "cli/monograph/version/get", "cli/monograph/version/set"]
561530
}
562531
]
563532
},
@@ -587,10 +556,7 @@
587556
{
588557
"group": "Compatibility version",
589558
"icon": "code-compare",
590-
"pages": [
591-
"cli/router/compatibility-version",
592-
"cli/router/compatibility-version/list"
593-
]
559+
"pages": ["cli/router/compatibility-version", "cli/router/compatibility-version/list"]
594560
},
595561
{
596562
"group": "Router Plugin",
@@ -624,12 +590,7 @@
624590
{
625591
"group": "Auth",
626592
"icon": "key",
627-
"pages": [
628-
"cli/auth",
629-
"cli/auth/login",
630-
"cli/auth/whoami",
631-
"cli/auth/logout"
632-
]
593+
"pages": ["cli/auth", "cli/auth/login", "cli/auth/whoami", "cli/auth/logout"]
633594
},
634595
{
635596
"group": "Operations",
@@ -673,11 +634,7 @@
673634
{
674635
"group": "Proposal",
675636
"icon": "file-circle-plus",
676-
"pages": [
677-
"cli/proposal",
678-
"cli/proposal/create",
679-
"cli/proposal/update"
680-
]
637+
"pages": ["cli/proposal", "cli/proposal/create", "cli/proposal/update"]
681638
}
682639
]
683640
}

0 commit comments

Comments
 (0)