developers · May 20, 2026

Quire MCPとClaude Managed Agentsで週次変更履歴エージェントを構築した方法

AI翻訳
· 英語版を見る

Quireプロジェクト内で週次変更履歴ブリーフを生成するClaudeエージェント

最終更新日:2026年5月25日

TL;DR: 月曜の振り返り会議を、Claude Managed Agentに置き換えました。このエージェントはQuire MCP経由でDev_Changelog Quireプロジェクトを読み取り、過去7日間に完了した作業をタグでグループ化し、顧客向けに読める週次ブリーフを新しいQuireドキュメントとして書き出します。実行時刻はHaiku 4.5で30秒未満。最も意外な効果があったのは積極的なツールフィルタリングで、1実行あたりの入力トークンを約82,000から約12,000に削減し、APIアップグレードなしでTier 1のレート制限内にジョブを収めることができました。

月曜日の午前9時4分。チームチャンネルで誰かが「先週リリースされたものをサクッと振り返りたいんだけど?」と尋ねます。3人がタブを開き、カンバンボードをスクロールし、閉じられた40件のタスクのうち実際に意味のあったものを思い出そうとし、20分後に2つの箇条書きと肩をすくめて戻ってきます。10分で終わるはずの振り返り会議は40分に延びます。火曜日には全員がその内容を忘れています。

私たちはそのループを置き換えました。Quire MCPとClaude Managed Agentsの上にエージェントを構築し、毎週月曜の朝にDev_Changelogプロジェクトを読み取り、過去7日間に完了したすべてを見つけ、チームごとにグループ化し、開発者向けの略語を顧客が読める形に翻訳し、ブリーフ全体を新しいQuireドキュメントに書き出すようにしました。総実行時刻:30秒未満。継続的なメンテナンス:ゼロ。

この記事は、その構築の全容です。途中で壊れた3つのこと、そしてそれをどう直したかも含めて紹介します。AIエージェントに、ただチャットするだけでなく、あなたのプロジェクトデータに対して実際の作業をさせたいと思ったことがあるなら、これは動作する実例レシピです。

エージェントが実際に生成するもの

毎週月曜午前9時(太平洋時刻)、Claudeセッションが起動し、Quireにクエリし、Dev_ChangelogプロジェクトにWeekly Brief: May 15 to May 21, 2026というタイトルの新しいドキュメントを作成します。ドキュメントには次の5つのセクションが、この順序で並びます:

  • Highlights:ユーザーインパクトの大きい上位3件
  • Features Shipped:各新機能を、ユーザー向けのメリットに翻訳
  • Bugs Fixed:修正前にユーザーが経験していたことを説明
  • Design Updates:見た目の変化に焦点を当てた説明
  • Social and Marketing:タスクの説明に記載があった場合、エンゲージメント数値を含む

空のセクションは静かにスキップされます。末尾には1行のカウントサマリーがあります。全体は約400語で、マーケティング向けの変更履歴というよりは社内ダイジェストのように読めます。それがシステムプロンプトに指示している内容そのものだからです。

ライブの例をご覧ください: エージェントはフィルタリングされたDev_Changelogソースプロジェクトから読み取り、Weekly Brief: May 15 to May 21, 2026が実際に生成されたドキュメントです。

Dev_Changelogフィルタ済みソースプロジェクトと生成されたWeekly Briefドキュメントの並列表示

チームはスタンドアップ中に2分でそれを読みます。誰も書かなくていい。誰も思い出さなくていい。

Quire MCPとClaude Managed Agentsがもたらすもの

Quire MCPModel Context Protocolサーバーで、https://mcp.quire.app/mcpでホストされています。QuireのAPIを、MCP互換のクライアントが呼び出せる標準化ツールのセットとして公開します。search_tasksからcreate_documentbulk_create_tasksまで、約95のツールがあります。エージェントはQuireのREST APIの形を知る必要はありません。ツールカタログを見て、必要なものを呼び出すだけです。

Claude Managed AgentsはAnthropicが提供する自律エージェント向けのホスト型ランタイムです。エージェント(モデル+システムプロンプト+ツール設定)、環境(ネットワークポリシーを備えたサンドボックスコンテナ)を定義し、実際に作業を行うセッションを作成します。サンドボックス化、認証情報プロキシ、実行ループ、監査ログはAnthropicが処理します。これらはあなたが書く必要のあるコードではありません。

