OSDOCS-18127: adds MCP gateway spine to RHCL docs

ShaunaDiaz · ShaunaDiaz · commit 66809c8278ec · 2026-03-27T14:13:33.000-04:00
diff --git a/_attributes/attributes.adoc b/_attributes/attributes.adoc
@@ -10,6 +10,7 @@
 :prodname: Connectivity Link
 :prodnamefull: {rh} {prodname}
 :productpkg: red_hat_connectivity_link
+:mcpg: MCP gateway
 
 :version: 1.3
 :version-1: 1.2.x
diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
@@ -23,12 +23,21 @@
 # topic groups and topics on the main page.
 
 ---
-Name: Discover
+Name: Red Hat Connectivity Link
 Dir: introduction
 Distros: rhcl
 Topics:
 - Name: About Red Hat Connectivity Link
-  File: introduction
+  File: rhcl-introduction
+---
+Name: MCP gateway
+Dir: mcp_gateway_discover
+Distros: rhcl
+Topics:
+- Name: About the MCP gateway
+  File: mcp-gateway-introduction
+- Name: MCP gateway architecture
+  File: mcp-gateway-architecture
 ---
 Name: What's New
 Dir: release_notes
@@ -37,13 +46,22 @@ Topics:
 - Name: Red Hat Connectivity Link Release Notes
   File: rhcl-release-notes
 ---
-Name: Installing on OpenShift Container Platform
+Name: Installing Connectivity Link
 Dir: install-guide
 Distros: rhcl
 Topics:
 - Name: Installing on OpenShift Container Platform
   File: install-guide
 ---
+Name: Installing the MCP gateway
+Dir: mcp_gateway_install
+Distros: rhcl
+Topics:
+- Name: Getting started with the MCP gateway
+  File: mcp-gateway-get-started
+- Name: Installing MCP gateway
+  File: mcp-gateway-install
+---
 Name: Configuring and deploying gateway policies
 Dir: deployment
 Distros: rhcl
@@ -53,16 +71,54 @@ Topics:
 - Name: Using on-premise DNS with CoreDNS
   File: coredns
 ---
+Name: Configure MCP gateway and register servers
+Dir: mcp_gateway_config
+Distros: rhcl
+Topics:
+- Name: Configuring the MCP gateway
+  File: mcp-gateway-configure
+- Name: Register MCP servers
+  File: mcp-gateway-register-servers
+---
 Name: Observability
 Dir: observability
 Distros: rhcl
 Topics:
 - Name: Observability
   File: observability
 ---
+Name: Observing MCP gateway
+Dir: mcp_gateway_observability
+Distros: rhcl
+Topics:
+- Name: Observing MCP gateway
+  File: mcp-gateway-observe
+---
 Name: Updating Red Hat Connectivity Link
 Dir: updating
 Distros: rhcl
 Topics:
 - Name: Updating Red Hat Connectivity Link
   File: updating-rhcl
+---
+Name: Securing your gateways
+Dir: security
+Distros: rhcl
+Topics:
+# do we want to move rhcl policies here?
+- Name: mcp-gateway-authz
+  File: mcp-gateway-authz
+- Name: mcp-gateway-authn
+  File: mcp-gateway-authn
+- Name: Using Vault
+  File: mcp-gateway-vault
+---
+Name: Troubleshooting and getting support
+Dir: troubleshoot_support
+Distros: rhcl
+Topics:
+# rhcl? doc gap here
+- Name: Troubleshooting MCP gateway
+  File: mcp-gateway-troubleshooting
+- Name: Troubleshooting Connectivity Link
+  File: rhcl-troubleshooting
diff --git a/install-guide/install-guide.adoc b/install-guide/install-guide.adoc
@@ -60,5 +60,5 @@ include::modules/using-your-subscription.adoc[leveloffset=+1]
 [id="addtional-resources_rhcl-install"]
 [role="_additional-resources"]
 == Additional resources
-* xref:../introduction/introduction.adoc#con-connectivity-link-supported-configs_rhcl-introduction[Supported Configurations for {product-title}]
+* xref:../introduction/rhcl-introduction.adoc#con-connectivity-link-supported-configs_rhcl-introduction[Supported Configurations for {product-title}]
 * https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-latest-version}/html/operators/index[OpenShift Operators]
diff --git a/introduction/rhcl-introduction.adoc b/introduction/rhcl-introduction.adoc
@@ -3,7 +3,6 @@ include::_attributes/attributes.adoc[]
 [id="rhcl-introduction"]
 = Introduction to {prodname}
 :context: rhcl-introduction
-//toc:[]
 
 [role="_abstract"]
 {product-title} is a control plane for configuring the Gateway API data plane in {ocp} clusters. You can use it to apply authentication, rate limiting, and DNS policies to gateway resources.
@@ -33,6 +32,6 @@ include::modules/con-connectivity-link-supported-configs.adoc[leveloffset=+1]
 == Additional resources
 
 * link:https://developers.redhat.com/products/red-hat-connectivity-link[Red Hat Connectivity Link]
-* link:https://docs.redhat.com/en/documentation/openshift_container_platform/4.20/html-single/ingress_and_load_balancing/index#ingress-gateway-api[Gateway API with OpenShift Container Platform networking]
+* link:https://docs.redhat.com/en/documentation/openshift_container_platform/4.21/html-single/ingress_and_load_balancing/index#ingress-gateway-api[Gateway API with OpenShift Container Platform networking]
 * link:https://docs.redhat.com/en/documentation/red_hat_openshift_service_mesh/[Red Hat OpenShift Service Mesh 3.2 documentation]
 
