Skip to content

Conversation

@JakeSCahill
Copy link
Contributor

@JakeSCahill JakeSCahill commented Dec 4, 2025

This pull request updates the Redpanda Model Context Protocol (MCP) documentation and server implementation to migrate users from the old MCP endpoint to a new, more reliable Kapa-hosted endpoint. It also introduces new authentication requirements, updates rate limits, and improves error handling and observability in the server code.

MCP Endpoint Migration and Documentation Updates:

  • Changed all references and configuration examples from the deprecated https://docs.redpanda.com/mcp endpoint to the new https://redpanda.mcp.kapa.ai endpoint, and added a prominent deprecation notice with a sunset date of February 2026. [1] [2] [3] [4] [5] [6]
  • Updated technical specs: new endpoint now requires Google OAuth sign-in (openid scope only, no personal data), and rate limits are now 40 requests/hour and 200 requests/day per user (was 60/15min per client, no auth). Added a new "Authentication" section describing the sign-in flow and privacy. [1] [2]
  • Updated documentation for error messages and troubleshooting to reference the new endpoint and new rate limits. [1] [2]

Server Implementation Improvements:

  • Added a 25-second timeout to Kapa API requests in netlify/functions/mcp.mjs to prevent indefinite hangs, with clear error responses for timeouts and improved error logging for both slow and failed requests. [1] [2] [3] [4]
  • Added logging and HTTP headers to the legacy MCP endpoint to warn about deprecation, communicate the sunset date, and provide a migration guide link.

Related: redpanda-data/docs-ui#350

@JakeSCahill JakeSCahill requested a review from a team as a code owner December 4, 2025 16:02
@netlify
Copy link

netlify bot commented Dec 4, 2025

Deploy Preview for redpanda-documentation ready!

Name Link
🔨 Latest commit 3f97a4c
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-documentation/deploys/6939299a9dfec400091ebb29
😎 Deploy Preview https://deploy-preview-152--redpanda-documentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 68 (🟢 up 17 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (🟢 up 25 from production)
SEO: 83 (🔴 down 9 from production)
PWA: -
View the detailed breakdown and full score reports

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

@JakeSCahill JakeSCahill changed the title Add better logs for MCP server Deprecate MCP server in favor of Kapa-hosted one Dec 5, 2025

=== Other issues

Check the https://github.com/modelcontextprotocol/servers[MCP GitHub repository^] for additional troubleshooting guidance or https://github.com/redpanda-data/docs-site/issues[report an issue^] with our documentation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this really where we should track issues for this?
https://github.com/redpanda-data/docs-site/issues

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's this repo. I think it makes sense.

+
- **Name**: `redpanda`
- **URL**: `https://docs.redpanda.com/mcp`
- **URL**: `https://redpanda.mcp.kapa.ai`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@JakeSCahill should you add steps for ChatGPT Atlas?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And Claude Code?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could add steps in future if we see customers using it.

Copy link
Contributor

@micheleRP micheleRP left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left some comments but looks good!

@JakeSCahill JakeSCahill merged commit 7bdc74f into main Dec 10, 2025
4 checks passed
@JakeSCahill JakeSCahill deleted the mcp-logs branch December 10, 2025 11:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants