Skip to content

Commit bf83e83

Browse files
committed
docs: clarify sandbox MCP policy scope
MCP access guidance could imply that blocking a server prevents every connection from a sandbox. Clarify that MCP policy governs the Docker gateway path, while network policy governs direct outbound MCP connections.
1 parent 2712b53 commit bf83e83

2 files changed

Lines changed: 16 additions & 1 deletion

File tree

content/manuals/ai/sandboxes/governance/access-controls/mcp.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: MCP access policies
33
linkTitle: MCP access
44
weight: 50
5-
description: Use Cedar-based MCP policies to control sandbox MCP server registration, tool calls, prompts, resources, and approval gates.
5+
description: Use Cedar-based policies to control MCP server registration and activity routed through the Docker Sandboxes MCP gateway.
66
keywords: docker sandboxes, MCP policy, MCP access, Cedar policy, requireApproval, AI Governance
77
---
88

@@ -13,6 +13,14 @@ withdraw access to a server, require approval for tool calls, and restrict
1313
host-run servers. To register MCP servers and connect them to sandboxes, see
1414
[MCP gateway](../../mcp-gateway.md).
1515

16+
MCP access policies apply only to server registration and requests handled by
17+
Docker's MCP gateway. They don't govern an MCP server that an agent or MCP
18+
client configures and connects to directly from inside the sandbox. A direct
19+
connection to a remote MCP server is outbound sandbox traffic, so
20+
[network access policy](network.md) determines whether the sandbox can reach
21+
the server. To prevent access through both paths, block the server in MCP
22+
access policy and block its network destination in network access policy.
23+
1624
Unlike [network access policies](network.md) and
1725
[filesystem access policies](filesystem.md), MCP policies are organization
1826
policies written in Cedar. Docker defines the `MCP` namespace, including the

content/manuals/ai/sandboxes/governance/access-controls/network.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,3 +59,10 @@ organization or to selected teams. For setup steps and team scoping, see
5959

6060
Use [Monitoring policies](../monitor-and-enforce/monitoring.md) to inspect
6161
which network rules are active on a developer machine.
62+
63+
> [!NOTE]
64+
> To manage Model Context Protocol (MCP) server registration and requests
65+
> through Docker's MCP gateway, use [MCP access policies](mcp.md). These
66+
> policies apply only to the gateway. Direct MCP connections from a sandbox
67+
> don't use the gateway, but you can control access to remote MCP servers with
68+
> network policy.

0 commit comments

Comments
 (0)