openshift · ShaunaDiaz · Mar 6, 2026
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,27 +23,47 @@
 # 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
 ---
+Name: MCP gateway
+Dir: mcp_gateway_discover
+Distros: rhcl
+Topics:
+- Name: Introduction to the MCP gateway
+  File: mcp-gateway-introduction
+- Name: MCP gateway architecture
+  File: mcp-gateway-architecture
+---
 Name: What's New
 Dir: release_notes
 Distros: rhcl
 Topics:
 - Name: Red Hat Connectivity Link Release Notes
   File: rhcl-release-notes
+#- Name: MCP gateway release notes
+#  File: mcp-gateway-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 MCP gateway
+Dir: mcp_gateway_install
+Distros: rhcl
+Topics:
+- Name: Getting started with 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 +73,55 @@ Topics:
 - Name: Using on-premise DNS with CoreDNS
   File: coredns
 ---
+Name: Configure MCP gateway and register servers
+Dir: mcp_gateway_config
+Distros: rhcl
+Topics:
+# this might not be two topics; might just be register servers
+#- Name: Configuring 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/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-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,9 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-architecture"]
+= {mcpg} architecture
+:context: mcp-gateway-architecture
+//toc:[]
+
+[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,9 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/attributes.adoc[]
+[id="mcp-gateway-introduction"]
+= Introduction to {mcpg}
+:context: mcp-gateway-introduction
+//toc:[]
+
+[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/