Chapter 1. MCP server overview (Technology Preview)

Procedure

1. Add the MCP server Helm repository. Run the following command:

   helm repo add acm-search https://raw.githubusercontent.com/stolostron/search-mcp-server/main/charts
   helm repo update

2. Install the MCP server with auto-discovery. Run the following command:

   helm install acm-mcp-server acm-search/acm-mcp-server \
     --create-namespace \
     --namespace acm-search

   The Helm chart automatically completes the following tasks:

   • Discovers your Red Hat Advanced Cluster Management MultiClusterHub installation
   • Builds the complete database connection URL
   • Deploys the MCP server with the required configuration

3. Verify that the MCP server is running in the acm-search namespace. Run the following command:

   oc get pods -n acm-search

   After you install the MCP server, you can connect your AI assistants or MCP clients.

Procedure

1. Edit the OLSConfig custom resource to add the MCP server. Run the following command:

   oc edit olsconfig cluster

   • If you do not have MCP servers configured in your OLSConfig custom resource, add featureGates and mcpServers to the following configuration:

     spec:
       featureGates:
         - MCPServer
       mcpServers:
         - headers:
             - name: Authorization
               valueFrom:
                 type: kubernetes
           name: acm
           timeout: 30
           url: 'http://acm-mcp-server.acm-search.svc.cluster.local/mcp'

   • If your OLSConfig custom resource already has MCP servers configured, add the MCP server to the existing mcpServers list. Your configuration might resemble the following example:

   mcpServers:
     - name: existing-server
       # ... existing server config ...
     - name: acm
       streamableHTTP:
         enableSSE: false
         headers:
           kubernetes-authorization: kubernetes
         sseReadTimeout: 10
         timeout: 30
         url: 'http://acm-mcp-server.acm-search.svc.cluster.local/mcp'

Procedure

1. Log in to the Red Hat Advanced Cluster Management hub cluster by using the oc command. Note: If your cluster uses a self-signed certificate, start Claude by setting the NODE_TLS_REJECT_UNAUTHORIZED environment variable to 0 in your command-line environment:

   export NODE_TLS_REJECT_UNAUTHORIZED=0

2. Retrieve the route that was created by the MCP server installation in the acm-search namespace:

   export ROUTE=$(oc get route acm-mcp-server -n acm-search -o jsonpath='{.spec.host}')

3. Run the following command to add the MCP server to Claude Code:

   claude mcp add --transport http -s project acm-search https://${ROUTE}/mcp --header "Authorization: Bearer $(oc whoami -t)"

4. Log in to Claude Code, connect to the MCP server named acm-search, use the tools.