rpk cloud mcp proxy

Introduced in version 25.2.3.

Proxy MCP requests from your local AI client to a remote MCP server running in your Redpanda Cloud cluster.

This command acts as a bridge between your AI assistant (like Claude) and your remote MCP server. It handles connection management, and request proxying so your AI client can use tools hosted in your cluster.

Modes of operation

Install mode (recommended): Generates and installs MCP client configuration files that tell your AI client how to connect. This is a one-time setup operation.

Proxy mode (default): Serves stdio and proxies requests in real-time. Your AI client connects to this command’s stdio interface, and requests are forwarded to the remote MCP server.

Usage

rpk cloud mcp proxy [flags]

Examples

Proxy requests to a specific MCP server:

rpk cloud mcp proxy --cluster-id <cluster-id> --mcp-server-id <server-id>

Install Claude Code configuration for connecting to your MCP server in Redpanda Cloud BYOC or Dedicated:

rpk cloud mcp proxy --install --client claude-code --cluster-id <cluster-id> --mcp-server-id <server-id>

Install Claude Code configuration for connecting to your MCP server in Redpanda Cloud Serverless:

rpk cloud mcp proxy --install --client claude-code --serverless-cluster-id <cluster-id> --mcp-server-id <server-id>

Flags

Value Type Description

--client

string

Name of the MCP client to configure. Required when using --install. Supported values: claude and claude-code.

--cluster-id

string

Cluster ID where your Remote MCP server is running. Find this in the Redpanda Cloud Console.

--serverless-cluster-id

string

Serverless cluster ID where your Remote MCP server is running. Find this in the Redpanda Cloud Console.

-h, --help

-

Help for proxy.

--install

-

Install MCP client configuration instead of serving stdio. Use this for one-time setup.

--mcp-server-id

string

ID of the Remote MCP server to connect to. Find this in your cluster’s Remote MCP page.

--config

string

Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail.

--profile

string

Profile to use. See rpk profile for more details.

-v, --verbose

-

Enable verbose logging.

See also