この組み合わせが重要なのは、それぞれ単独では単なる配管に過ぎないからです。エージェントなしのQuire MCPは、誰も呼び出さないツールカタログです。ドメイン固有のMCPなしのClaude Managed Agentsは、することのないサンドボックスです。両者をつなぐと、適切な認証とサンドボックスを備えたまま、本番データに対して実際にアクションを取るエージェントが手に入ります。

Claude Managed Agentsを使っていない? Quire MCPはオープンソースのMCPクライアントであるOpen Clawでも動作します。同じツールカタログ、同じOAuthフロー、同じワークフローをその上に構築できます。スタックに合うランタイムを選んでください。

なぜこれが重要か: ほとんどのPMツールはまだ公開MCPサーバーを提供していません。Asana、Monday、ClickUpはREST APIを公開していますが、MCPは提供していないため、自分でラップして認証を扱う必要があります。NotionはMCPを持っていますが、そのツール面はドキュメントとページ向けに作られており、プロジェクト自動化が実際に必要とするタスクと子タスクの構造ではありません。Quire MCPはエージェントが操作する作業単位(タスク、子タスク、状態、タグ、サブリスト)を中心に作られているため、この構築は四半期ではなく1つの午後で終わったのです。

構築手順

セットアップ全体は約1時間で済みました。そのほとんどは、後述する設定の落とし穴と戦っていた時刻です。これが実際のレシピです。

1. エージェント定義

エージェントは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はそれをトークンあたり約Sonnetの10分の1のコストと大幅に高いレート制限でこなせます。無人で動く週次実行には、わずかな推論力の差よりも、そのレート制限の余裕の方が重要です。

2. ツールフィルタリング:実は本当の旨みはここ

デフォルトでは、エージェントにQuire MCPサーバーを接続すると、すべての95個のツール定義がモデル呼び出しのたびにコンテキストに読み込まれます。それは大量のトークンであり、エージェントがタスクを読み取ってドキュメントを作成するだけなら、ほとんどが無意味です。

容赦なくフィルタリングしましょう:

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ブロックがエージェントが実際に使う4つのツールにオプトインします。この1つの変更だけで、1実行あたりの入力トークン数を約82,000から12,000未満まで落とし、Tier 1のレート制限内に余裕で収まるようになりました。(詳しくは下の「やらかし話」で。)

セキュリティ上のメリットもあります。search_taskscreate_documentlist_tagsresolve_quire_urlだけを有効にしておけば、エージェントは文字どおり既存データを削除、アーカイブ、または変更できません。プロンプトインジェクションが試みられても同じです。Quireのbulk_delete_tasksツールはツールキットに含まれていないので、モデルはそれを呼び出せません。

3. 環境

Managed Agentsは各セッションを、あなたが制御できるネットワークポリシー付きのgVisorサンドボックス内で実行します。デフォルトは外部ネットワークアクセスなしの「Limited」で、これだとエージェントはQuire MCPに到達できません。最もすっきりした修正は最小権限です:種類は「Limited」のままにしつつ、必要な1つのホスト名だけを明示的に許可します。

「Limited」種別で、許可ホスト一覧に`mcp.quire.app`が追加された環境ネットワーク設定

Claudeコンソールで:Manage Environments → 該当の環境 → NetworkingAllow MCP server network accessを有効化 → Allowed hostsmcp.quire.appを追加。このエージェントは何もインストールしないので、パッケージマネージャーのネットワークアクセスは無効のままにしておきます。

4. 認証情報ボールト

QuireはOAuthで認証します。Managed Agentsでは、OAuthトークンはサンドボックスの外側にある認証情報ボールトに置かれます。エージェントがQuire MCPを呼び出すと、認証情報プロキシがサーバー側でトークンを注入します。モデル自体はトークンを一切見ないため、プロンプトインジェクションが成功してもそれを漏出させることはできません。

Quire MCPのOAuth認証情報がActive状態で設定された認証情報ボールト

ボールトを作成し、Add credentialをクリックし、https://mcp.quire.app/mcpを指定し、種類にOAuthを選び、認可フローを実行します。認証情報がActiveとして表示されれば、ボールトの準備は完了です。

5. スケジューリング

