developers · May 20, 2026

我們如何用 Quire MCP 與 Claude Managed Agents 打造每週更新日誌代理

AI 翻譯
· 查看英文版

Claude 代理在 Quire 專案中產生每週更新日誌簡報

最後更新:2026 年 5 月 25 日

TL;DR:我們用一個 Claude Managed Agent 取代了每週一的回顧會議。它透過 Quire MCP 讀取我們的 Dev_Changelog Quire 專案,把過去七天內已完成的工作依標籤分組,並把客戶可讀的每週簡報寫成一份新的 Quire 文件。在 Haiku 4.5 上的執行時間 不到 30 秒。最不直觀但效果最大的優化是積極過濾工具集,這把每次執行的輸入 token 數從約 82,000 降到約 12,000,讓這項工作在不升級 API 的情況下仍維持在 Tier 1 速率限制內。

時間是週一上午 9:04。團隊頻道裡有人問:「嘿,上週出了什麼,快速回顧一下?」三個人打開分頁、滾動看板,努力回想那四十個已關閉任務中,到底哪些真的有意義,二十分鐘後回來丟出兩個項目符號加一個聳肩。本來預定十分鐘的回顧會議拖到四十分鐘。到了週二,大家又通通忘了內容。

我們把這個迴圈換掉了。我們用 Quire MCP 與 Claude Managed Agents 打造了一個代理,讓它每週一早上讀取我們的 Dev_Changelog 專案,找出過去七天內所有已完成的項目,依團隊分組,把開發端的縮寫翻譯成客戶看得懂的語言,並把整份簡報寫進一份全新的 Quire 文件。總執行時間:不到三十秒。後續維護成本:零。

這篇文章是完整的建置過程,包括途中壞掉的三件事,以及我們是怎麼修好的。如果你一直想要一個能對你的專案資料做實際工作、而不只是閒聊的 AI 代理,這就是一份可以照做的食譜。

代理實際產出的是什麼?

每週一太平洋時間早上 9 點,一個 Claude session 醒來,查詢 Quire,並在我們的 Dev_Changelog 專案中建立一份新文件,標題為 Weekly Brief: May 15 to May 21, 2026。文件包含五個區段,依序為:

  • Highlights:依使用者影響力排序的前三項
  • Features Shipped:每項新功能都被翻譯成使用者面向的好處
  • Bugs Fixed:說明修復前使用者所遇到的情況
  • Design Updates:聚焦於哪些視覺面發生了變化
  • Social and Marketing:在任務描述中有提到時,附上互動數據

空的區段會被靜默略過。底部有一行統計摘要。整份內容約 400 字,讀起來像內部摘要而不是行銷更新日誌,因為系統提示要求的正是這個。

看實際範例:代理讀取的來源是 已過濾的 Dev_Changelog 來源專案,而 Weekly Brief: May 15 to May 21, 2026 就是它實際產生的那份文件。

Dev_Changelog 過濾後來源專案與產生的 Weekly Brief 文件並排對照

團隊在站會時兩分鐘就讀完。沒人需要寫,也沒人需要記得要寫。

Quire MCP 與 Claude Managed Agents 各自帶來什麼?

Quire MCP 是一個 Model Context Protocol 伺服器,部署在 https://mcp.quire.app/mcp。它把 Quire 的 API 以一組標準化工具的形式公開,任何相容 MCP 的客戶端都可以呼叫。總共大約 95 個工具,從 search_taskscreate_document 再到 bulk_create_tasks 應有盡有。代理不需要知道 Quire 的 REST API 長什麼樣,它看到的就是一個工具目錄,按需呼叫。

Claude Managed Agents 是 Anthropic 提供的自主代理託管執行環境。你定義代理(模型 + 系統提示 + 工具設定)、環境(具備網路政策的沙箱容器),並建立 session 來實際執行工作。Anthropic 處理沙箱、憑證代理、執行迴圈、稽核日誌,這些通通不是你需要自己寫的程式碼。

兩者組合起來才有意義,因為單獨任何一塊都只是水管。沒有代理的 Quire MCP 只是一個沒人呼叫的工具目錄;沒有特定領域 MCP 的 Claude Managed Agents 則是一個無事可做的沙箱。把它們接上,你就得到一個對真實的正式環境資料採取實際行動的代理,並且內建完整的驗證與沙箱機制。

不用 Claude Managed Agents?Quire MCP 也可以搭配開放原始碼的 MCP 客戶端 Open Claw。同樣的工具目錄、同樣的 OAuth 流程、同樣可以堆疊出來的工作流程。挑一個適合你技術棧的執行環境就好。

