developers · May 20, 2026

Quire MCP + Claude Managed Agents:実際に動くビルド手順

✦
AI翻訳
· 英語版を見る

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

最終更新日:2026年8月6日

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時04分。チームのチャンネルで誰かが「先週リリースしたもの、ざっくりまとめてもらえる?」と聞きます。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分で読み終えます。書く人はいません。書くのを覚えておく人もいません。

MCP ウェビナーでは、構築手順を踏まずに同じゴールにたどり着けます。該当するのは Monitor のパートで、下のプレーヤーはそこから再生が始まります。

このセッションの内容21:58 ワークフロー4:スケジュール実行のエージェントに週次レポートを書かせて監視する

Quire MCP と Claude Managed Agents で何ができますか?

Quire MCP は、https://mcp.quire.app/mcp でホストされている Model Context Protocol サーバーです。Quire の API を標準化されたツール群として公開し、MCP 対応のクライアントなら誰でも呼び出せます。

ツールは約95個あり、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 サーバーを提供している PM ツールは、まだ多くありません。Asana、Monday、ClickUp は REST API を公開していますが MCP はなく、自分でラップして認証も処理する必要があります。Notion には MCP がありますが、そのツールはドキュメントやページ向けで、プロジェクトの自動化に本当に必要なタスクと子タスクの構造には向いていません。Quire MCP は、エージェントが操作する作業単位(タスク、子タスク、状態、タグ、サブリスト)を軸に作られています。だからこそ、この構築は四半期ではなく半日で済みました。

エージェントはどうやって一歩ずつ構築するのですか?

セットアップ全体で約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個すべてのツール定義がコンテキストに読み込まれます。かなりのトークン量ですし、エージェントがタスクの読み取りとドキュメントの作成しかしないなら、そのほとんどは無駄です。

容赦なく絞り込みましょう。

トップクラスのプロジェクト管理プラットフォーム、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 ブロックがエージェントの実際に使う4つのツールだけを有効にします。この変更だけで、1回あたりの入力トークン数が約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 を有効にし、Allowed hosts に mcp.quire.app を追加します。このエージェントは何もインストールしないので、パッケージマネージャーのネットワークアクセスは無効のままにしておきます。

4. 認証情報ボールト

Quire は OAuth で認証します。Managed Agents では、OAuth トークンはサンドボックスの外にある認証情報ボールトに保管されます。エージェントが Quire MCP を呼び出すと、認証情報プロキシがサーバー側でトークンを注入します。モデル自身がトークンを目にすることはないので、プロンプトインジェクションが成功しても、トークンを外部に持ち出されることはありません。

Quire MCP の OAuth 認証情報が有効になっている認証情報ボールトの設定

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

5. スケジュール設定

Managed Agents のセッションは1回限りで、自動では繰り返されません。毎週月曜にエージェントを動かすには、任意のスケジューラーから sessions.create API エンドポイントを呼び出し、cron 式に 0 9 * * 1 を指定します。

私たちは、週に1回 Anthropic API を呼び出すシンプルな 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 サーバーに加えてデフォルトのツールセットを有効にしたままにしたところ、モデル呼び出し1回あたりの入力トークンが80,000を超え、すぐに Tier 1 のレート制限に達しました。デフォルトのツールセットを外し、(前述のとおり)Quire のツールを絞り込むと、約12,000まで下がりました。教訓は、エージェントのコンテキストに入っているツールはどれも、呼び出されなくても負担になるということです。

レート制限へのパニック。 肥大化の問題に気づく前は、「API のティアを上げなければ」と考えるのが自然な反応でした。ティアのアップグレードにはお金がかかります。本当の問題は、エージェントが使うことのない70,000トークン分のツール定義を読み込んでいたことでした。より大きな上限が必要だと決めつける前に、まずコンテキストウィンドウの中身を確認してください。

Quire MCP で、週次の変更履歴以外に何ができますか?

週次の変更履歴は便利な最初のエージェントですが、大部分は概念実証です。このパターン(Managed Agent 1つ + Quire MCP + スケジュール実行のトリガー)は、もっと多くの用途に広げられます。

いま試作中のものを挙げます。

  • 夜のうちに「進行中」へ移ったタスクを読み取り、概要を Slack に投稿する日次スプリント開始ブリーフ
  • Quire プロジェクトを監視して完了した incident タスクを検知し、子タスクから拾ったタイムライン、寄与要因、フォローアップ項目を含む振り返りドラフトのドキュメントを組み立てるインシデント振り返りのドラフト作成
  • クライアントごとのプロジェクトについて金曜の午後に実行し、その週の成果物を、そのままクライアントに転送できる文面でまとめるクライアント向け状況ダイジェスト

形は毎回同じです。スケジュール実行のトリガー、目的に絞ったエージェント、少数の Quire MCP ツール、そして出力となるドキュメントやメッセージ。難しい部分(サンドボックス化、認証情報、エージェントのループ)は Managed Agents が担います。ドメイン側の作業(どの Quire データを検索し、それをどうするか)は、システムプロンプトに書きます。

このやり方が向かないのはどんなときですか?

Managed Agent は、1回限りの質問には大げさです。「今四半期に何をリリースしたか」を1回だけ知りたいなら、チャット画面で Claude に直接尋ね、Quire のデータを貼り付けるほうが、デプロイ型のエージェントを作るより早く済みます。エージェントという形が元を取れるのは、同じ仕事が監督なしで繰り返し動くときだけです。

同じデータから練られたプロダクト戦略を書くような、本当に推論が重い作業にも向きません。Haiku は「要約して整形する」なら十分です。「これからどうすべきかを決める」なら Sonnet や Opus が必要で、その段階では人間も関与させたくなるはずです。

また、プロジェクトのデータが乏しい場合(たとえば、説明のない完了タスクが週に数件だけ)、エージェントには要約できる有益な材料がありません。出力の質は、チームが実のあるタスクの説明を書く習慣をどれだけ持っているかで決まります。初期のテスト実行では、タスク名の半分がチケット ID だけだったため、技術的には正しいのに何も伝わらないブリーフができあがり、身をもってこれを学びました。

そもそも AI を介したくないなら、Quire CLI がおすすめです。スクリプトや cron で使える構造化コマンドで同じデータを取得でき、経路にモデル呼び出しは入りません。

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 の料金ページに記載されています。週1回、1回の実行でツールを数回呼び出す程度のエージェントなら、フリープランやスターター向けの上限で通常は足ります。

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

はい。いちばんすっきりした形は、ワークフローごとにエージェント定義を1つ、プロジェクトごとにセッションを1つ用意する方法です。プロジェクトの URL を、セッション作成時に渡すパラメーターにします。複数のプロジェクトをまとめた週次ブリーフを1本にしたい場合は、各プロジェクトを順番に検索して結果を1つのドキュメントに統合するよう、プロンプトを組み直してください。

Quire MCP で自分だけのエージェントを作ってみませんか?

quire.io/signup で30日間の無料トライアルを始めると、Quire 開発者ドキュメントで MCP ツールカタログの全容も確認できます。クレジットカードは不要で、すべての機能をご利用いただけます。

Vicky Pham
Marketer by day, Bibliophile by night.