Managed Agentsのセッションはワンショットです。自動的に繰り返されません。エージェントを毎週月曜に実行するには、任意のスケジューラーをsessions.create APIエンドポイントに向け、cron式0 9 * * 1を使います。私たちはAnthropic APIを週に1度呼び出すシンプルなCloudflare Workers Cron Triggerを使っていますが、GitHub Actionsのスケジュールでも同様にうまく動きますし、どのクラウド関数プラットフォームでも構いません。

何が壊れ、どうやって気づいたか

クリーンな週次実行に到達するまでに、3つのことがうまくいきませんでした。挙げておく価値があります。あなたが似たようなものを作るなら、少なくとも1つは確実にぶつかるからです。

MCPのURLが間違っていた。 Quireの製品はquire.ioでホストされていますが、MCPサーバーはquire.appにあります。私たちは(エージェント、環境の許可ホスト、認証情報ボールトの)すべてをmcp.quire.io/mcpに向け、わかりにくいOAuth失敗を引き起こし、そこを乗り越えた後は上流からのHTTP 502が出ました。修正自体は退屈ですが、強調する価値があります:MCPへのすべての参照はquire.ioではなくmcp.quire.appを使う必要があります。3か所のいずれか1つでもホストが間違っていれば、実行は失敗します。

エージェントのツールセット肥大化。 Anthropicのデフォルトagent_toolset_20260401は、すべての汎用ツール(bash、ファイル操作、Web検索、コード実行)をコンテキストに搭載します。私たちのエージェントはそのどれも必要としません。Quire MCPサーバーの上にデフォルトのツールセットを有効化したまま残しておくと、モデル呼び出しあたりの入力トークン数が80,000を超え、Tier 1のレート制限に即座にぶつかりました。デフォルトのツールセットを外し、Quireのツールをフィルタリング(前述)したことで、約12,000まで下げることができました。教訓:エージェントのコンテキストに入る各ツールは、たとえエージェントが一度も呼び出さなくても課税対象です。

レート制限パニック。 肥大化の問題に気づくまで、自然な反応は「APIティアをアップグレードする必要がある」でした。ティアのアップグレードはお金がかかります。実際の問題は、エージェントが一度も使わない70,000トークンのツール定義を読み込んでいたことでした。上限を上げる必要があると思い込む前に、必ずコンテキストウィンドウに何が入っているか確認してください。

週次変更履歴を超えてQuire MCPが解き放つもの

週次変更履歴は最初のエージェントとして有用ですが、ほぼ概念実証です。このパターン(1つのManaged Agent+Quire MCP+スケジュールされたトリガー)は、もっと多くのことに拡張できます。

私たちが試作中のいくつか:

  • 一晩のうちに「進行中」に動かされたタスクを読み取り、Slackにサマリーを投稿する毎日のスプリントキックオフブリーフ
  • Quireプロジェクトを監視し、完了したincidentタスクから、タイムライン、要因、子タスクから抽出されたフォローアップアクションを含むドラフトの振り返りドキュメントを組み立てるインシデント振り返りドラフター
  • 毎週金曜の午後にクライアントプロジェクトごとに実行し、その週の成果物を、クライアントに直接転送できる言葉で要約するクライアント状態ダイジェスト

形はいつも同じです。スケジュールされたトリガー、焦点を絞ったエージェント、Quire MCPツールの小さなセット、出力としてのドキュメントまたはメッセージ。難しい作業(サンドボックス、認証情報、エージェントループ)はManaged Agentsの中にあります。ドメイン作業(どのQuireデータをクエリするか、それで何をするか)はシステムプロンプトの中にあります。

このアプローチが適していないとき

Managed Agentsは1回限りの質問にはやり過ぎです。「この四半期に何がリリースされたか」を1回まとめたいだけなら、チャットウィンドウでClaudeに直接尋ねてQuireのデータを貼り付ける方が、デプロイされたエージェントを構築するより速いです。エージェントの形は、同じ仕事が監督なしに繰り返し実行されるときに初めて元が取れます。

また、作業が本当に推論を多用する場合、たとえば同じデータから熟慮された製品戦略を書くような場合にも、適切な形ではありません。Haikuは「要約と整形」には十分です。「これについて何をすべきか決める」には、SonnetまたはOpusが必要ですし、その時点では人間もループに入れたくなるはずです。