diff --git a/mcp_gateway_config/_attributes b/mcp_gateway_config/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/mcp_gateway_config/images b/mcp_gateway_config/images
@@ -0,0 +1 @@
+../images/
diff --git a/mcp_gateway_config/mcp-gateway-configure.adoc b/mcp_gateway_config/mcp-gateway-configure.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-config-listener-route"]
+= Configuring the MCP gateway listener and route
+:context: mcp-gateway-config-listener-route
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_config/mcp-gateway-register-servers.adoc b/mcp_gateway_config/mcp-gateway-register-servers.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-register-servers"]
+= Registering MCP servers
+:context: mcp-gateway-register-servers
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_config/modules b/mcp_gateway_config/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/mcp_gateway_config/snippets b/mcp_gateway_config/snippets
@@ -0,0 +1 @@
+../snippets/
diff --git a/mcp_gateway_discover/_attributes b/mcp_gateway_discover/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/mcp_gateway_discover/images b/mcp_gateway_discover/images
@@ -0,0 +1 @@
+../images/
diff --git a/mcp_gateway_discover/mcp-gateway-architecture.adoc b/mcp_gateway_discover/mcp-gateway-architecture.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-architecture"]
+= {mcpg} architecture
+:context: mcp-gateway-architecture
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_discover/mcp-gateway-introduction.adoc b/mcp_gateway_discover/mcp-gateway-introduction.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-introduction"]
+= Introduction to {mcpg}
+:context: mcp-gateway-introduction
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_discover/modules b/mcp_gateway_discover/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/mcp_gateway_discover/snippets b/mcp_gateway_discover/snippets
@@ -0,0 +1 @@
+../snippets/
diff --git a/mcp_gateway_install/_attributes b/mcp_gateway_install/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/mcp_gateway_install/images b/mcp_gateway_install/images
@@ -0,0 +1 @@
+../images/
diff --git a/mcp_gateway_install/mcp-gateway-get-started.adoc b/mcp_gateway_install/mcp-gateway-get-started.adoc
@@ -0,0 +1,9 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-get-started"]
+= Getting started with {mcpg}
+:context: mcp-gateway-get-started
+//toc:[]
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_install/mcp-gateway-install.adoc b/mcp_gateway_install/mcp-gateway-install.adoc
@@ -0,0 +1,9 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-install"]
+= Installing {mcpg}
+:context: mcp-gateway-get-install
+//toc:[]
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_install/modules b/mcp_gateway_install/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/mcp_gateway_install/snippets b/mcp_gateway_install/snippets
@@ -0,0 +1 @@
+../snippets/
diff --git a/mcp_gateway_observability/_attributes b/mcp_gateway_observability/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/mcp_gateway_observability/images b/mcp_gateway_observability/images
@@ -0,0 +1 @@
+../images/
diff --git a/mcp_gateway_observability/mcp-gateway-observe.adoc b/mcp_gateway_observability/mcp-gateway-observe.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-observe"]
+= Getting started with {mcpg}
+:context: mcp-gateway-observe
+
+[role="_abstract"]
+FPO assembly
diff --git a/mcp_gateway_observability/modules b/mcp_gateway_observability/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/mcp_gateway_observability/snippets b/mcp_gateway_observability/snippets
@@ -0,0 +1 @@
+../snippets/
diff --git a/security/_attributes b/security/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/security/images b/security/images
@@ -0,0 +1 @@
+../images/
diff --git a/security/mcp-gateway-authn.adoc b/security/mcp-gateway-authn.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-authn"]
+= AuthN with {mcpg}
+:context: mcp-gateway-authn
+
+[role="_abstract"]
+FPO assembly
diff --git a/security/mcp-gateway-authz.adoc b/security/mcp-gateway-authz.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-authz"]
+= AuthZ with {mcpg}
+:context: mcp-gateway-authz
+
+[role="_abstract"]
+FPO assembly
diff --git a/security/mcp-gateway-vault.adoc b/security/mcp-gateway-vault.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-vault"]
+= Vault with {mcpg}
+:context: mcp-gateway-vault
+
+[role="_abstract"]
+FPO assembly
diff --git a/security/modules b/security/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/security/snippets b/security/snippets
@@ -0,0 +1 @@
+../snippets/
diff --git a/troubleshoot_support/_attributes b/troubleshoot_support/_attributes
@@ -0,0 +1 @@
+../_attributes/
diff --git a/troubleshoot_support/images b/troubleshoot_support/images
@@ -0,0 +1 @@
+../images/
diff --git a/troubleshoot_support/mcp-gateway-troubleshooting.adoc b/troubleshoot_support/mcp-gateway-troubleshooting.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-troubleshooting"]
+= Troubleshooting and support for {mcpg}
+:context: mcp-gateway-troubleshooting
+
+[role="_abstract"]
+FPO assembly
diff --git a/troubleshoot_support/modules b/troubleshoot_support/modules
@@ -0,0 +1 @@
+../modules/
diff --git a/troubleshoot_support/rhcl-troubleshooting.adoc b/troubleshoot_support/rhcl-troubleshooting.adoc
@@ -0,0 +1,8 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="rhcl-troubleshooting"]
+= Troubleshooting and support for {prodname}
+:context: rhcl-troubleshooting
+
+[role="_abstract"]
+FPO assembly
diff --git a/troubleshoot_support/snippets b/troubleshoot_support/snippets
@@ -0,0 +1 @@
+../snippets/
