developers · May 20, 2026

Quire MCP + Claude Managed Agents:實戰搭建全紀錄

✦
AI 翻譯
· 查看英文版

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

最後更新:2026 年 8 月 6 日

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 工作階段會啟動、查詢 Quire,並在我們的 Dev_Changelog 專案中建立一份名為 Weekly Brief: May 15 to May 21, 2026 的新文件。文件依次包含五個區段:

  • 重點摘要:按用戶影響排列的頭三項
  • 新功能:把每項新能力轉化為用戶看得到的好處
  • 已修正錯誤:描述用戶在修正前遇到的問題
  • 設計更新:集中說明外觀上的變化
  • 社交媒體與市場推廣:如任務描述有提及,會附上互動數字

沒有內容的區段會直接略過。文件底部有一行數量總結。整份簡報約 400 字,讀起來像內部摘要多於市場推廣式的更新日誌,因為系統提示要求的正正就是這樣。

看看實際例子:代理讀取的是經篩選的 Dev_Changelog 來源專案,而 Weekly Brief: May 15 to May 21, 2026 就是它實際產出的文件。

經篩選的 Dev_Changelog 來源專案與生成的每週簡報文件並排對照

團隊在站會時花兩分鐘就看完。沒有人要寫,也沒有人要記得去寫。

我們的 MCP 網上研討會在「Monitor」一段,不用任何搭建步驟就達到同樣效果。下面的播放器就從那裏開始。

本節內容21:58 工作流程 4:用排程代理撰寫每週報告來監察進度

Quire MCP 和 Claude Managed Agents 能為你帶來甚麼?

Quire MCP 是一個託管於 https://mcp.quire.app/mcp 的 Model Context Protocol 伺服器。

它把 Quire 的 API 包裝成一組標準化工具,任何兼容 MCP 的客戶端都能呼叫。工具約有九十五個,由 search_tasks、create_document 到 bulk_create_tasks 一應俱全。代理不需要知道 Quire REST API 的結構,只要看工具目錄,按需呼叫就可以。

Claude Managed Agents 是 Anthropic 為自主代理而設的託管執行環境。你定義代理(模型 + 系統提示 + 工具設定)和環境(設有網絡政策的沙盒容器),再建立實際做事的工作階段。沙盒隔離、憑證代理、執行循環和審計日誌都由 Anthropic 負責,這些程式碼你一行都不用寫。

兩者結合才有意義,因為單獨一件只是管道。Quire MCP 沒有代理,就是一個無人呼叫的工具目錄;Claude Managed Agents 沒有特定領域的 MCP,就是一個無事可做的沙盒。把它們接在一起,你就得到一個能在真實生產資料上採取行動的代理,而且內建完善的驗證和沙盒隔離。

沒有用 Claude Managed Agents?Quire MCP 同樣支援開源 MCP 客戶端 Open Claw。同一套工具目錄、同一個 OAuth 流程,可以搭建同樣的工作流程。選一個最適合你技術棧的執行環境就可以。

為何這很重要:大部分專案管理工具仍未推出公開的 MCP 伺服器。Asana、Monday 和 ClickUp 只提供 REST API,沒有 MCP,你得自行包裝並處理驗證。Notion 有 MCP,但它的工具是為文件和頁面而設,並非專案自動化真正需要的任務與子任務結構。Quire MCP 圍繞代理操作的工作單位(任務、子任務、狀態、標籤、子清單)而建,所以這次搭建只花了一個下午,而不是一整季。

如何一步步搭建這個代理?

整個設定花了約一小時,大部分時間都在對付一個設定陷阱,稍後會講到。以下是實際做法。

1. 代理定義

代理只是一個 YAML 檔案。系統提示是最關鍵的部分,因為它把一個通用的 Claude 工作階段變成更新日誌撰寫員:

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 伺服器接到代理上,代理每次呼叫模型時,全部九十五個工具定義都會載入上下文。那是大量 token,而當你的代理只需讀取任務和建立文件時,大部分都毫無用處。

篩選要毫不手軟:

備受好評的專案管理平台,獲 2,400 多位 Quire 用戶評為 4.7 星

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 區塊則只啟用代理實際用到的四個工具。單是這一個改動,就把每次執行的輸入 token 由約 82,000 降至 12,000 以下,讓我們輕鬆回到 Tier 1 速率限制之內。(下面的實戰經驗會再詳談。)

這還有保安上的好處。只啟用 search_tasks、create_document、list_tags 和 resolve_quire_url,代理根本無法刪除、封存或修改任何現有資料,即使有人嘗試用提示注入去操控也一樣。Quire 的 bulk_delete_tasks 工具不在它的工具箱內,模型自然無從呼叫。

3. 環境

Managed Agents 會在 gVisor 沙盒內執行每個工作階段,網絡政策由你控制。預設是「Limited」,沒有外部網絡存取,會令代理連不上 Quire MCP。最乾淨的做法是最小權限:類型保持 Limited,只明確允許你需要的那一個主機名稱。

環境網絡設定:類型為 Limited,並已把 mcp.quire.app 加入允許主機清單

在 Claude 控制台:Manage Environments → 你的環境 → Networking → 啟用 Allow MCP server network access → 把 mcp.quire.app 加入 Allowed hosts。套件管理工具的網絡存取保持停用,因為這個代理不會安裝任何東西。

4. 憑證保管庫

Quire 透過 OAuth 驗證。在 Managed Agents 中,OAuth token 存放在沙盒以外的憑證保管庫。當代理呼叫 Quire MCP 時,憑證代理會在伺服器端注入 token。模型本身永遠看不到 token,所以即使提示注入成功,也無法把它外洩。

