From 905abb230976d6c4e1c91fae6cba29f146c5219a Mon Sep 17 00:00:00 2001 From: Kat Batuigas Date: Mon, 20 Jul 2026 13:45:42 -0700 Subject: [PATCH 1/2] docs(cloud-dataplane): hide deprecated Remote MCP endpoints via overlay Add cloud-dataplane/overlays/hide-remote-mcp.yaml to remove the deprecated Remote MCP endpoint group (paths under /v1/redpanda-connect/mcp-servers, the "Remote MCP" tag, and MCP-only component schemas) from the published Cloud Data Plane API reference. The reference is generated from the cloudv2 OpenAPI source, so this overlay is an interim docs-only hide until the endpoints are removed at the source. Auto-applied by determine-overlays.sh + bump.yml. DOC-2382 Co-Authored-By: Claude Opus 4.8 (1M context) --- cloud-dataplane/overlays/hide-remote-mcp.yaml | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 cloud-dataplane/overlays/hide-remote-mcp.yaml diff --git a/cloud-dataplane/overlays/hide-remote-mcp.yaml b/cloud-dataplane/overlays/hide-remote-mcp.yaml new file mode 100644 index 0000000..6cfb572 --- /dev/null +++ b/cloud-dataplane/overlays/hide-remote-mcp.yaml @@ -0,0 +1,56 @@ +overlay: 1.0.0 +info: + title: Hide Remote MCP endpoints + version: 1.0.0 +actions: + # --- Paths (exact keys confirmed in cloud-dataplane.yaml) --- + - target: "$.paths['/v1/redpanda-connect/mcp-servers']" + remove: true + - target: "$.paths['/v1/redpanda-connect/mcp-servers/{id}']" + remove: true + - target: "$.paths['/v1/redpanda-connect/mcp-servers/{id}:start']" + remove: true + - target: "$.paths['/v1/redpanda-connect/mcp-servers/{id}:stop']" + remove: true + - target: "$.paths['/v1/redpanda-connect/mcp-servers:getConfigSchema']" + remove: true + - target: "$.paths['/v1/redpanda-connect/mcp-servers:lint-config']" + remove: true + # --- Tag definition (avoids an empty nav group) --- + - target: "$.tags[?(@.name=='Remote MCP')]" + remove: true + # --- MCP-only component schemas (all verified MCP-exclusive) --- + - target: "$.components.schemas.CreateMCPServerResponse" + remove: true + - target: "$.components.schemas.DeleteMCPServerResponse" + remove: true + - target: "$.components.schemas.GetMCPServerResponse" + remove: true + - target: "$.components.schemas.GetMCPServerServiceConfigSchemaResponse" + remove: true + - target: "$.components.schemas.LintMCPConfigRequest" + remove: true + - target: "$.components.schemas.LintMCPConfigResponse" + remove: true + - target: "$.components.schemas['ListMCPServersRequest.Filter']" + remove: true + - target: "$.components.schemas.ListMCPServersResponse" + remove: true + - target: "$.components.schemas.MCPServer" + remove: true + - target: "$.components.schemas['MCPServer.ServiceAccount']" + remove: true + - target: "$.components.schemas['MCPServer.State']" + remove: true + - target: "$.components.schemas['MCPServer.Status']" + remove: true + - target: "$.components.schemas.MCPServerCreate" + remove: true + - target: "$.components.schemas.MCPServerUpdate" + remove: true + - target: "$.components.schemas.StartMCPServerResponse" + remove: true + - target: "$.components.schemas.StopMCPServerResponse" + remove: true + - target: "$.components.schemas.UpdateMCPServerResponse" + remove: true From 0c2cce6f0a7596f5e97e5ab02dd744f184dac6e3 Mon Sep 17 00:00:00 2001 From: Kat Batuigas Date: Tue, 21 Jul 2026 12:33:22 -0700 Subject: [PATCH 2/2] Apply suggestion from doc review --- cloud-dataplane/overlays/hide-remote-mcp.yaml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/cloud-dataplane/overlays/hide-remote-mcp.yaml b/cloud-dataplane/overlays/hide-remote-mcp.yaml index 6cfb572..4d4e58e 100644 --- a/cloud-dataplane/overlays/hide-remote-mcp.yaml +++ b/cloud-dataplane/overlays/hide-remote-mcp.yaml @@ -54,3 +54,10 @@ actions: remove: true - target: "$.components.schemas.UpdateMCPServerResponse" remove: true + # --- Transitively MCP-only schemas (orphaned once the above are removed) --- + - target: "$.components.schemas.ConfigurationYAMLSchema" + remove: true + - target: "$.components.schemas.Tool" + remove: true + - target: "$.components.schemas.ComponentType" + remove: true