列出隧道

get /v1/organizations/tunnels

列出组织的隧道。

结果覆盖调用者的组织，按创建时间排序（最新优先）。使用 workspace_id 过滤单个工作区；除非设置 include_archived，否则已归档的隧道将被排除。

查询参数

• include_archived: optional boolean

  在结果中包含已归档的隧道。默认情况下排除已归档的隧道。

• limit: optional number

  单页返回的最大隧道数量。

• page: optional string

  来自上一次响应 next_page 的不透明分页游标。省略则获取第一页。

• workspace_id: optional string

  仅返回此工作区中的隧道。接受 wrkspc_ 前缀的工作区 ID；省略则列出所有工作区的隧道。

请求头参数

• "anthropic-beta": array of "mcp-tunnels-2026-05-19"

  所有隧道端点都需要此参数。

  • "mcp-tunnels-2026-05-19"

返回值

• data: array of object { id, archived_at, created_at, 4 more }

  • id: string

    隧道的 ID。

  • archived_at: string

    RFC 3339 日期时间字符串，表示隧道被归档的时间，如果未归档则为 null。

  • created_at: string

    RFC 3339 日期时间字符串，表示隧道的创建时间。

  • display_name: string

    隧道的可读名称（1–255 个字符），如果未设置则为 null。

  • domain: string

    Anthropic 为主机分配的隧道主机名。主机为该值子域名的 MCP 服务器 URL 将通过该隧道路由。全局唯一，即使隧道被归档后也不会被重用。

  • type: "tunnel"

    对象类型。隧道始终为 tunnel。

    • "tunnel"

  • workspace_id: string

    该隧道所属工作区的 ID，默认工作区为 null。创建后不可更改。

• next_page: string

  下一页的不透明游标，如果没有更多结果则为 null。

示例

curl https://api.anthropic.com/v1/organizations/tunnels \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_WIF_BEARER_TOKEN"

响应

{
  "data": [
    {
      "id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
      "archived_at": "2024-11-01T23:59:27.427722Z",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "Production",
      "domain": "a1b2c3d4.tunnel.anthropic.com",
      "type": "tunnel",
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}