已設定並啟用 Quire MCP OAuth 憑證的憑證保管庫

建立保管庫,按 Add credential,指向 https://mcp.quire.app/mcp,類型選擇 OAuth,然後完成授權流程。憑證顯示為 Active 後,保管庫就準備就緒。

5. 排程

Managed Agents 的工作階段是一次性的,不會自動重複。要讓代理每逢星期一執行,就用任何排程工具以 0 9 * * 1 這個 cron 表達式呼叫 sessions.create API 端點。我們用的是一個簡單的 Cloudflare Workers Cron Trigger,每週呼叫一次 Anthropic API;不過 GitHub Actions 的排程同樣好用,任何雲端函數平台也可以。

哪裏出了錯?我們怎樣發現?

在做到穩定的每週執行之前,有三件事出了岔子。值得逐一點出,因為如果你搭建類似的東西,至少會碰上其中一件。

MCP URL 錯了。 Quire 的產品託管在 quire.io,但 MCP 伺服器在 quire.app。我們把所有地方(代理、環境允許主機、憑證保管庫)都指向 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,而且到了那個階段,你大概也想有人參與其中。

另外,如果你的專案資料很零散(例如每週只有寥寥幾項已完成任務,而且沒有描述),代理就沒有甚麼有用的內容可以摘要。輸出的質素取決於團隊撰寫任務描述的紀律。我們是吃過虧才明白的:早期一次測試產出了一份技術上正確、卻毫無資訊量的簡報,因為一半任務名稱只是工單編號。

完全不需要 AI 參與?Quire CLI 透過結構化指令提供同樣的資料,你可以寫成腳本並用 cron 排程,流程中不涉及任何模型呼叫。

加入 100,000 多個使用 Quire 專案管理軟件的團隊,免費註冊

重點總結

每週更新日誌代理範圍雖小,回報卻大,因為它免除了一筆經常性的開支(星期一回顧會議),而且不需要任何人記得去做任何事。

成功的關鍵很具體:選用 Haiku 4.5 以換取成本和速率限制的餘裕;積極篩選工具,讓上下文視窗保持精簡;採用最小權限的環境政策,只允許連往 mcp.quire.app 的流量;並用憑證保管庫,令代理永遠接觸不到真正的 OAuth token。

整體的啟示是:Quire MCP 加上 Claude Managed Agents,是一個毋須搭建任何基礎設施、就能快速讓自主代理處理專案資料的方法。困難的部分(沙盒隔離、驗證、排程、審計日誌)早已解決。你要帶來的,是提示、工具的選擇,以及撰寫值得摘要的專案資料的紀律。

常見問題

甚麼是 Quire MCP?

Quire MCP 是一個 Model Context Protocol 伺服器,讓 AI 代理透過標準化的工具介面讀寫你的 Quire 工作空間。它位於 https://mcp.quire.app/mcp,提供約九十五個工具,涵蓋搜尋、建立任務和文件、批量操作等。任何兼容 MCP 的客戶端(Claude、Cursor、以 Anthropic SDK 自建的代理)都能連接。

甚麼是 Claude Managed Agents?

Claude Managed Agents 是 Anthropic 的託管執行環境,用來在雲端運行長期自主代理。你定義代理(模型、系統提示、工具)和環境(設有網絡政策的沙盒容器),再建立工作階段去執行任務。沙盒隔離、憑證代管和執行循環都由 Anthropic 處理,你不用自行搭建這些基礎設施。

這類自動化為何選用 Haiku 4.5,而不是 Sonnet 或 Opus?

把結構化的任務資料整理成文件,並不需要複雜推理,做的只是歸類、篩選和排版。Haiku 4.5 完全應付得來,每個 token 的成本約為 Sonnet 的十分之一,而且在每個 API 級別的速率限制都高得多。對於無人看管、每週執行一次的工作,成本和速率限制的餘裕,比多出來的少許推理能力重要得多。

代理生成一份每週簡報需要多久?

以一個在該時段內有約二十項已完成任務的專案為例,由頭到尾不用三十秒。這包括搜尋 Quire、處理結果、撰寫文件內容,以及把文件建立回專案之中。大部分時間花在模型呼叫上,而不是工具的往返通訊。

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

只有在你明確授予相關工具授權時才可以。Quire MCP 伺服器提供約九十五個工具,但 Claude Managed Agents 讓你為每個代理只啟用其中一部分。在更新日誌這個用例中,我們只啟用了四個讀取和建立工具,所以即使有人嘗試用提示注入去操控,代理也無法修改或刪除任何現有資料。

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

代理的提示內設有後備指示:如果搜尋結果顯示零項已完成任務,就不建立文件,改為記錄一行訊息,說明該週沒有內容。這樣可以避免團隊在該時段沒有交付任何成果時,仍然發布一份空白或誤導的每週簡報。

使用 Quire MCP 需要付費 Quire 方案嗎?

Quire MCP 適用於任何具備 API 存取權限的方案。目前的 API 配額列於 Quire 價格頁面。對於每週執行一次、每次只呼叫幾個工具的代理,免費或入門級的限額一般已經足夠。

我可以用同一個代理處理多個 Quire 專案嗎?

可以。最簡潔的做法是每個工作流程一個代理定義,每個專案一個工作階段。專案 URL 會成為建立工作階段時的參數。如果你想要一份涵蓋多個專案的每週簡報,可以調整提示,讓代理逐一查詢每個專案,再把結果合併成一份文件。

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

立即到 quire.io/signup 開始 30 天免費試用,並瀏覽 Quire 開發者文件,查看完整的 MCP 工具目錄。毋須信用卡,功能全開。

Vicky Pham
Marketer by day, Bibliophile by night.