DOC-2090 Fix Claude Desktop MCP connection configuration#164
Open
JakeSCahill wants to merge 5 commits intomainfrom
Open
DOC-2090 Fix Claude Desktop MCP connection configuration#164JakeSCahill wants to merge 5 commits intomainfrom
JakeSCahill wants to merge 5 commits intomainfrom
Conversation
The previous configuration used "type": "http" which Claude Desktop does not support. Claude Desktop only supports stdio and sse transports. Updated to use mcp-remote bridge as the working solution for macOS and Windows. Added Connectors method as the recommended approach for Linux users, as the config file method is not supported on that platform. This fixes the "invalid MCP server config entries" error users were experiencing when trying to connect to the Redpanda docs MCP server.
Add clarity that Connectors method requires Pro/Max/Team/Enterprise plan, while config file method works for all plans including free tier. Also note that remote servers in config file may not work on all platforms, which is why the Connectors method is the more reliable option for paid plans.
Apply style guide improvements: - Use active voice - Reduce overuse of bold formatting - Format platform paths as bulleted list - Add context for code blocks - Standardize plan naming with 'or' instead of '/' - Split long explanatory sentences - Add periods to list items for consistency - Improve IMPORTANT note clarity
Per Google Developer Documentation Style Guide (which Redpanda follows), avoid using 'via' and prefer clearer alternatives like 'using'.
✅ Deploy Preview for redpanda-documentation ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
JakeSCahill
changed the title
Add Claude Code tab with CLI command for adding the MCP server. Uses mcp-remote bridge like Claude Desktop to connect to the HTTP endpoint. Includes verification command and documentation link.
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
Fixes https://redpandadata.atlassian.net/browse/DOC-2090
Fixes the Claude Desktop configuration for connecting to the Redpanda documentation MCP server.
The previous configuration used
"type": "http"which Claude Desktop does not support, causing "invalid MCP server config entries" errors. Claude Desktop only supportsstdioandssetransports.Changes
mcp-remotebridge (works for all plans)Testing
Verified that the
mcp-remoteconfiguration works on macOS as reported by Michele.