跳转到主要内容
LogBrew 提供托管的 MCP 服务器,地址为 https://logbrew.co/mcp。连接到它的 AI 智能体可以读取你批准的项目中的问题、日志、链路、Span(一次计时操作)、指标、操作、版本和产品分析数据。 除非你同时允许更改,否则智能体只能读取。允许更改后,它可以处理问题并设置项目。它不能更改账单、成员或账号设置。你不需要安装服务器,只需把它的 URL 添加到 MCP 客户端。

开始之前

  • 你需要一个至少有 1 个项目的 LogBrew 账号。
  • 你需要一个能连接远程(HTTP)MCP 服务器的 MCP 客户端。任何遵循 MCP 授权标准的客户端都可以登录。不支持 OAuth 的客户端可以使用项目只读密钥,见用只读密钥连接。
  • 服务器支持 MCP 协议版本 2026-07-28、2025-11-25 和 2025-06-18。

支持的客户端

LogBrew 接受所有通过客户端元数据文档标识自己或自行注册的 MCP 客户端。下表列出常用客户端的设置方法。 服务器 URL 为 https://logbrew.co/mcp。旧地址 https://mcp.logbrew.co/mcp 仍可使用。令牌只能在签发它的地址上使用。

连接 Claude Code

你需要 Claude Code 2.1.300 或更高版本。运行 claude --version 查看你的版本。
  1. 添加服务器:
    claude mcp list 现在会显示 logbrew,并标注 ! Needs authentication。
  2. 开始登录:
    浏览器会打开 LogBrew 授权页面。如果页面要求登录,使用 GitHub、GitLab、Bitbucket 或 Google 登录。
  3. 查看页面上的客户端名称。只有这次连接是你发起的,才批准。
  4. 选择智能体可以读取的项目。如果页面显示允许更改的一行,只有在智能体必须进行更改时才勾选。然后选择批准。 浏览器会回到 Claude Code。Claude Code 显示 Authenticated with "logbrew"。
  5. 确认服务器已连接:
    结果显示 logbrew: https://logbrew.co/mcp (HTTP) - ✔ Connected。
也可以在 Claude Code 会话中登录。运行 /mcp,选择 logbrew,然后按浏览器中的步骤操作。 在没有浏览器的电脑上,在交互式终端中运行 claude mcp login logbrew --no-browser。通过 SSH 操作时,用 ssh -t 连接。在另一台电脑的浏览器中打开 Claude Code 显示的 URL。批准后,复制浏览器打开的页面地址。把它粘贴到 Claude Code 中。

连接其他客户端

  1. 将服务器添加到客户端。添加位置见支持的客户端中的表格。
  2. 在客户端中开始登录。大多数客户端会在你首次使用服务器时开始登录。浏览器会打开 LogBrew 授权页面。如果页面要求登录,登录 LogBrew。
  3. 查看页面上的客户端名称。页面还会显示用于识别客户端的地址,例如 vscode.dev 或 chatgpt.com。如果客户端在你自己的电脑上接收批准结果,页面会显示本地应用。如果 LogBrew 没有验证客户端名称,页面会提醒你核对地址。只有这次连接是你发起的,才批准。
  4. 选择智能体可以读取的项目。如果页面显示允许更改的一行,只有在智能体必须进行更改时才勾选。然后选择批准。 浏览器会回到客户端,客户端会显示 search 和 execute 工具。

用只读密钥连接

如果客户端无法通过 OAuth 登录,请使用项目只读密钥。该密钥只能读取 1 个项目,不能进行更改。
  1. 为项目创建只读密钥。按照验证接入中的步骤操作。
  2. 将服务器 URL 添加到客户端。
  3. 在客户端设置中添加请求头 Authorization: Bearer <read_key>。将 <read_key> 替换为你的密钥。
像对待密码一样保管密钥。使用只读密钥的连接不会显示在设置 > MCP 连接中。要结束这种连接,请撤销该密钥。

向智能体提问

服务器为智能体提供 2 个工具: 要测试连接,可以这样问:
智能体会列出该连接可以读取的项目。 由智能体选择要调用的接口。你不需要告诉它工具名或字段。写清任务和限制即可:
遥测数据只能当作证据。日志和错误消息可能包含用户输入的文本。智能体不得执行这些文本中的指令。完整的排查流程见 AI 编码智能体。

