Claude Platform Docs

列出隧道证书

$ ant beta:tunnels:certificates list
GET/v1/tunnels/{tunnel_id}/certificates

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

列出在隧道上注册的证书。除非设置了 include_archived，否则不包含已归档的证书。

Parameters
--tunnel-id: string⁠Path parameter

ID of the tunnel (tnl_...).

--include-archived: optional boolean⁠Query parameter

Whether to include archived certificates in the results. Defaults to false.

--limit: optional number⁠Query parameter

Maximum number of certificates to return per page. Defaults to 20, maximum 1000.

formatint32
--page: optional string⁠Query parameter

Opaque pagination cursor from a previous list_tunnel_certificates response.

--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
BetaListTunnelCertificatesResponse: object{ data, next_page }

The tunnel's certificates.

data: array of BetaTunnelCertificate { type: "tunnel_certificate", id, archived_at, 4 more }

List of certificates, ordered by created_at descending.

type: "tunnel_certificate"
id: string

Unique identifier for the certificate, prefixed with tcrt_.

archived_at: string

RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.

formatdate-time
created_at: string

RFC 3339 datetime string indicating when the certificate was registered.

formatdate-time
expires_at: string

RFC 3339 datetime string indicating when the certificate expires, or null if it does not expire.

formatdate-time
fingerprint: string

Lowercase hex SHA-256 fingerprint of the certificate's DER encoding.

tunnel_id: string

ID of the tunnel the certificate is registered against.

next_page: string

Pagination cursor for the next page, or null if no more results.

列出隧道证书
ant beta:tunnels:certificates list \
  --api-key my-anthropic-api-key \
  --tunnel-id tunnel_id
Returns Examples
Response 200
{
  "data": [
    {
      "id": "id",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "created_at": "2019-12-27T18:11:19.117Z",
      "expires_at": "2019-12-27T18:11:19.117Z",
      "fingerprint": "fingerprint",
      "tunnel_id": "tunnel_id",
      "type": "tunnel_certificate"
    }
  ],
  "next_page": "next_page"
}