diff --git a/docs/toolhive/kubernetes/deploy-operator-helm.md b/docs/toolhive/kubernetes/deploy-operator-helm.md
index 47ef88b..6b90932 100644
--- a/docs/toolhive/kubernetes/deploy-operator-helm.md
+++ b/docs/toolhive/kubernetes/deploy-operator-helm.md
@@ -19,6 +19,13 @@ Kubernetes cluster.
 
 ## Install the operator
 
+:::note
+
+You must first be authenticated to ghcr.io following
+[these instructions](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-with-a-personal-access-token-classic).
+
+:::
+
 To install the ToolHive operator using Helm and the default settings, follow
 these steps:
 
diff --git a/docs/toolhive/kubernetes/intro.md b/docs/toolhive/kubernetes/intro.md
index 338567e..bd1d581 100644
--- a/docs/toolhive/kubernetes/intro.md
+++ b/docs/toolhive/kubernetes/intro.md
@@ -51,13 +51,9 @@ flowchart TB
 
 ## Installation
 
-To install the ToolHive operator in your Kubernetes cluster, use Helm. Helm
-simplifies the installation process and lets you manage the operator using Helm
-charts.
-
-[Deploy the operator using Helm](./deploy-operator-helm.md)
+[Use Helm to install the ToolHive operator](./deploy-operator-helm.md) in your
+Kubernetes cluster. Helm simplifies the installation process and lets you manage
+the operator using Helm charts.
 
 Once the operator is installed, you can create and manage MCP servers using the
-`MCPServer` custom resource.
-
-[Run MCP servers in Kubernetes](./run-mcp-k8s.md)
+[`MCPServer` custom resource](./run-mcp-k8s.md).