そして、プロジェクトデータが希薄な場合(たとえば説明のない完了タスクが週に数件しかない場合)、エージェントは要約する価値のあるものを何も持ちません。出力はチームが本物のタスクの説明を書く規律と同じだけしか良くなりません。私たちは初期のテスト実行で、タスクの名前の半分が単なるチケットIDだったために、技術的には正しいが完全に情報量のないブリーフが生成されたとき、これを苦い経験として学びました。

10万以上のチームが利用する Quire プロジェクト管理ソフトウェアに参加 — 無料登録

まとめ

週次変更履歴エージェントはスコープこそ小さいですが、見返りは大きいものです。なぜなら、誰かが「やるのを思い出す」必要なく、繰り返し発生する税金(月曜の振り返り会議)を取り除いてくれるからです。これを機能させた要素は具体的でした:コストとレート制限の余裕のための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に置かれ、検索、タスクとドキュメントの作成、一括操作などをカバーする約95のツールを公開します。MCP互換のクライアント(Claude、Cursor、Anthropic SDKで構築されたカスタムエージェント)であれば、いずれも接続できます。

Claude Managed Agentsとは何ですか?

Claude Managed AgentsはAnthropicが提供するホスト型ランタイムで、長時間稼働する自律エージェントをクラウド上で実行できます。エージェント(モデル、システムプロンプト、ツール)と環境(ネットワークポリシーを備えたサンドボックスコンテナ)を定義し、作業を実行するセッションを作成します。サンドボックス化、認証情報の仲介、実行ループはAnthropicが処理するため、そうしたインフラを自前で構築する必要はありません。

この種の自動化にSonnetやOpusではなくHaiku 4.5を使う理由は何ですか?

構造化されたタスクデータをドキュメントに要約する作業は、推論を多用するタスクではありません。グループ化、フィルタリング、整形が中心です。Haiku 4.5はその品質水準を十分に満たし、トークンあたりのコストはSonnetの約10分の1で、すべてのAPIティアで大幅に高いレート制限を備えています。無人で動く週次ジョブにとっては、わずかな推論力の差よりも、コストとレート制限の余裕の方が重要です。

エージェントが週次ブリーフを生成するのにどれくらい時間がかかりますか?

対象期間に完了タスクが約20件あるプロジェクトの場合、エンドツーエンドの実行は30秒未満で終わります。これにはQuireの検索、結果の処理、ドキュメント本文の作成、プロジェクトへのドキュメント作成までが含まれます。その大半はツール呼び出しのラウンドトリップではなく、モデル呼び出しに費やされる時刻です。

エージェントは私のプロジェクトの既存タスクを編集したり削除したりできますか?

明示的にそのツール権限を付与した場合に限ります。Quire MCPサーバーは約95のツールを公開していますが、Claude Managed Agentsではエージェントごとにサブセットを有効化できます。変更履歴のユースケースでは、読み取りと作成の4つのツールのみを有効にしているため、プロンプトインジェクションが試みられても、エージェントは既存データを変更も削除もできません。

エージェントが実行される週に完了したタスクがない場合はどうなりますか?

エージェントのプロンプトにはフォールバック指示が含まれています:検索で完了タスクが0件返ってきた場合、ドキュメントは作成せず、その週は空だったという1行だけをログに記録します。これにより、そのウィンドウにチームが何もリリースしなかった場合に、空白または誤解を招く週次ブリーフが公開されるのを防ぎます。

Quire MCPを使うにはQuireの有料プランが必要ですか?

Quire MCPはAPIアクセスを備えたあらゆるプランで動作します。現在のAPIクォータはquire.io/pricingでご確認ください。週に1回、1実行あたり数回のツール呼び出しを行うエージェントであれば、Free層またはスタータークラスの上限で通常は十分です。

同じエージェントを複数のQuireプロジェクトで実行できますか?

はい。最もすっきりしたパターンは、ワークフローごとに1つのエージェント定義、プロジェクトごとに1つのセッションを用意することです。プロジェクトURLはセッション作成時刻のパラメーターになります。複数のプロジェクトをまとめた1つの週次ブリーフが欲しい場合は、プロンプトを各プロジェクトを順次クエリして結果を1つのドキュメントにまとめるよう再構成します。

Quire MCPで独自のエージェントを構築する準備はできましたか?

quire.io/signupで30日間の無料トライアルを始めましょう。そしてQuire開発者ドキュメントでMCPツールカタログの全容をご覧ください。クレジットカード不要、フルアクセス。

Vicky Pham
Marketer by day, Bibliophile by night.