Remove deprecated ADP content (Remote MCP, Agents, AI Gateway how-tos, rpk cloud mcp)#562
Merged
JakeSCahill merged 9 commits intomainfrom Apr 28, 2026
Merged
Conversation
Remove the Remote MCP server documentation from cloud-docs. This feature has been deprecated. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
✅ Deploy Preview for rp-cloud ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
|
Important Review skippedAuto incremental reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
📝 WalkthroughWalkthroughThis pull request removes extensive documentation, examples, and test infrastructure related to Remote MCP servers, AI Agents tutorials, AI Gateway features (particularly AI Hub mode), and associated integration guides. The deletion includes over 100 documentation pages and example YAML files, navigation entries in Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related PRs
Suggested reviewers
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
- 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 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>
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>
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (2)
.github/workflows/test-mcp-examples.yaml (2)
40-41: Silently swallowingchmodfailures can hide real CI issues.
find ... -exec chmod +x {} \; 2>/dev/null || truewill mask any genuine permission/IO error (and also hide cases wherefindmatches nothing but something else breaks).findalready exits 0 when no files match, so the|| trueisn't needed for the "no matches" case. If the intent is only to tolerate a missing directory, prefer guarding on existence explicitly, e.g.:♻️ Suggested tightening
- find modules/ai-agents/examples -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true - find modules/develop/examples -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true + for dir in modules/ai-agents/examples modules/develop/examples; do + if [ -d "$dir" ]; then + find "$dir" -name "*.sh" -exec chmod +x {} \; + fi + doneThis keeps real
chmoderrors visible in CI logs while still tolerating a deleted/renamed examples directory.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In @.github/workflows/test-mcp-examples.yaml around lines 40 - 41, Replace the silent-swallowing pattern "find ... -exec chmod +x {} \; 2>/dev/null || true" with an explicit directory-existence guard so real chmod errors surface; specifically, for the find invocations referencing the examples dirs (the lines invoking "find modules/ai-agents/examples -name \"*.sh\" -exec chmod +x {} \;" and "find modules/develop/examples -name \"*.sh\" -exec chmod +x {} \;"), wrap each find in a conditional that checks the directory exists before running find (e.g., test -d or an if [ -d ... ] check) so missing directories are tolerated but permission/IO errors from chmod are not suppressed.
1-1: Consider renaming this workflow file now that MCP tests are removed.The file is still named
test-mcp-examples.yaml, but after this change it only runs ai-agents pipeline tests and develop cookbook tests — MCP-specific testing has been dropped. The stale name (and arguably thename:field) will mislead future maintainers searching for MCP coverage. Consider renaming to something liketest-pipeline-examples.yamlto match the workflow's actual scope.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In @.github/workflows/test-mcp-examples.yaml at line 1, Rename the workflow file and update its workflow name to reflect current scope: change the filename from test-mcp-examples.yaml to test-pipeline-examples.yaml (or another descriptive name) and update the top-level `name:` value from "Test Pipeline Examples" to something matching the new filename/intent (e.g., "Test Pipeline and Cookbook Examples") so the file name and `name:` field accurately describe that it runs ai-agents pipeline and develop cookbook tests.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@modules/ai-agents/pages/mcp/local/quickstart.adoc`:
- Line 14: The sentence "If you're trying to deploy your own MCP server as a
managed service inside your cluster, see MCP quickstart." points to removed
Remote MCP docs and must be handled; either delete that sentence from
modules/ai-agents/pages/mcp/local/quickstart.adoc, or replace it with a
deprecation notice that Remote MCP is no longer available (e.g., "Remote MCP
managed deployments have been removed; see alternative deployment options") or
update it to point to the new alternative resource — edit the exact sentence in
quickstart.adoc accordingly.
---
Nitpick comments:
In @.github/workflows/test-mcp-examples.yaml:
- Around line 40-41: Replace the silent-swallowing pattern "find ... -exec chmod
+x {} \; 2>/dev/null || true" with an explicit directory-existence guard so real
chmod errors surface; specifically, for the find invocations referencing the
examples dirs (the lines invoking "find modules/ai-agents/examples -name
\"*.sh\" -exec chmod +x {} \;" and "find modules/develop/examples -name \"*.sh\"
-exec chmod +x {} \;"), wrap each find in a conditional that checks the
directory exists before running find (e.g., test -d or an if [ -d ... ] check)
so missing directories are tolerated but permission/IO errors from chmod are not
suppressed.
- Line 1: Rename the workflow file and update its workflow name to reflect
current scope: change the filename from test-mcp-examples.yaml to
test-pipeline-examples.yaml (or another descriptive name) and update the
top-level `name:` value from "Test Pipeline Examples" to something matching the
new filename/intent (e.g., "Test Pipeline and Cookbook Examples") so the file
name and `name:` field accurately describe that it runs ai-agents pipeline and
develop cookbook tests.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: fdf15fd2-5c30-431a-abc8-1769430bc8c5
📒 Files selected for processing (125)
.github/workflows/test-mcp-examples.yamlmodules/ROOT/nav.adocmodules/ai-agents/examples/agents/account-agent-prompt.txtmodules/ai-agents/examples/agents/compliance-agent-prompt.txtmodules/ai-agents/examples/agents/dispute-root-agent-prompt.txtmodules/ai-agents/examples/agents/fraud-agent-prompt.txtmodules/ai-agents/examples/agents/merchant-agent-prompt.txtmodules/ai-agents/examples/mcp-tools/caches/memory_cache.yamlmodules/ai-agents/examples/mcp-tools/caches/redpanda_cache.yamlmodules/ai-agents/examples/mcp-tools/caches/session_cache.yamlmodules/ai-agents/examples/mcp-tools/inputs/consume_redpanda.yamlmodules/ai-agents/examples/mcp-tools/inputs/event_driven_workflow.yamlmodules/ai-agents/examples/mcp-tools/inputs/generate_input.yamlmodules/ai-agents/examples/mcp-tools/inputs/read_events.yamlmodules/ai-agents/examples/mcp-tools/inputs/stream_processing.yamlmodules/ai-agents/examples/mcp-tools/outputs/publish_event.yamlmodules/ai-agents/examples/mcp-tools/outputs/publish_with_timestamp.yamlmodules/ai-agents/examples/mcp-tools/outputs/redpanda_output.yamlmodules/ai-agents/examples/mcp-tools/outputs/redpanda_output_with_processors.yamlmodules/ai-agents/examples/mcp-tools/processors/calculate_fraud_score.yamlmodules/ai-agents/examples/mcp-tools/processors/check_regulatory_requirements.yamlmodules/ai-agents/examples/mcp-tools/processors/customer_enrichment.yamlmodules/ai-agents/examples/mcp-tools/processors/enrich_order.yamlmodules/ai-agents/examples/mcp-tools/processors/gcp_bigquery_select_processor.yamlmodules/ai-agents/examples/mcp-tools/processors/get_customer_account.yamlmodules/ai-agents/examples/mcp-tools/processors/get_customer_history.yamlmodules/ai-agents/examples/mcp-tools/processors/get_merchant_category.yamlmodules/ai-agents/examples/mcp-tools/processors/get_order_status.yamlmodules/ai-agents/examples/mcp-tools/processors/get_risk_indicators.yamlmodules/ai-agents/examples/mcp-tools/processors/get_shipping_info.yamlmodules/ai-agents/examples/mcp-tools/processors/get_transaction_details.yamlmodules/ai-agents/examples/mcp-tools/processors/get_transaction_history.yamlmodules/ai-agents/examples/mcp-tools/processors/get_weather_complete.yamlmodules/ai-agents/examples/mcp-tools/processors/get_weather_simple.yamlmodules/ai-agents/examples/mcp-tools/processors/http_processor.yamlmodules/ai-agents/examples/mcp-tools/processors/log_audit_event.yamlmodules/ai-agents/examples/mcp-tools/processors/lookup_customer.yamlmodules/ai-agents/examples/mcp-tools/processors/observable_tool.yamlmodules/ai-agents/examples/mcp-tools/processors/openai_chat.yamlmodules/ai-agents/examples/mcp-tools/processors/openai_embeddings.yamlmodules/ai-agents/examples/mcp-tools/processors/order_workflow.yamlmodules/ai-agents/examples/mcp-tools/processors/search_jira.yamlmodules/ai-agents/examples/mcp-tools/processors/transform_validate.yamlmodules/ai-agents/examples/mcp-tools/processors/verify_merchant.yamlmodules/ai-agents/examples/mcp-tools/processors/weather_service.yamlmodules/ai-agents/examples/mcp-tools/snippets/bloblang_this_context.yamlmodules/ai-agents/examples/mcp-tools/snippets/defaults.yamlmodules/ai-agents/examples/mcp-tools/snippets/interpolation.yamlmodules/ai-agents/examples/mcp-tools/snippets/secrets.yamlmodules/ai-agents/examples/mcp-tools/test-mcp-tools.shmodules/ai-agents/examples/pipelines/agent-transformation.yamlmodules/ai-agents/examples/pipelines/async-workflows.yamlmodules/ai-agents/examples/pipelines/dispute-pipeline.yamlmodules/ai-agents/examples/pipelines/event-driven-invocation.yamlmodules/ai-agents/examples/pipelines/fraud-detection-routing.yamlmodules/ai-agents/examples/pipelines/fraud-detection-simple.yamlmodules/ai-agents/examples/pipelines/multi-agent-orchestration.yamlmodules/ai-agents/examples/pipelines/streaming-enrichment.yamlmodules/ai-agents/examples/pipelines/test-pipelines.shmodules/ai-agents/pages/adp-overview.adocmodules/ai-agents/pages/agents/a2a-concepts.adocmodules/ai-agents/pages/agents/architecture-patterns.adocmodules/ai-agents/pages/agents/build-index.adocmodules/ai-agents/pages/agents/concepts.adocmodules/ai-agents/pages/agents/create-agent.adocmodules/ai-agents/pages/agents/get-started-index.adocmodules/ai-agents/pages/agents/index.adocmodules/ai-agents/pages/agents/integration-index.adocmodules/ai-agents/pages/agents/integration-overview.adocmodules/ai-agents/pages/agents/monitor-agents.adocmodules/ai-agents/pages/agents/overview.adocmodules/ai-agents/pages/agents/pipeline-integration-patterns.adocmodules/ai-agents/pages/agents/prompt-best-practices.adocmodules/ai-agents/pages/agents/quickstart.adocmodules/ai-agents/pages/agents/troubleshooting.adocmodules/ai-agents/pages/agents/tutorials/customer-support-agent.adocmodules/ai-agents/pages/agents/tutorials/transaction-dispute-resolution.adocmodules/ai-agents/pages/ai-gateway/admin/setup-guide.adocmodules/ai-agents/pages/ai-gateway/builders/connect-your-agent.adocmodules/ai-agents/pages/ai-gateway/builders/discover-gateways.adocmodules/ai-agents/pages/ai-gateway/cel-routing-cookbook.adocmodules/ai-agents/pages/ai-gateway/gateway-architecture.adocmodules/ai-agents/pages/ai-gateway/gateway-quickstart.adocmodules/ai-agents/pages/ai-gateway/mcp-aggregation-guide.adocmodules/ai-agents/pages/ai-gateway/what-is-ai-gateway.adocmodules/ai-agents/pages/mcp/local/quickstart.adocmodules/ai-agents/pages/mcp/overview.adocmodules/ai-agents/pages/mcp/remote/best-practices.adocmodules/ai-agents/pages/mcp/remote/concepts.adocmodules/ai-agents/pages/mcp/remote/create-tool.adocmodules/ai-agents/pages/mcp/remote/index.adocmodules/ai-agents/pages/mcp/remote/manage-servers.adocmodules/ai-agents/pages/mcp/remote/monitor-mcp-servers.adocmodules/ai-agents/pages/mcp/remote/overview.adocmodules/ai-agents/pages/mcp/remote/quickstart.adocmodules/ai-agents/pages/mcp/remote/scale-resources.adocmodules/ai-agents/pages/mcp/remote/tool-patterns.adocmodules/ai-agents/pages/mcp/remote/troubleshooting.adocmodules/ai-agents/pages/observability/concepts.adocmodules/ai-agents/pages/observability/ingest-custom-traces.adocmodules/ai-agents/pages/observability/transcripts.adocmodules/ai-agents/partials/ai-hub-mode-indicator.adocmodules/ai-agents/partials/ai-hub-preference-toggles.adocmodules/ai-agents/partials/ai-hub/configure-ai-hub.adocmodules/ai-agents/partials/ai-hub/eject-to-custom-mode.adocmodules/ai-agents/partials/ai-hub/gateway-modes.adocmodules/ai-agents/partials/ai-hub/use-ai-hub-gateway.adocmodules/ai-agents/partials/integrations/claude-code-admin.adocmodules/ai-agents/partials/integrations/claude-code-user.adocmodules/ai-agents/partials/integrations/cline-admin.adocmodules/ai-agents/partials/integrations/cline-user.adocmodules/ai-agents/partials/integrations/continue-admin.adocmodules/ai-agents/partials/integrations/continue-user.adocmodules/ai-agents/partials/integrations/cursor-admin.adocmodules/ai-agents/partials/integrations/cursor-user.adocmodules/ai-agents/partials/integrations/github-copilot-admin.adocmodules/ai-agents/partials/integrations/github-copilot-user.adocmodules/ai-agents/partials/integrations/index.adocmodules/ai-agents/partials/migration-guide.adocmodules/ai-agents/partials/observability-logs.adocmodules/ai-agents/partials/observability-metrics.adocmodules/ai-agents/partials/service-account-authorization.adocmodules/ai-agents/partials/transcripts-ui-guide.adocmodules/get-started/pages/whats-new-cloud.adocmodules/reference/pages/rpk/rpk-cloud/rpk-cloud-mcp-proxy.adoc
💤 Files with no reviewable changes (112)
- modules/ai-agents/examples/mcp-tools/inputs/stream_processing.yaml
- modules/ai-agents/pages/ai-gateway/what-is-ai-gateway.adoc
- modules/ai-agents/examples/mcp-tools/snippets/secrets.yaml
- modules/ai-agents/pages/agents/get-started-index.adoc
- modules/ai-agents/examples/mcp-tools/outputs/redpanda_output.yaml
- modules/ai-agents/pages/mcp/remote/troubleshooting.adoc
- modules/ai-agents/examples/mcp-tools/inputs/consume_redpanda.yaml
- modules/ai-agents/examples/mcp-tools/caches/redpanda_cache.yaml
- modules/ai-agents/pages/adp-overview.adoc
- modules/ai-agents/pages/mcp/remote/best-practices.adoc
- modules/ai-agents/partials/ai-hub-mode-indicator.adoc
- modules/ai-agents/pages/agents/index.adoc
- modules/ai-agents/examples/mcp-tools/processors/check_regulatory_requirements.yaml
- modules/ai-agents/examples/mcp-tools/snippets/interpolation.yaml
- modules/ai-agents/partials/integrations/claude-code-user.adoc
- modules/ai-agents/examples/mcp-tools/processors/openai_embeddings.yaml
- modules/ai-agents/pages/agents/build-index.adoc
- modules/ai-agents/examples/mcp-tools/processors/http_processor.yaml
- modules/ai-agents/pages/agents/integration-index.adoc
- modules/ai-agents/examples/mcp-tools/processors/lookup_customer.yaml
- modules/ai-agents/examples/mcp-tools/outputs/publish_event.yaml
- modules/ai-agents/pages/ai-gateway/gateway-architecture.adoc
- modules/ai-agents/examples/mcp-tools/caches/session_cache.yaml
- modules/ai-agents/examples/mcp-tools/processors/transform_validate.yaml
- modules/ai-agents/pages/agents/quickstart.adoc
- modules/ai-agents/pages/mcp/remote/index.adoc
- modules/ai-agents/examples/mcp-tools/inputs/generate_input.yaml
- modules/ai-agents/pages/agents/monitor-agents.adoc
- modules/ai-agents/examples/mcp-tools/processors/log_audit_event.yaml
- modules/ai-agents/pages/mcp/remote/scale-resources.adoc
- modules/ai-agents/examples/agents/fraud-agent-prompt.txt
- modules/ai-agents/examples/pipelines/fraud-detection-simple.yaml
- modules/ai-agents/examples/pipelines/async-workflows.yaml
- modules/ai-agents/partials/ai-hub/gateway-modes.adoc
- modules/ai-agents/examples/pipelines/fraud-detection-routing.yaml
- modules/ai-agents/examples/mcp-tools/processors/get_customer_account.yaml
- modules/ai-agents/pages/agents/architecture-patterns.adoc
- modules/ai-agents/pages/mcp/overview.adoc
- modules/ai-agents/pages/agents/overview.adoc
- modules/ai-agents/examples/mcp-tools/processors/get_transaction_history.yaml
- modules/ai-agents/examples/mcp-tools/caches/memory_cache.yaml
- modules/ai-agents/examples/pipelines/streaming-enrichment.yaml
- modules/ai-agents/partials/integrations/cline-user.adoc
- modules/ai-agents/examples/mcp-tools/processors/verify_merchant.yaml
- modules/ai-agents/pages/mcp/remote/concepts.adoc
- modules/ai-agents/examples/pipelines/test-pipelines.sh
- modules/ai-agents/examples/mcp-tools/processors/get_shipping_info.yaml
- modules/ai-agents/examples/pipelines/agent-transformation.yaml
- modules/ai-agents/examples/mcp-tools/processors/customer_enrichment.yaml
- modules/ai-agents/partials/ai-hub/eject-to-custom-mode.adoc
- modules/ai-agents/partials/integrations/cursor-admin.adoc
- modules/ai-agents/pages/mcp/remote/quickstart.adoc
- modules/ai-agents/examples/mcp-tools/processors/get_transaction_details.yaml
- modules/ai-agents/examples/mcp-tools/processors/order_workflow.yaml
- modules/ai-agents/pages/ai-gateway/gateway-quickstart.adoc
- modules/ai-agents/pages/agents/a2a-concepts.adoc
- modules/ai-agents/examples/agents/compliance-agent-prompt.txt
- modules/ai-agents/pages/mcp/remote/monitor-mcp-servers.adoc
- modules/ai-agents/pages/agents/create-agent.adoc
- modules/ai-agents/pages/agents/tutorials/customer-support-agent.adoc
- modules/ai-agents/partials/integrations/continue-user.adoc
- modules/ai-agents/partials/ai-hub-preference-toggles.adoc
- modules/ai-agents/examples/pipelines/multi-agent-orchestration.yaml
- modules/ai-agents/pages/ai-gateway/admin/setup-guide.adoc
- modules/ai-agents/pages/agents/prompt-best-practices.adoc
- modules/ai-agents/pages/observability/ingest-custom-traces.adoc
- modules/ai-agents/examples/mcp-tools/processors/weather_service.yaml
- modules/ai-agents/pages/mcp/remote/tool-patterns.adoc
- modules/ai-agents/pages/observability/transcripts.adoc
- modules/ai-agents/pages/ai-gateway/builders/connect-your-agent.adoc
- modules/ai-agents/pages/ai-gateway/mcp-aggregation-guide.adoc
- modules/ai-agents/pages/agents/concepts.adoc
- modules/ROOT/nav.adoc
- modules/ai-agents/examples/mcp-tools/test-mcp-tools.sh
- modules/ai-agents/pages/mcp/remote/manage-servers.adoc
- modules/ai-agents/examples/mcp-tools/inputs/event_driven_workflow.yaml
- modules/ai-agents/pages/observability/concepts.adoc
- modules/ai-agents/partials/ai-hub/use-ai-hub-gateway.adoc
- modules/ai-agents/partials/integrations/cline-admin.adoc
- modules/ai-agents/examples/mcp-tools/processors/calculate_fraud_score.yaml
- modules/ai-agents/partials/integrations/continue-admin.adoc
- modules/ai-agents/examples/agents/account-agent-prompt.txt
- modules/ai-agents/examples/mcp-tools/processors/gcp_bigquery_select_processor.yaml
- modules/ai-agents/examples/mcp-tools/inputs/read_events.yaml
- modules/ai-agents/partials/integrations/claude-code-admin.adoc
- modules/ai-agents/pages/ai-gateway/builders/discover-gateways.adoc
- modules/ai-agents/examples/mcp-tools/processors/get_customer_history.yaml
- modules/ai-agents/examples/pipelines/event-driven-invocation.yaml
- modules/ai-agents/pages/mcp/remote/create-tool.adoc
- modules/ai-agents/examples/mcp-tools/snippets/defaults.yaml
- modules/ai-agents/examples/mcp-tools/processors/search_jira.yaml
- modules/ai-agents/examples/mcp-tools/processors/get_weather_simple.yaml
- modules/ai-agents/pages/ai-gateway/cel-routing-cookbook.adoc
- modules/ai-agents/examples/agents/merchant-agent-prompt.txt
- modules/ai-agents/examples/mcp-tools/processors/openai_chat.yaml
- modules/ai-agents/pages/mcp/remote/overview.adoc
- modules/ai-agents/examples/mcp-tools/snippets/bloblang_this_context.yaml
- modules/ai-agents/examples/mcp-tools/outputs/publish_with_timestamp.yaml
- modules/ai-agents/examples/mcp-tools/processors/observable_tool.yaml
- modules/ai-agents/examples/agents/dispute-root-agent-prompt.txt
- modules/ai-agents/examples/mcp-tools/processors/get_merchant_category.yaml
- modules/ai-agents/pages/agents/troubleshooting.adoc
- modules/ai-agents/pages/agents/pipeline-integration-patterns.adoc
- modules/ai-agents/partials/ai-hub/configure-ai-hub.adoc
- modules/ai-agents/examples/mcp-tools/processors/get_order_status.yaml
- modules/ai-agents/examples/mcp-tools/processors/enrich_order.yaml
- modules/ai-agents/examples/mcp-tools/processors/get_weather_complete.yaml
- modules/ai-agents/pages/agents/tutorials/transaction-dispute-resolution.adoc
- modules/ai-agents/examples/mcp-tools/outputs/redpanda_output_with_processors.yaml
- modules/ai-agents/pages/agents/integration-overview.adoc
- modules/ai-agents/examples/mcp-tools/processors/get_risk_indicators.yaml
- modules/ai-agents/examples/pipelines/dispute-pipeline.yaml
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>
JakeSCahill
changed the title
- 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>
Contributor
Review findingsCritical issues (must fix)
Suggestions
CodeRabbit triage
Impact on other files (cross-repo)Once this PR merges:
Merge-order recommendationPrefer merging this PR last of the three so the orphaned-partials and broken-adp-xrefs conditions can be addressed ahead of time (or immediately after). What works well
|
micheleRP
reviewed
Apr 24, 2026
micheleRP
reviewed
Apr 24, 2026
micheleRP
reviewed
Apr 24, 2026
micheleRP
reviewed
Apr 24, 2026
micheleRP
reviewed
Apr 24, 2026
micheleRP
approved these changes
Apr 24, 2026
Contributor
micheleRP
left a comment
micheleRP
left a comment
There was a problem hiding this comment.
please see my suggestions but looks good for getting this out!
- 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>
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>
prakhargarg105
approved these changes
Apr 27, 2026
This was referenced Apr 28, 2026
micheleRP
added a commit
to redpanda-data/adp-docs
that referenced
this pull request
Apr 29, 2026
Greenfield rewrite of the MCP Servers section for the Agentic Data Plane GA (2026-06-15). Bundles three master-plan workflows: #3 Create MCP server (DOC-2111), #9 Register remote/self-hosted MCP (DOC-2117), #10 User-delegated OAuth for MCP (DOC-2118). Changes: * Delete legacy MCP content migrated from cloud-docs (the YAML-pipeline- authoring era): mcp/pages/remote/ (13 pages), mcp/pages/overview.adoc, mcp/pages/local.adoc, mcp/examples/mcp-tools/ (42 YAML files + test-mcp-tools.sh). The cloud-docs equivalents were removed in redpanda-data/cloud-docs#562; this is the same cleanup applied to adp-docs main, where the migration pre-dated #562. * Rewrite mcp/pages/index.adoc as the MCP Servers landing — frames managed + self-managed backends, lists the four ADP-UI top-level areas, points at Cloud Management MCP as a peer. * Stub the 4 must-ship how-tos (create-server, register-remote, user-delegated-oauth, test-tools) + the managed-catalog reference, with full outlines and // TODO: markers for live walkthroughs on adp-production. Auth section uses the new RemoteMCPConfig auth oneof (none / static_key / token_passthrough / service_account_oauth / user_oauth); credential_mode and the CredentialMode enum are gone post- proto-rewrite. * Stub the 5 should-ship managed deep-dives (sql, kafka, slack, jira, openapi). All follow the shared 7-section structure (what the server does -> prereqs -> configure -> test -> auth -> use with agents -> troubleshooting). Live-walkthrough TODOs throughout. * managed-catalog.adoc lists all 27 user-facing managed types from apps/aigw/internal/mcp/managed/mcps/*/register_mcp.go, grouped by ManagedMCPCategory (AI / AWS / Communication / Database / Google / Streaming / Utility), with deep-dive links for the 5 with dedicated pages. * Update modules/ROOT/nav.adoc — replace the legacy Remote/Local subsections with the new flat MCP Servers structure; promote Redpanda Cloud Management MCP Server to a peer top-level section. * Cascade: retarget xrefs in modules/agents/, modules/observability/, and modules/ROOT/pages/adp-overview.adoc that pointed at deleted mcp:remote/* paths. Targets: mcp:remote/overview.adoc -> mcp:index.adoc; mcp:remote/quickstart.adoc + create-tool.adoc -> mcp:create-server.adoc; mcp:remote/register-external.adoc -> mcp:register-remote.adoc; mcp:remote/oauth-user-delegated.adoc -> mcp:user-delegated-oauth.adoc; mcp:remote/monitor-mcp-servers.adoc -> mcp:test-tools.adoc; mcp:remote/{patterns,best-practices,scale,troubleshooting}.adoc and mcp:overview.adoc -> mcp:index.adoc (no direct equivalents). Beta target (2026-05-15) is best-effort; firm commitment is GA on 2026-06-15. // TODO: markers throughout will be resolved through live walkthroughs on adp-production in subsequent commits. Refs: DOC-2111, DOC-2117, DOC-2118 Plan: https://redpandadata.atlassian.net/wiki/spaces/DOC/pages/1869185054 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> # Conflicts: # modules/observability/pages/concepts.adoc # modules/observability/pages/transcripts.adoc
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Per team decision, remove most ADP documentation content except concept/overview pages. This includes:
rpk cloud mcpcommandsConcept pages are kept for SEO purposes.
Related PRs
rpk connect mcp-serverdocs from self-managedWhat's kept
adp-overview.adoc)what-is-ai-gateway.adoc)observability/concepts.adoc)What's removed
Pages (~80 files, ~22k lines)
rpk-cloud-mcp.adoc,rpk-cloud-mcp-install.adoc,rpk-cloud-mcp-stdio.adoc,rpk-cloud-mcp-proxy.adocPartials
Examples
Navigation changes
Reduced from 60+ nav entries to:
Preview pages
Note: deleted pages (Remote MCP, Agents, AI Gateway how-tos,
rpk cloud mcpcommands) are not linked — they no longer exist in the preview.Test plan
🤖 Generated with Claude Code