Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 23 additions & 19 deletions docs/lightspeed-integration.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,35 @@
# Guide for Setting Up StackRox MCP OpenShift Lightspeed Integration

Guide tested with OpenShift Lightspeed version `1.1.3`.
Guide tested with OpenShift Lightspeed version `2.0.1`.

### 1. Set Up OpenShift Lightspeed
- Set up your OpenShift Lightspeed integration with a large language model (LLM) service. Detailed documentation can be found in the [Red Hat OpenShift Lightspeed Configuration Guide](https://docs.redhat.com/en/documentation/red_hat_openshift_lightspeed/1.0/html/configure/ols-configuring-openshift-lightspeed).
- Set up your OpenShift Lightspeed integration with a large language model (LLM) service. Detailed documentation can be found in the [Red Hat OpenShift Lightspeed Configuration Guide](https://docs.redhat.com/en/documentation/red_hat_openshift_lightspeed/2.0/html/configure/ols-configuring-openshift-lightspeed).
- After OpenShift Lightspeed integration with the LLM is configured and tested, you can continue with StackRox MCP setup.

### 2. Set Up StackRox MCP
- Install StackRox MCP with Helm:
### 2. Set Up ACS MCP server
- Install ACS MCP server with Helm:
```bash
# Create temp directory and checkout repository with Helm chart.
tmp_stackrox_mcp_dir="stackrox-mcp-${RANDOM}"
export tmp_stackrox_mcp_dir="/tmp/stackrox-mcp-${RANDOM}"
git clone --depth 1 --branch main https://github.com/stackrox/stackrox-mcp.git "${tmp_stackrox_mcp_dir}"

# Assuming StackRox Central is installed on the same cluster in the "stackrox" namespace.
# Assuming Red Hat ACS Central is installed on the same cluster in the "stackrox" namespace.
# This installs MCP for a local Central: served over HTTP in-cluster and trusting
# Central's self-signed certificate. For production, use TLS (see the chart README).
helm upgrade stackrox-mcp "${tmp_stackrox_mcp_dir}/charts/stackrox-mcp" \
helm upgrade rhacs-mcp "${tmp_stackrox_mcp_dir}/charts/stackrox-mcp" \
Comment thread
mtodor marked this conversation as resolved.
Resolved
--install \
--namespace stackrox-mcp --create-namespace \
--namespace rhacs-mcp --create-namespace \
--set config.central.insecureSkipTLSVerify=true \
--set config.server.TLSEnabled=false \
--set config.server.port=8080 \
--set service.type=ClusterIP \
--set service.port=8080 \
--set openshift.route.tls.termination=edge \
--set replicaCount=1
--set replicaCount=1 \
--set image.registry=registry.redhat.io \
--set image.repository=agentic-cluster-security-suite-tech-preview/acs-mcp-server-rhel9 \
--set image.tag=0.2 \
--set fullnameOverride=rhacs-mcp

# Delete temp directory.
rm -rf "${tmp_stackrox_mcp_dir}"
Expand All @@ -42,16 +46,16 @@ Guide tested with OpenShift Lightspeed version `1.1.3`.
- Verify the MCP server is running:
```bash
kubectl run -i --tty --rm debug --image=quay.io/curl/curl:latest --restart=Never -- \
curl http://stackrox-mcp.stackrox-mcp:8080/health
curl -k http://rhacs-mcp.rhacs-mcp:8080/health
```
You should get `{"status":"ok"}` as a response.

### 3. Set Up Integration of StackRox MCP with OpenShift Lightspeed
- Create an API token in StackRox Central with appropriate permissions.
- Create the `stackrox-mcp-authorization-header` secret in the `openshift-lightspeed` namespace (kubectl encodes the value for you):
### 3. Set Up Integration of ACS MCP server with OpenShift Lightspeed
- Create an API token in Red Hat ACS Central with appropriate permissions.
- Create the `rhacs-mcp-authorization-header` secret in the `openshift-lightspeed` namespace (kubectl encodes the value for you):
```bash
stackrox_api_token="<StackRox API Token>"
kubectl create secret generic stackrox-mcp-authorization-header \
export stackrox_api_token="<StackRox API Token>"
kubectl create secret generic rhacs-mcp-authorization-header \
--namespace openshift-lightspeed \
--from-literal=header="Bearer ${stackrox_api_token}"
```
Expand All @@ -60,17 +64,17 @@ Guide tested with OpenShift Lightspeed version `1.1.3`.
featureGates:
- MCPServer
mcpServers:
- name: stackrox-mcp
- name: rhacs-mcp
headers:
- name: authorization
valueFrom:
type: secret
secretRef:
name: stackrox-mcp-authorization-header
name: rhacs-mcp-authorization-header
timeout: 120
url: 'http://stackrox-mcp.stackrox-mcp:8080/mcp'
url: 'http://rhacs-mcp.rhacs-mcp:8080/mcp'
```
- After completing the setup, test your integration with a simple prompt: "List all clusters secured by StackRox"
- After completing the setup, test your integration with a simple prompt: "List all clusters secured by ACS"

### Troubleshooting
If you encounter issues, refer to the [Troubleshooting](../charts/stackrox-mcp/README.md#troubleshooting) section in the Helm chart documentation.
Loading