DOC-2100 Remove deprecated MCP server documentation by JakeSCahill · Pull Request #418 · redpanda-data/rp-connect-docs

JakeSCahill · 2026-04-23T14:01:04Z

Summary

Remove the deprecated MCP server documentation from rp-connect-docs. This content has been moved to the dedicated ADP documentation repository.

Jira: https://redpandadata.atlassian.net/browse/DOC-2100

Changes

Remove modules/ai-agents/ directory (94 files)
Remove MCP Servers section from nav.adoc

Related PRs

adp-docs: Initial setup: ADP documentation repository adp-docs#1
cloud-docs: Remove ai-agents module - migrated to adp-docs cloud-docs#561
docs-site: Add Agentic Data Plane (ADP) documentation support docs-site#170
docs-ui: Add ADP availability block and badge styling docs-ui#376

Preview pages

What's New in Redpanda Connect (updated)

Note: the ~95 modules/ai-agents/ files being removed are not linked — they no longer exist in the preview.

Test plan

Build succeeds without ai-agents module
Nav renders correctly without MCP Servers section

🤖 Generated with Claude Code

ADP documentation moved to dedicated adp-docs repository with new component name redpanda-adp. - Update cross-references in MCP tool documentation - Update partial includes referencing cloud-docs ai-agents module Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Remove the ai-agents module containing MCP server documentation. This content has been deprecated in favor of the ADP documentation. Jira: https://redpandadata.atlassian.net/browse/DOC-2100 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

coderabbitai · 2026-04-23T14:01:21Z

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: cea15b7c-c65d-4914-b373-9938b64cfc0e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

📝 Walkthrough

Walkthrough

The pull request removes all Model Context Protocol (MCP) Server documentation, examples, and test infrastructure from the Redpanda Connect documentation repository. This includes deletion of MCP documentation pages, navigation entries, example configurations, test examples, workflows, test scripts, and documentation partials covering MCP concepts, best practices, tool patterns, and troubleshooting. No functionality is added or modified; only files are removed.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

PR #302: Appears to be the inverse change that added MCP server documentation, examples, and test infrastructure to the repository.
PR #314: Modifies modules/ai-agents/pages/mcp-server/quickstart.adoc, which is deleted in this PR, creating a direct file conflict.
PR #286: Modifies modules/ROOT/nav.adoc to remove/restructure navigation entries, similar structural changes to the navigation file affected by this PR.

Suggested reviewers

micheleRP
paulohtb6
Jeffail

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The pull request title clearly and concisely describes the main change: removing deprecated MCP server documentation and moving it to another repository.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The PR description clearly explains that deprecated MCP server documentation is being removed and relocated to a dedicated repository, with specific Jira ticket and related PRs referenced.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch feature/update-ai-agents-xrefs

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.

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.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

netlify · 2026-04-23T14:01:31Z

✅ Deploy Preview for redpanda-connect ready!

Name	Link
🔨 Latest commit	`1b4952f`
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-connect/deploys/69f0cd0d3f5d6e0008355d50
😎 Deploy Preview	https://deploy-preview-418--redpanda-connect.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

The ai-agents examples were removed, so this workflow is no longer needed. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

MCP documentation has been deprecated and removed from this repo. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

micheleRP · 2026-04-24T14:02:14Z

Review findings

Jira ticket alignment

Ticket: DOC-2100 — "Remove MCP from Redpanda Connect docs across all environments" (In Review). Scope matches this PR exactly.

Critical issues

None.

Suggestions

modules/get-started/pages/whats-new.adoc L1233-1235 — Historical release notes still announce the MCP server feature. The xref to the quickstart was correctly removed, leaving a dangling announcement. Release notes are traditionally immutable, but consider adding a short deprecation note (e.g., a trailing "This feature has since been deprecated.") so users don't chase missing docs.

Impact on other files (cross-repo)

None for this PR specifically — the modules/ai-agents/ directory is self-contained and its removal doesn't break anything in rp-connect-docs or other repos. For broader cross-repo context affecting the related MCP deprecation work, see the review on cloud-docs #562.

What works well

Clean single-purpose deletion — modules/ai-agents/ removed in its entirety (96 files).
Nav cleanup is correct.
No xrefs to deleted pages remain in the rest of the repo.

micheleRP

lgtm!

Document that the following CLI commands have been deprecated and removed as part of the Remote MCP feature deprecation: - rpk connect mcp-server - rpk connect mcp-server init - rpk connect mcp-server lint Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Expand the deprecation notice to clearly state that the entire MCP server feature has been removed, not just the CLI commands. Simplify the CLI command list by removing redundant descriptions. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

JakeSCahill and others added 2 commits April 22, 2026 12:39

JakeSCahill requested a review from a team as a code owner April 23, 2026 14:01

JakeSCahill and others added 2 commits April 23, 2026 15:05

Remove MCP examples test workflow

5e1559c

The ai-agents examples were removed, so this workflow is no longer needed. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Remove deprecated MCP server xref

fb75210

MCP documentation has been deprecated and removed from this repo. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

JakeSCahill requested a review from prakhargarg105 April 24, 2026 11:55

micheleRP approved these changes Apr 24, 2026

View reviewed changes

JakeSCahill and others added 2 commits April 27, 2026 16:56

prakhargarg105 approved these changes Apr 28, 2026

View reviewed changes

JakeSCahill merged commit 9e4efc6 into main Apr 28, 2026
5 checks passed

JakeSCahill deleted the feature/update-ai-agents-xrefs branch April 28, 2026 15:31

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

DOC-2100 Remove deprecated MCP server documentation#418

DOC-2100 Remove deprecated MCP server documentation#418
JakeSCahill merged 6 commits intomainfrom
feature/update-ai-agents-xrefs

JakeSCahill commented Apr 23, 2026 •

edited by micheleRP

Loading

Uh oh!

coderabbitai Bot commented Apr 23, 2026 •

edited

Loading

Review skipped

Walkthrough

Estimated code review effort

Possibly related PRs

Suggested reviewers

Review ran into problems

Uh oh!

netlify Bot commented Apr 23, 2026 •

edited

Loading

Uh oh!

micheleRP commented Apr 24, 2026

Uh oh!

micheleRP left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

JakeSCahill commented Apr 23, 2026 • edited by micheleRP Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Related PRs

Preview pages

Test plan

Uh oh!

coderabbitai Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Walkthrough

Estimated code review effort

Possibly related PRs

Suggested reviewers

Review ran into problems

Uh oh!

netlify Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for redpanda-connect ready!

Uh oh!

micheleRP commented Apr 24, 2026

Review findings

Jira ticket alignment

Critical issues

Suggestions

Impact on other files (cross-repo)

What works well

Uh oh!

micheleRP left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

JakeSCahill commented Apr 23, 2026 •

edited by micheleRP

Loading

coderabbitai Bot commented Apr 23, 2026 •

edited

Loading

netlify Bot commented Apr 23, 2026 •

edited

Loading