通道

建立通道

client.Beta.Tunnels.New(ctx, params) (*BetaTunnel, error)

POST/v1/tunnels

Tunnels API 目前為研究預覽版。它需要 anthropic-beta: mcp-tunnels-2026-06-22 標頭，且可能在沒有棄用期的情況下變更。它取代了位於 /v1/organizations/tunnels 的 Admin API 端點，這些端點在遷移期間內仍可使用。

取得通道

client.Beta.Tunnels.Get(ctx, tunnelID, query) (*BetaTunnel, error)

GET/v1/tunnels/{tunnel_id}

列出通道

client.Beta.Tunnels.List(ctx, params) (*PageCursor[BetaTunnel], error)

GET/v1/tunnels

封存通道

client.Beta.Tunnels.Archive(ctx, tunnelID, body) (*BetaTunnel, error)

POST/v1/tunnels/{tunnel_id}/archive

顯示通道權杖

client.Beta.Tunnels.RevealToken(ctx, tunnelID, body) (*BetaTunnelToken, error)

POST/v1/tunnels/{tunnel_id}/reveal_token

輪替通道權杖

client.Beta.Tunnels.RotateToken(ctx, tunnelID, params) (*BetaTunnelToken, error)

POST/v1/tunnels/{tunnel_id}/rotate_token

Models

type BetaTunnel struct { Type: "tunnel"; ID; ArchivedAt; /* 3 more */ }

An MCP tunnel.

Type Tunnel

ID string

Unique identifier for the tunnel, prefixed with tnl_.

ArchivedAt Time

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

formatdate-time

CreatedAt Time

RFC 3339 datetime string indicating when the tunnel was created.

formatdate-time

DisplayName 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.

type BetaTunnelToken struct { Type: "tunnel_token"; ID; TunnelToken }

A tunnel's connector token.

Type TunnelToken

ID string

Stable identifier for the current token value. Changes when the token is rotated.

TunnelToken string

The connector token used to run the tunnel. Treat as a credential.

通道憑證

建立通道憑證

client.Beta.Tunnels.Certificates.New(ctx, tunnelID, params) (*BetaTunnelCertificate, error)

POST/v1/tunnels/{tunnel_id}/certificates

取得通道憑證

client.Beta.Tunnels.Certificates.Get(ctx, certificateID, params) (*BetaTunnelCertificate, error)

GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

列出通道憑證

client.Beta.Tunnels.Certificates.List(ctx, tunnelID, params) (*PageCursor[BetaTunnelCertificate], error)

GET/v1/tunnels/{tunnel_id}/certificates

封存通道憑證

client.Beta.Tunnels.Certificates.Archive(ctx, certificateID, params) (*BetaTunnelCertificate, error)

POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

通道

Models

通道憑證

通道憑證