Skip to content

Commit 9bab331

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 f9a7513 commit 9bab331

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",
@@ -213,10 +211,7 @@
213211
{
214212
"group": "Deployment",
215213
"icon": "truck-ramp-couch",
216-
"pages": [
217-
"router/deployment",
218-
"router/deployment/config-hot-reload"
219-
]
214+
"pages": ["router/deployment", "router/deployment/config-hot-reload"]
220215
},
221216
{
222217
"group": "Security",
@@ -232,22 +227,15 @@
232227
{
233228
"group": "Development",
234229
"icon": "flask-round-potion",
235-
"pages": [
236-
"router/development",
237-
"router/development/debugging",
238-
"router/development/development-mode"
239-
]
230+
"pages": ["router/development", "router/development/debugging", "router/development/development-mode"]
240231
},
241232
"router/request-deduplication",
242233
"router/performance-debugging",
243234
"router/advanced-request-tracing-art",
244235
{
245236
"group": "Query Plan",
246237
"icon": "file-contract",
247-
"pages": [
248-
"router/query-plan",
249-
"router/query-plan/batch-generate-query-plans"
250-
]
238+
"pages": ["router/query-plan", "router/query-plan/batch-generate-query-plans"]
251239
},
252240
{
253241
"group": "Cosmo Streams (EDFS)",
@@ -336,11 +324,7 @@
336324
{
337325
"group": "API Keys",
338326
"icon": "key",
339-
"pages": [
340-
"studio/api-keys",
341-
"studio/api-keys/api-key-permissions",
342-
"studio/api-keys/api-key-resources"
343-
]
327+
"pages": ["studio/api-keys", "studio/api-keys/api-key-permissions", "studio/api-keys/api-key-resources"]
344328
},
345329
"studio/migrate-from-apollo",
346330
{
@@ -375,11 +359,7 @@
375359
{
376360
"group": "SCIM",
377361
"icon": "file-user",
378-
"pages": [
379-
"studio/scim",
380-
"studio/scim/okta",
381-
"studio/scim/okta-oin-version"
382-
]
362+
"pages": ["studio/scim", "studio/scim/okta", "studio/scim/okta-oin-version"]
383363
},
384364
"studio/audit-log",
385365
"studio/cosmo-ai",
@@ -394,11 +374,7 @@
394374
},
395375
{
396376
"group": "Control Plane",
397-
"pages": [
398-
"control-plane/intro",
399-
"control-plane/configuration",
400-
"control-plane/webhooks"
401-
]
377+
"pages": ["control-plane/intro", "control-plane/configuration", "control-plane/webhooks"]
402378
},
403379
{
404380
"group": "GraphQL / Federation",
@@ -453,10 +429,7 @@
453429
{
454430
"group": "Terraform",
455431
"icon": "road-bridge",
456-
"pages": [
457-
"deployments-and-hosting/terraform",
458-
"deployments-and-hosting/terraform/aws-fargate"
459-
]
432+
"pages": ["deployments-and-hosting/terraform", "deployments-and-hosting/terraform/aws-fargate"]
460433
},
461434
"deployments-and-hosting/docker",
462435
"deployments-and-hosting/release-management",
@@ -548,11 +521,7 @@
548521
{
549522
"group": "Version",
550523
"icon": "code-branch",
551-
"pages": [
552-
"cli/monograph/version",
553-
"cli/monograph/version/get",
554-
"cli/monograph/version/set"
555-
]
524+
"pages": ["cli/monograph/version", "cli/monograph/version/get", "cli/monograph/version/set"]
556525
}
557526
]
558527
},
@@ -582,10 +551,7 @@
582551
{
583552
"group": "Compatibility version",
584553
"icon": "code-compare",
585-
"pages": [
586-
"cli/router/compatibility-version",
587-
"cli/router/compatibility-version/list"
588-
]
554+
"pages": ["cli/router/compatibility-version", "cli/router/compatibility-version/list"]
589555
},
590556
{
591557
"group": "Router Plugin",
@@ -619,12 +585,7 @@
619585
{
620586
"group": "Auth",
621587
"icon": "key",
622-
"pages": [
623-
"cli/auth",
624-
"cli/auth/login",
625-
"cli/auth/whoami",
626-
"cli/auth/logout"
627-
]
588+
"pages": ["cli/auth", "cli/auth/login", "cli/auth/whoami", "cli/auth/logout"]
628589
},
629590
{
630591
"group": "Operations",
@@ -668,11 +629,7 @@
668629
{
669630
"group": "Proposal",
670631
"icon": "file-circle-plus",
671-
"pages": [
672-
"cli/proposal",
673-
"cli/proposal/create",
674-
"cli/proposal/update"
675-
]
632+
"pages": ["cli/proposal", "cli/proposal/create", "cli/proposal/update"]
676633
}
677634
]
678635
}

0 commit comments

Comments
 (0)