Claude Platform Docs

Crea tunnel

$ ant beta:tunnels create
POST/v1/tunnels

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Crea un tunnel. La creazione alloca un nuovo hostname ed effettua il provisioning del tunnel; non è idempotente. Il nuovo tunnel rifiuta il traffico MCP finché non viene aggiunto almeno un certificato CA.

Parameters
--display-name: optional string

Optional human-readable name for the tunnel (1-255 characters).

minLength1
maxLength255
--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send mcp-tunnels-2026-06-22 in this header.

--workspace-id: optional string⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
beta_tunnel: object{ type: "tunnel", id, archived_at, 3 more }

An MCP tunnel.

type: "tunnel"
id: string

Unique identifier for the tunnel, prefixed with tnl_.

archived_at: string

RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the tunnel was created.

formatdate-time
display_name: string

Human-readable name for the tunnel (1-255 characters). Null if unset.

domain: string

Anthropic-assigned hostname for the tunnel. MCP server URLs whose host is a subdomain of this value are routed through the tunnel. Globally unique and never reused, even after the tunnel is archived.

Crea tunnel
ant beta:tunnels create \
  --api-key my-anthropic-api-key
Returns Examples
Response 200
{
  "id": "id",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "display_name": "display_name",
  "domain": "domain",
  "type": "tunnel"
}