Skip to content
Merged
Show file tree
Hide file tree
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
3 changes: 0 additions & 3 deletions docs/toolhive/guides-cli/build-containers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -222,9 +222,6 @@ you want to pre-build containers before deploying them.
spec:
image: ghcr.io/myorg/mcp-git:v1.0.0
transport: stdio
permissionProfile:
type: builtin
name: network
```

### CI/CD integration
Expand Down
56 changes: 1 addition & 55 deletions docs/toolhive/guides-k8s/run-mcp-k8s.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -120,9 +120,6 @@ spec:
transport: streamable-http
targetPort: 8080
port: 8080
permissionProfile:
type: builtin
name: network
resources:
limits:
cpu: '100m'
Expand Down Expand Up @@ -222,9 +219,6 @@ spec:
transport: streamable-http
targetPort: 8080
port: 8080
permissionProfile:
type: builtin
name: network
podTemplateSpec:
spec:
containers:
Expand Down Expand Up @@ -285,9 +279,6 @@ spec:
image: ghcr.io/github/github-mcp-server
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: network
secrets:
- name: github-token
key: token
Expand Down Expand Up @@ -334,9 +325,6 @@ spec:
image: ghcr.io/github/github-mcp-server
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: network
secrets:
- name: github-token
key: token
Expand Down Expand Up @@ -398,9 +386,6 @@ spec:
image: docker.io/mcp/filesystem
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: none
podTemplateSpec:
spec:
volumes:
Expand Down Expand Up @@ -449,18 +434,6 @@ to learn how to connect to MCP servers using different clients.
`MCPServer` Custom Resource Definition (CRD)
- [Deploy the operator using Helm](./deploy-operator-helm.md) - Install the
ToolHive operator
- [Custom permissions](../guides-cli/custom-permissions.mdx) - Configure
permission profiles

:::info[Important]

Outbound network filtering using permission profiles isn't currently implemented
in the ToolHive Operator. This is a roadmap feature planned for future releases.

Contributions to help implement this feature are welcome! You can contribute by
visiting our [GitHub repository](https://github.com/stacklok/toolhive).

:::

## Troubleshooting

Expand Down Expand Up @@ -530,7 +503,7 @@ Common causes include:
- **Missing secrets**: Ensure required secrets exist and are properly referenced
- **Resource constraints**: Check if the pod has sufficient CPU and memory
resources
- **Permission issues**: Verify the security context and permission profile are
- **Permission issues**: Verify the security context and RBAC permissions are
correctly configured
- **Invalid arguments**: Check if the `args` field contains valid arguments for
the MCP server
Expand Down Expand Up @@ -622,33 +595,6 @@ Common causes include:

</details>

<details>
<summary>Permission profile errors</summary>

If the MCP server fails due to permission profile issues:

```bash
# Check if ConfigMap exists (for custom profiles)
kubectl -n <NAMESPACE> get configmap <CONFIGMAP_NAME>

# Verify ConfigMap content
kubectl -n <NAMESPACE> describe configmap <CONFIGMAP_NAME>

# Check operator logs for permission errors
kubectl -n toolhive-system logs -l app.kubernetes.io/name=toolhive-operator | grep -i permission
```

Common causes include:

- **Invalid profile name**: Ensure built-in profile names are correct (`none`,
`network`)
- **ConfigMap not found**: Create the ConfigMap with the custom permission
profile
- **Invalid JSON**: Verify the permission profile JSON is valid
- **Missing key**: Ensure the specified key exists in the ConfigMap

</details>

<details>
<summary>Resource limit issues</summary>

Expand Down
6 changes: 0 additions & 6 deletions docs/toolhive/guides-mcp/context7.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -112,9 +112,6 @@ spec:
image: ghcr.io/stacklok/dockyard/npx/context7:1.0.14
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: network
```

Apply the manifest to your cluster:
Expand All @@ -138,9 +135,6 @@ spec:
- 'YOUR_API_KEY'
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: network
```

</TabItem>
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/guides-mcp/fetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,9 +84,6 @@ spec:
transport: streamable-http
targetPort: 8080
port: 8080
permissionProfile:
type: builtin
name: network
```

Apply the manifest to your Kubernetes cluster:
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/guides-mcp/filesystem.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -124,9 +124,6 @@ spec:
image: mcp/filesystem:latest
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: none # Note, network isolation in K8s is not implemented yet
args:
- '/projects' # Update if you use a different mountPath below
podTemplateSpec:
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/guides-mcp/github.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -144,9 +144,6 @@ spec:
image: ghcr.io/github/github-mcp-server:v0.13.0
transport: stdio
port: 8080
permissionProfile:
type: builtin
name: network
secrets:
- name: github-token
key: token
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/guides-mcp/k8s.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -137,9 +137,6 @@ spec:
targetPort: 8080
port: 8080
serviceAccount: mkp-sa
permissionProfile:
type: builtin
name: network
---
apiVersion: v1
kind: ServiceAccount
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/guides-mcp/osv.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,9 +79,6 @@ spec:
transport: streamable-http
targetPort: 8080
port: 8080
permissionProfile:
type: builtin
name: network
```

Apply the manifest to your Kubernetes cluster:
Expand Down
9 changes: 0 additions & 9 deletions docs/toolhive/guides-mcp/playwright.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -156,9 +156,6 @@ spec:
args:
- '--port'
- '8931'
permissionProfile:
type: builtin
name: network
```

Apply the manifest to your Kubernetes cluster:
Expand All @@ -185,9 +182,6 @@ spec:
- '8931'
- '--allowed-origins'
- 'example.com;trusted-domain.org'
permissionProfile:
type: builtin
name: network
```

Mount a persistent volume to save browser output files like screenshots and
Expand All @@ -211,9 +205,6 @@ spec:
- '/browser-output'
- '--save-trace'
- '--save-session'
permissionProfile:
type: builtin
name: network
podTemplateSpec:
spec:
volumes:
Expand Down
3 changes: 0 additions & 3 deletions docs/toolhive/tutorials/vault-integration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -168,9 +168,6 @@ spec:
image: ghcr.io/github/github-mcp-server:latest
transport: stdio
port: 9095
permissionProfile:
type: builtin
name: network
resources:
limits:
cpu: '100m'
Expand Down