Remove deprecated ADP content (Remote MCP, Agents, AI Gateway how-tos, rpk cloud mcp) (#562)

* Remove deprecated Remote MCP documentation

Remove the Remote MCP server documentation from cloud-docs.
This feature has been deprecated.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove MCP tools examples and update test workflow

- Remove modules/ai-agents/examples/mcp-tools/ directory
- Update test workflow to remove MCP tools test step

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove Remote MCP references and fix broken xrefs

- Remove xrefs to mcp/remote/* pages throughout ai-agents module
- Add deprecation notice for Remote MCP in whats-new-cloud.adoc (April 2026)
- Remove rpk-cloud-mcp-proxy page (Remote MCP specific)
- Restore MCP tool example files needed by agent tutorials
- Update integration partials to remove Remote MCP server references
- Update navigation to remove rpk-cloud-mcp-proxy entry

Known remaining issue: rpk-cloud-mcp.adoc has broken xrefs from
auto-generated content that needs to be fixed in the main docs repo.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove Agents, AI Gateway how-tos, and Transcripts how-tos

Per team decision, remove most ADP content except concept/overview pages:
- Keep: ADP overview, AI Gateway overview, Transcripts concepts, Local MCP
- Remove: All Agents pages, tutorials, and examples
- Remove: AI Gateway quickstart, setup guide, architecture, cookbook
- Remove: Transcripts how-to pages
- Remove: All integration guides (Claude Code, Cursor, etc.)
- Remove: All AI Hub partials
- Update nav.adoc to reflect reduced content
- Fix broken xrefs in remaining concept pages

Known remaining issue: rpk-cloud-mcp.adoc has broken xrefs from
auto-generated content that needs to be fixed in the main docs repo.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove rpk cloud mcp command documentation

The rpk cloud mcp commands are deprecated along with Remote MCP:
- Remove rpk-cloud-mcp.adoc
- Remove rpk-cloud-mcp-install.adoc
- Remove rpk-cloud-mcp-stdio.adoc
- Update nav.adoc to remove rpk cloud mcp entries
- Update Local MCP docs to use plain text instead of xrefs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix broken reference and update test workflow

- Remove dead reference to Remote MCP quickstart in local MCP quickstart
- Update test workflow to remove ai-agents pipeline tests (examples deleted)
- Update workflow path triggers to only watch develop examples

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Address PR review comments and remove remaining Remote MCP references

- Remove "Built on Redpanda Connect" xref from adp-overview.adoc
- Delete duplicate "Customer-based routing" section from AI Gateway page
- Rewrite MCP overview page to remove all Remote MCP content
- Update MCP index page to remove Remote MCP bullet point
- Update observability concepts to remove Remote MCP server reference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Flatten MCP directory structure by removing local/ subdirectory

With Remote MCP removed, the local/ subdirectory is no longer needed.
Move all MCP content up one level for simpler navigation.

- Move quickstart.adoc, configuration.adoc, overview.adoc to mcp/
- Add page-aliases for redirects from old URLs
- Update all xrefs from mcp/local/ to mcp/
- Simplify navigation structure
- Delete empty local/ directory and index

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update index.adoc

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: JakeSCahill

.github/workflows/test-mcp-examples.yaml

@@ -5,8 +5,6 @@ on:
     branches:
       - main
     paths:
-      - 'modules/ai-agents/examples/**/*.yaml'
-      - 'modules/ai-agents/examples/**/*.sh'
       - 'modules/develop/examples/**/*.yaml'
       - 'modules/develop/examples/**/*.sh'
 
@@ -37,19 +35,8 @@ jobs:
 
       - name: Make test scripts executable
         run: |
-          find modules/ai-agents/examples -name "*.sh" -exec chmod +x {} \;
           find modules/develop/examples -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true
 
-      - name: Run MCP tools tests
-        run: |
-          cd modules/ai-agents/examples/mcp-tools
-          ./test-mcp-tools.sh
-
-      - name: Run ai-agents pipeline tests
-        run: |
-          cd modules/ai-agents/examples/pipelines
-          ./test-pipelines.sh
-
       - name: Run cookbook tests
         run: |
           for dir in modules/develop/examples/cookbooks/*/; do

modules/ROOT/nav.adoc

@@ -27,73 +27,12 @@
 ** xref:ai-agents:adp-overview.adoc[ADP Overview]
 ** xref:ai-agents:mcp/index.adoc[MCP]
 *** xref:ai-agents:mcp/overview.adoc[Overview]
-*** xref:ai-agents:mcp/remote/index.adoc[Remote MCP]
-**** xref:ai-agents:mcp/remote/overview.adoc[Overview]
-**** xref:ai-agents:mcp/remote/concepts.adoc[Concepts]
-**** xref:ai-agents:mcp/remote/quickstart.adoc[Quickstart]
-**** xref:ai-agents:mcp/remote/create-tool.adoc[Create a Tool]
-**** xref:ai-agents:mcp/remote/best-practices.adoc[Best Practices]
-**** xref:ai-agents:mcp/remote/tool-patterns.adoc[Tool Patterns]
-**** xref:ai-agents:mcp/remote/troubleshooting.adoc[Troubleshoot]
-**** xref:ai-agents:mcp/remote/manage-servers.adoc[Manage Servers]
-**** xref:ai-agents:mcp/remote/monitor-mcp-servers.adoc[Monitor MCP Servers]
-**** xref:ai-agents:mcp/remote/scale-resources.adoc[Scale Resources]
-*** xref:ai-agents:mcp/local/index.adoc[Redpanda Cloud Management MCP Server]
-**** xref:ai-agents:mcp/local/overview.adoc[Overview]
-**** xref:ai-agents:mcp/local/quickstart.adoc[Quickstart]
-**** xref:ai-agents:mcp/local/configuration.adoc[Configure]
-** xref:ai-agents:agents/index.adoc[Agents]
-*** xref:ai-agents:agents/get-started-index.adoc[Get Started]
-**** xref:ai-agents:agents/overview.adoc[Overview]
-**** xref:ai-agents:agents/concepts.adoc[Concepts]
-**** xref:ai-agents:agents/quickstart.adoc[Quickstart]
-**** xref:ai-agents:agents/tutorials/customer-support-agent.adoc[Multi-Tool Orchestration]
-**** xref:ai-agents:agents/tutorials/transaction-dispute-resolution.adoc[Multi-Agent Systems]
-*** xref:ai-agents:agents/build-index.adoc[Build Agents]
-**** xref:ai-agents:agents/create-agent.adoc[Create an Agent]
-**** xref:ai-agents:agents/prompt-best-practices.adoc[System Prompt Best Practices]
-**** xref:ai-agents:agents/architecture-patterns.adoc[Architecture Patterns]
-**** xref:ai-agents:agents/troubleshooting.adoc[Troubleshoot]
-*** xref:ai-agents:agents/monitor-agents.adoc[Monitor Agents]
-*** xref:ai-agents:agents/integration-index.adoc[Agent Integrations]
-**** xref:ai-agents:agents/integration-overview.adoc[Integration Patterns]
-**** xref:ai-agents:agents/pipeline-integration-patterns.adoc[Pipeline to Agent]
-**** xref:ai-agents:agents/a2a-concepts.adoc[A2A Protocol]
+*** xref:ai-agents:mcp/quickstart.adoc[Quickstart]
+*** xref:ai-agents:mcp/configuration.adoc[Configure]
 ** xref:ai-agents:observability/index.adoc[Transcripts]
 *** xref:ai-agents:observability/concepts.adoc[Concepts]
-*** xref:ai-agents:observability/transcripts.adoc[View Transcripts]
-*** xref:ai-agents:observability/ingest-custom-traces.adoc[Ingest Traces from Custom Agents]
 ** xref:ai-agents:ai-gateway/index.adoc[AI Gateway]
 *** xref:ai-agents:ai-gateway/what-is-ai-gateway.adoc[Overview]
-*** xref:ai-agents:ai-gateway/gateway-quickstart.adoc[Quickstart]
-*** xref:ai-agents:ai-gateway/gateway-architecture.adoc[Architecture]
-*** For Administrators
-**** xref:ai-agents:ai-gateway/admin/setup-guide.adoc[Setup Guide]
-*** For Builders
-**** xref:ai-agents:ai-gateway/builders/discover-gateways.adoc[Discover Gateways]
-**** xref:ai-agents:ai-gateway/builders/connect-your-agent.adoc[Connect Your Agent]
-**** xref:ai-agents:ai-gateway/cel-routing-cookbook.adoc[CEL Routing Patterns]
-**** xref:ai-agents:ai-gateway/mcp-aggregation-guide.adoc[MCP Gateway]
-//*** Observability
-//**** xref:ai-agents:ai-gateway/observability-logs.adoc[Request Logs]
-//**** xref:ai-agents:ai-gateway/observability-metrics.adoc[Metrics and Analytics]
-//*** xref:ai-agents:ai-gateway/migration-guide.adoc[Migrate]
-//*** xref:ai-agents:ai-gateway/integrations/index.adoc[Integrations]
-//**** Claude Code
-//***** xref:ai-agents:ai-gateway/integrations/claude-code-admin.adoc[Admin Guide]
-//***** xref:ai-agents:ai-gateway/integrations/claude-code-user.adoc[User Guide]
-//**** Cline
-//***** xref:ai-agents:ai-gateway/integrations/cline-admin.adoc[Admin Guide]
-//***** xref:ai-agents:ai-gateway/integrations/cline-user.adoc[User Guide]
-//**** Continue.dev
-//***** xref:ai-agents:ai-gateway/integrations/continue-admin.adoc[Admin Guide]
-//***** xref:ai-agents:ai-gateway/integrations/continue-user.adoc[User Guide]
-//**** Cursor IDE
-//***** xref:ai-agents:ai-gateway/integrations/cursor-admin.adoc[Admin Guide]
-//***** xref:ai-agents:ai-gateway/integrations/cursor-user.adoc[User Guide]
-//**** GitHub Copilot
-//***** xref:ai-agents:ai-gateway/integrations/github-copilot-admin.adoc[Admin Guide]
-//***** xref:ai-agents:ai-gateway/integrations/github-copilot-user.adoc[User Guide]
 
 * xref:develop:connect/about.adoc[Redpanda Connect]
 ** xref:develop:connect/connect-quickstart.adoc[Quickstart]
@@ -592,10 +531,6 @@
 ***** xref:reference:rpk/rpk-cloud/rpk-cloud-cluster-select.adoc[]
 **** xref:reference:rpk/rpk-cloud/rpk-cloud-login.adoc[]
 **** xref:reference:rpk/rpk-cloud/rpk-cloud-logout.adoc[]
-**** xref:reference:rpk/rpk-cloud/rpk-cloud-mcp.adoc[]
-***** xref:reference:rpk/rpk-cloud/rpk-cloud-mcp-install.adoc[]
-***** xref:reference:rpk/rpk-cloud/rpk-cloud-mcp-proxy.adoc[]
-***** xref:reference:rpk/rpk-cloud/rpk-cloud-mcp-stdio.adoc[]
 *** xref:reference:rpk/rpk-cluster/rpk-cluster.adoc[]
 **** xref:reference:rpk/rpk-cluster/rpk-cluster-config.adoc[]
 ***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-get.adoc[]