Quire MCP + Claude Managed Agents:實戰建置範例

最後更新：2026 年 8 月 6 日

週一早上 9:04。團隊頻道裡有人問：「欸，簡單回顧一下上週交付了什麼？」三個人打開分頁，滑過看板檢視模式，努力回想四十個已關閉的任務中哪些真正重要，二十分鐘後帶著兩個要點和一聲苦笑回來。原本預計十分鐘的回顧會議開了四十分鐘。到了週二，大家已經忘了會議內容。

我們終結了這個循環。我們用 Quire MCP 與 Claude Managed Agents 打造了一個代理人，每週一早上讀取 Dev_Changelog 專案，找出過去七天完成的所有項目，依團隊分組，把開發人員的簡寫轉成客戶看得懂的內容，並將整份摘要寫進一份全新的 Quire 文件。總執行時間：不到三十秒。後續維護成本：零。

這篇文章是完整的建置過程，包括途中出錯的三件事與解決方式。如果你一直想要真正能做事的 AI 代理人,直接處理專案資料，而不只是陪你聊天，這就是一份可行的做法。

代理人實際會產出什麼？

每週一太平洋時間上午 9 點，Claude 工作階段會自動啟動、查詢 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 就是它實際產出的文件。

團隊在站立會議中花兩分鐘讀完。沒有人需要撰寫，也沒有人需要記得去做。

我們的 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 只是無人呼叫的工具目錄；沒有領域專用 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 工作階段變成更新日誌撰寫員：

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

我們選擇 Haiku 4.5,因為這項工作不需要大量推理。代理人只是分組、篩選與排版，Haiku 處理得很好，每個 token 的成本約為 Sonnet 的十分之一，速率限制也高出許多。對於無人看管的每週排程，速率限制的餘裕比多出的一點推理能力更重要。

2. 工具篩選，真正省錢的地方

預設情況下，當你把 Quire MCP 伺服器接到代理人上，代理人每次呼叫模型，九十五個工具定義都會被載入上下文。這會消耗大量 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 區塊則只啟用代理人實際用到的四個工具。光是這一項改動，就讓每次執行的輸入 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,但明確允許你需要的那一個主機名稱。

在 Claude 主控台中：Manage Environments → 你的環境 → Networking → 啟用 Allow MCP server network access → 將 mcp.quire.app 加入 Allowed hosts。由於這個代理人不需要安裝任何套件，請保持套件管理工具的網路存取為停用。

4. 憑證保管庫

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

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

5. 排程

Managed Agents 的工作階段是一次性的，不會自動重複。要讓代理人在每週一執行，請把任何排程器指向 sessions.create API 端點，並使用 cron 運算式 0 9 * * 1。我們用的是簡單的 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 排程，過程中不需要任何模型呼叫。

重點整理

每週更新日誌代理人範圍很小，回報卻很大，因為它不需要任何人記得去做，就消除了週一回顧會議這項反覆出現的成本。

讓它運作順利的關鍵很具體：用 Haiku 4.5 取得成本與速率限制的餘裕、積極篩選工具讓上下文視窗保持精簡、採用只允許連往 mcp.quire.app 的最小權限環境政策，以及讓代理人永遠碰不到實際 OAuth 權杖的憑證保管庫。

整體的心得是，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 工具目錄。無需信用卡，可使用完整功能。