為什麼這很重要:大多數專案管理工具還沒推出公開的 MCP 伺服器。Asana、Monday 和 ClickUp 都有 REST API 但沒有 MCP,所以你得自己包一層並處理驗證。Notion 有 MCP,但它的工具介面是為文件和頁面而設計,並不是專案自動化真正需要的任務與子任務結構。Quire MCP 是圍繞著代理實際操作的工作單元(任務、子任務、狀態、標籤、子清單)打造的,這也是為什麼這次建置只花了一個下午、而不是一個季度。

一步一步建起來

整個設定大約花了一小時,其中大部分時間都花在跟一個設定陷阱奮戰,等下會講到。以下是實際的食譜。

1. 代理定義

代理是一份單一的 YAML 檔。系統提示是最關鍵的部分,因為它就是把一個泛用的 Claude session 變成更新日誌寫手的關鍵:

name: Dev Changelog Writer
model:
  id: claude-haiku-4-5
  speed: standard
system: |-
  You are the weekly changelog writer for the Quire project
  "Dev_Changelog" (https://quire.io/w/Dev_Changelog).
  When invoked:
  1. Use the Quire MCP to search Dev_Changelog for tasks where status
     is completed and the `toggled` timestamp falls within the last 7
     days. Pull name, description, priority, tags, and subtasks.
  2. Group results by tag: feature, bugfix, design, social. Within
     each group, sort by priority (urgent, high, medium, low).
  3. Translate each task from internal dev shorthand into plain
     language a customer would understand. Features: lead with the
     user-facing benefit. Bugfixes: lead with what the user was
     experiencing. Design: describe what visibly changed. Social:
     include engagement numbers if mentioned.
  4. Create a new document in Dev_Changelog using `create_document`.
     Title: "Weekly Brief: [start date] to [end date]". Sections:
     Highlights, Features Shipped, Bugs Fixed, Design Updates,
     Social and Marketing, plus a footer with item counts.
  5. If zero completed tasks are found, do not create a document.
mcp_servers:
  - name: quire
    type: url
    url: https://mcp.quire.app/mcp

Claude Managed Agents 主控台中開啟的代理定義

我們選擇 Haiku 4.5,是因為這項工作並非高度推理。代理做的是分組、篩選與格式化,這些 Haiku 處理起來都沒問題,每個 token 的成本約是 Sonnet 的十分之一,速率限制也明顯更高。對於無人值守、每週執行的工作來說,這份速率限制的餘裕比邊際的推理能力提升更重要。

2. 工具過濾,真正省錢的地方

預設情況下,當你把 Quire MCP 伺服器掛到代理上時,代理每次呼叫模型,所有 95 個工具定義都會被載入上下文中。那是非常多的 token,而當你的代理只需要讀取任務和建立文件時,大部分都毫無用處。

請毫不留情地過濾:

tools:
  - mcp_server_name: quire
    type: mcp_toolset
    default_config:
      enabled: false
      permission_policy:
        type: always_allow
    configs:
      - name: search_tasks
        enabled: true
      - name: create_document
        enabled: true
      - name: list_tags
        enabled: true
      - name: resolve_quire_url
        enabled: true

default_config.enabled: false 代表「預設全部關閉」,而 configs 區塊則只 opt-in 代理實際會用到的四個工具。這一個改動把我們每次執行的輸入 token 數從約 82,000 降到 12,000 以下,讓我們穩穩落在 Tier 1 速率限制內。(後面的踩雷紀錄會再講到。)

這同時也帶來安全上的好處。只啟用 search_taskscreate_documentlist_tagsresolve_quire_url 時,代理根本沒辦法刪除、封存或修改任何現有資料,即便提示注入試圖讓它這麼做也無效。Quire 的 bulk_delete_tasks 工具不在它的工具箱裡,所以模型沒得呼叫。

3. 環境設定

Managed Agents 會把每個 session 跑在 gVisor 沙箱裡,並使用你掌控的網路政策。預設是 "Limited",沒有任何對外網路連線,這會擋住代理去連 Quire MCP。最乾淨的解法是最小權限原則:類型維持 Limited,但明確允許你唯一需要的那個主機名稱。

環境網路設定畫面,類型為 Limited,並把 mcp.quire.app 加進允許主機清單

在 Claude 主控台中:Manage Environments → 你的環境 → Networking → 啟用 Allow MCP server network access → 在 Allowed hosts 加入 mcp.quire.app。套件管理員的網路存取維持停用,因為這個代理不需要安裝任何東西。

4. Credential vault

Quire 透過 OAuth 驗證。在 Managed Agents 裡,OAuth token 存放於沙箱外的 credential vault。當代理呼叫 Quire MCP 時,credential proxy 會在伺服器端注入 token。模型本身永遠看不到這個 token,這代表即便提示注入成功,也無法把它外洩出去。

Credential vault 已設定好,Quire MCP 的 OAuth 憑證為啟用狀態

建立一個 vault,按 Add credential,指向 https://mcp.quire.app/mcp,類型選 OAuth,並執行授權流程。當憑證顯示為 Active 時,vault 就準備好了。

5. 排程

Managed Agents 的 session 是一次性的,不會自動重複執行。要讓代理每週一執行,請把任何排程器接到 sessions.create API 端點,cron 運算式設為 0 9 * * 1。我們用的是簡單的 Cloudflare Workers Cron Trigger,每週呼叫一次 Anthropic API;但 GitHub Actions 的排程,或任何雲端函式平台,效果都一樣好。

哪些地方壞掉、又是怎麼發現的

在把每週運行清乾淨之前,有三件事出過問題。值得列出來,因為如果你也建類似的東西,至少會中其中一個。

MCP URL 寫錯了。 Quire 的產品部署在 quire.io,但 MCP 伺服器在 quire.app。我們把所有東西(代理、環境允許主機、credential vault)都指向 mcp.quire.io/mcp,結果遇到一個令人一頭霧水的 OAuth 失敗,撐過那關後又收到上游回傳的 HTTP 502。修法很無聊但值得標起來:每一處 MCP 的指向都必須用 mcp.quire.app,不是 quire.io。只要三個地方有任何一處主機名稱寫錯,整個執行就會失敗。

代理工具集肥大。 Anthropic 預設的 agent_toolset_20260401 會把每一個泛用工具(bash、檔案操作、網頁搜尋、程式執行)都塞進上下文。我們的代理一個都不需要。把這個預設工具集留著、又疊上 Quire MCP 伺服器,會讓每次模型呼叫的輸入 token 數衝破 80,000,立刻撞到 Tier 1 的速率限制。把預設工具集移除、再過濾 Quire 的工具(如上所示)之後,數字降到了約 12,000。教訓是:你代理上下文中的每一個工具都是一筆稅金,就算代理從來不呼叫它也一樣。

速率限制驚慌。 在我們搞清楚肥大問題之前,直覺反應是「我們得升級 API 階層」。升級階層要花錢。實際的問題是代理載入了 70,000 個它永遠不會用到的工具定義 token。在假設你需要更大的限制之前,永遠先檢查你的上下文視窗裡到底有什麼。

Quire MCP 除了每週更新日誌之外還能解鎖什麼

每週更新日誌是個有用的首發代理,但它主要是個概念驗證。這個模式(一個 Managed Agent + Quire MCP + 一個排程觸發器)可以延伸到許多其他用途。

我們正在原型化的幾個:

  • 每日衝刺啟動簡報:讀取一夜之間被移到「In Progress」的任務,並把摘要貼到 Slack
  • 事件回顧草稿員:盯著 Quire 專案中已完成的 incident 任務,並從子任務中拼出一份回顧草稿,包含時間軸、貢獻因素,以及後續行動
  • 客戶狀態摘要:每週五下午為每個客戶專案執行一次,把本週的交付物總結成可以直接轉寄給客戶的語言

每次的形狀都一樣:一個排程觸發器、一個聚焦的代理、一組精挑的 Quire MCP 工具、一份文件或訊息作為輸出。困難的部分(沙箱、憑證、代理迴圈)都在 Managed Agents 裡。領域相關的部分(要查哪些 Quire 資料、查到後要做什麼)則在系統提示中。

什麼情況下這不是對的做法

Managed Agent 對於一次性的問題是殺雞用牛刀。如果你想要一次性地總結「這一季出了什麼」,直接在 Claude 聊天視窗裡問、把 Quire 資料貼進去,會比打造一個部署過的代理還要快。代理這種形狀,只有在同一個工作要重複跑、又不需要監督時,才划算。

當工作真的高度仰賴推理,比如要用同樣的資料寫出一份深思熟慮的產品策略,這也是錯的形狀。Haiku 適合「彙整與排版」。要做「決定我們該怎麼辦」的時候,你需要 Sonnet 或 Opus,那個層級你大概也會想要有人類在迴圈裡。

如果你的專案資料很稀疏(例如一週只有少少幾個已完成任務、又沒有描述),代理就沒什麼可以總結的東西。輸出品質完全取決於你團隊對於寫像樣任務描述的紀律。我們是吃了苦頭學到這點的:一次早期測試產生的簡報技術上完全正確,卻徹底毫無資訊量,因為一半的任務名稱根本就只是票號。

加入超過 10 萬個使用 Quire 專案管理軟體的團隊 — 免費註冊

重點整理

每週更新日誌代理範圍小、效益大,因為它移除了一筆反覆出現的稅金(週一回顧會議),而且沒有人需要記得做任何事。讓它能運作的關鍵都很具體:用 Haiku 4.5 換取成本與速率限制的餘裕、用積極的工具過濾把上下文視窗保持精簡、用最小權限的環境政策只允許流量去 mcp.quire.app、以及用 credential vault 讓代理永遠不會碰到實際的 OAuth token。

更通用的教訓是:Quire MCP 加上 Claude Managed Agents 是一條把自主代理放到專案資料前面的快速途徑,而且完全不必自己搭基礎設施。困難的部分(沙箱、驗證、排程、稽核日誌)都已經被解掉了。你要做的只是提示、工具選擇,以及一開始就把專案資料寫得值得被總結的紀律。

常見問題

什麼是 Quire MCP?

Quire MCP 是一個 Model Context Protocol 伺服器,讓 AI 代理可以透過標準化的工具介面讀取與寫入你的 Quire 工作區。它部署在 https://mcp.quire.app/mcp,公開了約 95 個工具,涵蓋搜尋、任務與文件建立、批次操作等等。任何相容 MCP 的客戶端(Claude、Cursor、基於 Anthropic SDK 打造的自訂代理)都可以連上它。

什麼是 Claude Managed Agents?

Claude Managed Agents 是 Anthropic 提供的託管執行環境,用來在雲端運行長時間自主執行的代理。你定義一個代理(模型、系統提示、工具)、一個環境(具備網路政策的沙箱容器),並建立 session 來執行工作。Anthropic 負責處理沙箱、憑證代理與執行迴圈,因此你不必自行建構這些基礎設施。

為什麼這類自動化要選 Haiku 4.5 而不是 Sonnet 或 Opus?

把結構化的任務資料彙整成文件並不是高度推理的工作,而是分組、篩選與格式化。Haiku 4.5 在這種品質要求下表現足夠,每個 token 的成本大約只有 Sonnet 的十分之一,並且在每個 API 階層的速率限制都明顯更高。對於一個無人值守、每週執行一次的工作而言,成本與速率限制的餘裕比邊際的推理能力提升更重要。

代理產生每週簡報需要多久時間?

對於一個視窗期內約有二十個已完成任務的專案,端到端整體執行時間在三十秒以內。這包括搜尋 Quire、處理結果、撰寫文件內文,並把文件建立回該專案中。這段時間大多耗在模型呼叫上,而不是工具往返。

代理會編輯或刪除我專案中的現有任務嗎?

只有在你明確授予這些工具授權時才會。Quire MCP 伺服器公開了約 95 個工具,但 Claude Managed Agents 允許你針對每個代理只啟用其中的一部分。在這個更新日誌的使用情境中,我們只啟用了四個只讀和建立用的工具,因此即使遇到提示注入攻擊試圖讓代理修改或刪除任何現有資料,它也辦不到。

如果代理執行那一週沒有任何已完成的任務會怎樣?

代理的提示中包含了一個備援指令:如果搜尋回傳的已完成任務數為零,就不要建立文件,而是記錄一行表示這一週是空的。這可避免在團隊那週沒有任何產出時,仍發布一份空白或誤導的每週簡報。

我需要付費的 Quire 方案才能使用 Quire MCP 嗎?

Quire MCP 適用於任何具備 API 存取權限的方案。可以在 quire.io/pricing 查看目前的 API 配額。對於每週執行一次、每次只呼叫少數工具的代理而言,免費方案或入門方案的限制通常就已足夠。

我可以用同一個代理對應到多個 Quire 專案嗎?

可以。最乾淨的模式是每個工作流程定義一個代理、每個專案建立一個 session。專案的 URL 會在建立 session 時作為參數傳入。如果你想用一份每週簡報涵蓋多個專案,就重新設計提示,讓它依序查詢每個專案,並把結果整合到同一份文件中。

準備在 Quire MCP 上打造你自己的代理?

前往 quire.io/signup 啟動 30 天免費試用,並查看 Quire 開發者文件 認識完整的 MCP 工具目錄。免信用卡,全功能。

Vicky Pham
Marketer by day, Bibliophile by night.