developers · May 20, 2026
Quire MCP와 Claude Managed Agents로 주간 변경 로그 에이전트를 구축한 방법
마지막 업데이트: 2026년 5월 25일
요약: 저희는 월요일 회고 미팅을 Claude Managed Agent로 대체했습니다. 이 에이전트는 Quire MCP를 통해 Dev_Changelog Quire 프로젝트를 읽고, 최근 7일간 완료된 작업을 태그별로 그룹화하여, 고객이 읽을 수 있는 주간 브리프를 새 Quire 문서로 작성합니다. Haiku 4.5에서 실행 시간은 30초 미만입니다. 가장 의외의 성과는 공격적인 도구 필터링이었고, 이를 통해 실행당 입력 토큰을 약 82,000개에서 약 12,000개로 줄여 API 업그레이드 없이도 Tier 1 속도 제한 안에 작업을 유지할 수 있었습니다.
월요일 오전 9시 4분. 팀 채널에서 누군가 묻습니다. "지난주에 뭐가 출시됐는지 간단히 정리해줄 수 있어요?" 세 사람이 탭을 열고 칸반 보드 뷰를 스크롤하며, 마감된 40개의 업무 중 실제로 의미 있는 것이 무엇이었는지 떠올리려 애쓰다가, 20분 후에 두 줄짜리 글머리표와 한숨을 들고 돌아옵니다. 10분이면 끝낼 회고 미팅이 40분으로 늘어집니다. 화요일이 되면 모두가 그 내용을 잊어버립니다.
저희는 이 반복을 없앴습니다. Quire MCP와 Claude Managed Agents로 에이전트를 구축했고, 이 에이전트는 매주 월요일 아침 저희 Dev_Changelog 프로젝트를 읽어 최근 7일간 완료된 모든 항목을 찾고, 팀별로 그룹화한 뒤, 개발 약어를 고객이 읽을 수 있는 표현으로 번역하여, 전체 브리프를 새 Quire 문서로 작성합니다. 총 실행 시간은 30초 미만. 지속적인 유지 보수는 0.
이 글은 도중에 부서졌던 세 가지와 그 해결 방법까지 포함한 전체 구축 과정입니다. 단순한 잡담이 아니라 프로젝트 데이터에 실제 작업을 수행하는 AI 에이전트를 원해본 적이 있다면, 여기 동작하는 레시피가 있습니다.
이 에이전트가 실제로 만들어내는 결과물은 무엇인가요?
매주 월요일 오전 9시(PT), 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이 실제로 생성된 문서입니다.
팀은 스탠드업 도중 2분이면 읽어냅니다. 아무도 쓰지 않아도 되고, 잊지 않도록 기억할 필요도 없습니다.
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에 이르기까지 약 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. 에이전트 정의
에이전트는 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는 이를 충분히 처리하며 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 블록은 에이전트가 실제로 사용하는 네 개의 도구만 옵트인합니다. 이 한 가지 변경으로 실행당 입력 토큰 수가 약 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 활성화 → Allowed hosts에 mcp.quire.app 추가. 이 에이전트는 아무것도 설치하지 않으므로 패키지 매니저 네트워크 액세스는 비활성화로 둡니다.
4. 자격 증명 보관소
Quire는 OAuth로 인증합니다. Managed Agents에서 OAuth 토큰은 샌드박스 외부에 위치한 자격 증명 보관소에 저장됩니다. 에이전트가 Quire MCP를 호출하면, 자격 증명 프록시가 서버 측에서 토큰을 주입합니다. 모델 자체는 토큰을 절대 보지 못하므로, 프롬프트 인젝션이 성공하더라도 이를 유출할 수 없습니다.
보관소를 생성하고 Add credential을 클릭한 뒤, https://mcp.quire.app/mcp을 가리키도록 설정하고, 유형으로 OAuth를 선택한 다음 인증 흐름을 실행합니다. 자격 증명이 Active로 표시되면 보관소 준비가 완료됩니다.
5. 일정 잡기
Managed Agents 세션은 일회성입니다. 자동으로 반복되지 않습니다. 매주 월요일에 에이전트를 실행하려면, 임의의 스케줄러를 sessions.create API 엔드포인트에 0 9 * * 1 크론 표현식으로 연결합니다. 저희는 주 1회 Anthropic API를 호출하는 간단한 Cloudflare Workers Cron Trigger를 사용하지만, GitHub Actions의 schedule이나 어떤 클라우드 함수 플랫폼도 똑같이 잘 동작합니다.
무엇이 부서졌고, 어떻게 알아챘는가
깔끔한 주간 실행에 이르기까지 세 가지가 어긋났습니다. 비슷한 것을 구축하면 적어도 하나는 마주칠 가능성이 높으니, 짚어둘 가치가 있습니다.
잘못된 MCP URL. Quire 제품은 quire.io에 호스팅되지만, MCP 서버는 quire.app에 있습니다. 저희는 모든 것(에이전트, 환경 허용 호스트, 자격 증명 보관소)을 mcp.quire.io/mcp로 가리켰다가 모호한 OAuth 실패를 만났고, 그 단계를 넘기자 업스트림에서 HTTP 502가 돌아왔습니다. 해결책 자체는 시시하지만 짚어둘 가치가 있습니다. MCP에 대한 모든 참조는 quire.io가 아니라 mcp.quire.app을 사용해야 합니다. 세 곳 중 하나라도 호스트가 잘못되어 있으면 실행이 실패합니다.
에이전트 도구 세트 비대화. Anthropic의 기본 agent_toolset_20260401은 모든 범용 도구(bash, 파일 작업, 웹 검색, 코드 실행)를 컨텍스트에 싣습니다. 저희 에이전트는 그중 어느 것도 필요하지 않습니다. Quire MCP 서버 위에 기본 도구 세트를 그대로 두었더니 모델 호출당 입력 토큰이 80,000개를 넘었고, 즉시 Tier 1 속도 제한에 부딪혔습니다. 기본 도구 세트를 제거하고 Quire 도구를 필터링(위 참고)하자 약 12,000개로 떨어졌습니다. 교훈: 에이전트의 컨텍스트에 들어 있는 모든 도구는 에이전트가 호출하지 않더라도 세금입니다.
속도 제한 패닉. 비대화 문제를 파악하기 전까지 자연스러운 반응은 "API 등급을 업그레이드해야 한다"였습니다. 등급 업그레이드는 돈이 듭니다. 실제 문제는 에이전트가 사용하지도 않을 70,000개의 도구 정의 토큰을 로드하고 있었다는 것이었습니다. 더 큰 제한이 필요하다고 가정하기 전에 항상 컨텍스트 창에 무엇이 들어 있는지 확인하세요.
Quire MCP가 주간 변경 로그를 넘어 풀어주는 가능성
주간 변경 로그는 유용한 첫 에이전트지만, 대체로 개념 증명에 가깝습니다. 이 패턴(Managed Agent 1개 + Quire MCP + 예약 트리거)은 훨씬 더 많은 것으로 확장됩니다.
저희가 프로토타이핑 중인 몇 가지입니다.
- 밤사이 "진행 중"으로 옮겨진 업무를 읽고 Slack에 요약을 게시하는 일일 스프린트 킥오프 브리프
- 완료된
incident업무를 위해 Quire 프로젝트를 감시하다가, 타임라인과 기여 요인, 하위 업무에서 끌어온 후속 조치를 포함한 회고 문서 초안을 조립하는 인시던트 회고 작성기 - 매주 금요일 오후에 각 클라이언트 프로젝트에 대해 실행되어, 한 주의 산출물을 클라이언트에게 그대로 전달할 수 있는 표현으로 요약하는 클라이언트 상태 다이제스트
형태는 매번 동일합니다. 예약 트리거, 집중된 에이전트, 소규모의 Quire MCP 도구 모음, 출력물로서의 문서나 메시지. 어려운 작업(샌드박싱, 자격 증명, 에이전트 루프)은 Managed Agents에 있습니다. 도메인 작업(어떤 Quire 데이터를 질의할지, 무엇을 할지)은 시스템 프롬프트에 있습니다.
이 접근법이 적합하지 않은 경우
일회성 질문에 대해 Managed Agent는 과합니다. "이번 분기에 무엇이 출시되었는지" 한 번 요약하고 싶다면, 채팅 창에서 Claude에게 직접 묻고 Quire 데이터를 붙여넣는 편이 배포된 에이전트를 구축하는 것보다 빠릅니다. 에이전트 형태는 동일한 작업이 감독 없이 반복적으로 실행될 때에만 효과를 발휘합니다.
작업이 실제로 추론이 많이 필요한 경우, 예컨대 동일한 데이터에서 사려 깊은 제품 전략을 작성하는 일에도 잘못된 형태입니다. Haiku는 "요약하고 포매팅"하는 데에는 적합합니다. "이 데이터를 바탕으로 우리가 무엇을 해야 하는지 결정"하려면 Sonnet이나 Opus가 필요하고, 그 시점이라면 아마 사람의 검토도 함께 두고 싶을 것입니다.
그리고 프로젝트 데이터가 빈약하다면(예: 주당 완료된 업무가 두어 개에 불과하고 설명이 없는 경우), 에이전트가 요약할 만한 유용한 것이 없습니다. 출력물의 품질은 팀이 실제 업무 설명을 작성하는 데 들이는 규율만큼만 좋아집니다. 저희도 초기 테스트 실행에서 기술적으로 정확하지만 완전히 무의미한 브리프가 생성되어 어렵게 배웠습니다. 업무 이름의 절반이 그냥 티켓 ID였기 때문입니다.
핵심 정리
주간 변경 로그 에이전트는 범위는 작지만 효과는 큽니다. 누구도 따로 기억하지 않아도 반복적인 세금(월요일 회고 미팅)을 제거해주기 때문입니다. 이를 가능하게 한 요소들은 구체적입니다. 비용과 속도 제한 여유를 위한 Haiku 4.5, 컨텍스트 창을 타이트하게 유지하기 위한 공격적인 도구 필터링, mcp.quire.app으로만 트래픽을 허용하는 최소 권한 환경 정책, 그리고 에이전트가 실제 OAuth 토큰을 절대 만지지 않도록 하는 자격 증명 보관소.
일반적인 교훈은, Quire MCP와 Claude Managed Agents의 조합이 어떤 인프라도 구축하지 않고 프로젝트 데이터 앞에 자율 에이전트를 배치하는 빠른 방법이라는 점입니다. 어려운 부분(샌드박싱, 인증, 일정 잡기, 감사 로그)은 이미 해결되어 있습니다. 여러분이 가져와야 할 것은 프롬프트, 도구 선택, 그리고 애초에 요약할 가치가 있는 프로젝트 데이터를 작성할 규율입니다.
자주 묻는 질문
Quire MCP란 무엇인가요?
Quire MCP는 AI 에이전트가 표준화된 도구 인터페이스를 통해 Quire 워크스페이스를 읽고 쓸 수 있게 해주는 Model Context Protocol 서버입니다. 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건 반환되면 문서를 생성하지 말고, 해당 주가 비어 있다는 한 줄만 로그에 남깁니다. 이렇게 하면 팀이 해당 기간에 아무것도 출시하지 않았을 때 비어 있거나 오해를 일으키는 주간 브리프가 발행되는 것을 방지할 수 있습니다.
Quire MCP를 사용하려면 유료 Quire 요금제에 가입해야 하나요?
Quire MCP는 API 액세스가 있는 모든 요금제에서 동작합니다. 현재 API 할당량은 quire.io/pricing에서 확인하세요. 주 1회 실행되며 실행당 몇 차례의 도구 호출만 하는 에이전트라면, 일반적으로 무료 등급이나 스타터 한도로 충분합니다.
동일한 에이전트를 여러 Quire 프로젝트에 대해 실행할 수 있나요?
가능합니다. 가장 깔끔한 패턴은 워크플로당 하나의 에이전트 정의와 프로젝트당 하나의 세션을 사용하는 것입니다. 프로젝트 URL은 세션 생성 시점의 파라미터가 됩니다. 여러 프로젝트를 다루는 단일 주간 브리프를 원한다면, 프롬프트를 재구성하여 각 프로젝트를 순차적으로 조회하고 결과를 하나의 문서로 결합하세요.
여러분만의 에이전트를 Quire MCP 위에 구축할 준비가 되셨나요?
quire.io/signup에서 30일 무료 체험을 시작하세요 그리고 Quire 개발자 문서를 살펴보며 전체 MCP 도구 카탈로그를 확인하세요. 신용카드 없이, 전체 액세스.
