Remove deprecated ADP content (Remote MCP, Agents, AI Gateway how-tos, rpk cloud mcp)#562
Open
JakeSCahill wants to merge 6 commits intomainfrom
Open
Remove deprecated ADP content (Remote MCP, Agents, AI Gateway how-tos, rpk cloud mcp)#562JakeSCahill wants to merge 6 commits intomainfrom
JakeSCahill wants to merge 6 commits intomainfrom
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
| In this quickstart, you'll get your Claude AI agent talking to Redpanda Cloud using the xref:ai-agents:mcp/local/overview.adoc[Redpanda Cloud Management MCP Server]. | ||
|
|
||
| If you're trying to deploy your own MCP server as a managed service inside your cluster, see xref:ai-agents:mcp/remote/quickstart.adoc[]. | ||
| If you're trying to deploy your own MCP server as a managed service inside your cluster, see MCP quickstart. |
Contributor
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Description: Check for Remote MCP documentation and dangling references
# Check if remote MCP directory or files still exist
echo "=== Checking for remote MCP pages ==="
fd -t f 'remote' modules/ai-agents/pages/mcp/
# Search for xrefs to remote MCP pages
echo -e "\n=== Searching for xrefs to mcp/remote/ ==="
rg -n 'xref:.*mcp/remote' modules/ai-agents/
# Search for text references to "remote MCP" or "Remote MCP"
echo -e "\n=== Searching for text references to Remote MCP ==="
rg -n -i 'remote\s+mcp' modules/ai-agents/ -A 2 -B 2
# Check the index page for Remote MCP mentions
echo -e "\n=== Checking MCP index page ==="
cat modules/ai-agents/pages/mcp/index.adoc 2>/dev/null || echo "Index file not found"Repository: redpanda-data/cloud-docs
Length of output: 4458
🏁 Script executed:
# Read the quickstart file to see line 14 in context
cat -n modules/ai-agents/pages/mcp/local/quickstart.adoc | head -30
# Search for any xref to "quickstart" or "mcp quickstart"
echo -e "\n=== Searching for xref to quickstart ==="
rg -n 'xref:.*quickstart' modules/ai-agents/
# Check what MCP pages exist in the local directory
echo -e "\n=== Files in mcp/local/ ==="
ls -la modules/ai-agents/pages/mcp/local/
# Check what other MCP pages exist
echo -e "\n=== All files in mcp/ ==="
fd -t f . modules/ai-agents/pages/mcp/Repository: redpanda-data/cloud-docs
Length of output: 2723
Broken reference to removed Remote MCP documentation.
Line 14 references "MCP quickstart" without an xref link, and the referenced functionality (Remote MCP managed deployment) has been removed in this PR. This creates a dead end for users interested in deploying their own MCP servers inside their cluster.
Based on the PR objectives to remove deprecated Remote MCP documentation, consider one of these options:
- Remove the sentence entirely if Remote MCP is fully deprecated
- Add a deprecation notice explaining that Remote MCP is no longer available
- Update the reference if there's an alternative resource for users seeking managed MCP deployment
🔗 Proposed fix (Option 1: Remove the sentence)
-If you're trying to deploy your own MCP server as a managed service inside your cluster, see MCP quickstart.📋 Proposed fix (Option 2: Add deprecation notice)
-If you're trying to deploy your own MCP server as a managed service inside your cluster, see MCP quickstart.
+NOTE: Remote MCP servers (managed deployment inside Redpanda Cloud) have been deprecated. For local MCP server setup, continue with this quickstart.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
Suggested change
| If you're trying to deploy your own MCP server as a managed service inside your cluster, see MCP quickstart. |
Suggested change
| If you're trying to deploy your own MCP server as a managed service inside your cluster, see MCP quickstart. | |
| NOTE: Remote MCP servers (managed deployment inside Redpanda Cloud) have been deprecated. For local MCP server setup, continue with this quickstart. |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@modules/ai-agents/pages/mcp/local/quickstart.adoc` at 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.
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
|
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
2 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:
Test plan
🤖 Generated with Claude Code