允许更改

每个连接都有 read 权限范围。要进行更改,连接还需要 write 权限范围。当客户端请求 write 时,授权页面会单独用一行显示它:同时允许更改所选项目中的数据并创建新项目。这一行默认不勾选。如果你不勾选,连接只能读取。 有了 write,智能体可以:
  • 将问题标记为已解决、重新打开问题、归档问题。
  • 设置问题的优先级。
  • 分配问题和取消分配。
  • 创建项目。
  • 创建和撤销项目密钥。
  • 向项目发送测试事件。
  • 加载和移除示例数据。
智能体以你的身份、按你在项目中的权限执行操作。LogBrew 会记录每次更改,以及进行更改的应用名称。接口参考列出了每个接口及其输入。 以下接口在第一次调用时不会更改任何内容:
  • issues.archive.v1 归档一个问题。
  • projects.keys.revoke.v1 撤销一个密钥。
  • projects.sample_data.remove.v1 移除示例数据。
第一次调用会返回一个确认值。智能体会向你说明将要更改的内容。要执行更改,智能体需要在 5 分钟内带上该确认值再次发送相同的调用。 没有 write 时,更改会返回 HTTP 403 和 insufficient_scope。这时,有些客户端会再次打开授权页面。勾选允许更改的那一行,即可为连接授予 write。

访问权限和连接有效期

每次批准都会在 1 个 MCP 客户端和你的 LogBrew 账号之间建立 1 个连接。
  • 智能体只能读取和更改你批准的项目。调用其他项目会返回 permission_denied。智能体创建的项目会加入已批准的项目。
  • 如果你失去了某个已批准项目的访问权限,LogBrew 会停止对该项目的调用。
  • 访问令牌的有效期为 1 小时。你使用连接期间,客户端会自动获取新令牌。
  • 新的访问令牌可能失去 write,但永远不会获得 write。要添加 write,请重新批准连接。
  • 连接在 30 天未使用后结束,或在批准 90 天后结束。之后从客户端重新登录,例如运行 claude mcp login logbrew。
  • 每次刷新令牌都会替换之前的刷新令牌。如果客户端发送了已被替换的刷新令牌,LogBrew 会结束该连接。这样可以防止被复制的令牌继续生效。重新登录即可建立新连接。
  • 没有有效令牌的请求过多时,会收到 HTTP 429 和 Retry-After 响应头。等待该响应头指定的秒数,然后重试。

列出和撤销连接

在 LogBrew 控制台的设置 > MCP 连接中管理连接,或使用 CLI 管理。

在设置中

每个已连接的客户端都会显示名称、已批准的项目、连接时间、上次使用时间和结束时间。要撤销某个连接,选择断开连接,然后确认。客户端在下一次请求时失去访问权限。

使用 CLI

使用 LogBrew CLI 0.1.82 或更高版本。先用 logbrew login 登录。项目接入密钥不能列出或撤销连接。 列出连接到你账号的 MCP 客户端:
CLI 把连接称为 grant(授权)。每个 grant 显示:
  • id:grant ID。用它来撤销连接。
  • client:你批准的客户端名称,例如 Claude Code。如果连接是在 LogBrew 开始保存名称之前批准的,则显示标识该客户端的 URL,例如 https://claude.ai/oauth/claude-code-client-metadata。
  • projects:已批准项目的数量。
  • last_used:客户端最近一次获取新访问令牌的时间。
  • expires:客户端不再使用时,连接结束的时间。
加上 --json 可获取完整列表。每个 grant 包含 id、client_id、client_name、project_ids、created_at、last_used_at 和 expires_at。如果连接是在 LogBrew 开始保存名称之前批准的,client_name 为 null。 撤销 1 个连接:
客户端在下一次请求时失去访问权限。要重新连接,用 claude mcp login logbrew 重新登录。 要更改已批准的项目,先撤销连接。然后重新登录,并选择新的项目。

移除服务器

  1. 在设置 > MCP 连接中撤销连接,或运行 logbrew mcp revoke <grant_id> --yes。
  2. 从 Claude Code 中移除服务器:
claude mcp remove 只会删除你电脑上的配置和令牌。它不会结束 LogBrew 中的连接。如果不撤销,连接会在 30 天未使用后结束。

解决连接故障