Quire MCP + Claude Managed Agents: 실제로 작동하는 구축 사례

최종 업데이트: 2026년 8월 6일

월요일 오전 9시 4분입니다. 팀 채널에서 누군가 묻습니다. "지난주에 뭐 출시했는지 간단히 정리해 줄 수 있어요?" 세 사람이 탭을 열고 칸반 보드를 훑으며, 완료된 마흔 개의 업무 중 정말 의미 있던 게 무엇인지 떠올려 봅니다. 20분 뒤 돌아온 답은 두 줄 요약과 어깨 으쓱뿐입니다. 10분이면 끝날 회의는 40분으로 늘어나고, 화요일이 되면 아무도 내용을 기억하지 못합니다.

우리는 이 악순환을 없앴습니다. Quire MCP와 Claude Managed Agents로 에이전트를 만들었습니다.

이 에이전트는 매주 월요일 아침 Dev_Changelog 프로젝트를 읽고, 지난 7일간 완료된 항목을 모두 찾아 팀별로 묶습니다. 개발자 약어는 고객이 읽을 수 있는 표현으로 바꾸고, 전체 브리프를 새 Quire 문서에 작성합니다. 총 실행 시간은 30초 미만이고, 이후 유지 관리는 전혀 필요 없습니다.

이 글은 구축 과정 전체를 다룹니다. 도중에 막혔던 세 가지와 해결 방법도 포함했습니다. 프로젝트 데이터를 두고 채팅만 하는 데 그치지 않고 실제로 일하는 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은 에이전트가 실제로 만든 문서입니다.

팀은 스탠드업 시간에 2분 만에 읽습니다. 작성하는 사람도, 작성을 기억해야 하는 사람도 없습니다.

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까지 약 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 세션은 1회성이라 자동으로 반복되지 않습니다. 에이전트를 매주 월요일에 실행하려면, 아무 스케줄러나 sessions.create API 엔드포인트에 연결하고 cron 표현식 0 9 * * 1을 사용하세요.

우리는 주 1회 Anthropic API를 호출하는 간단한 Cloudflare Workers Cron Trigger를 쓰지만, 일정에 맞춘 GitHub Actions도 똑같이 잘 작동하고 클라우드 함수 플랫폼이면 무엇이든 가능합니다.

무엇이 잘못되었고, 어떻게 알아챘나요?

깔끔한 주간 실행에 이르는 동안 세 가지가 어긋났습니다. 비슷한 것을 만든다면 적어도 하나는 마주치게 되므로 짚어 둘 만합니다.

잘못된 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 하나, Quire MCP, 예약 트리거라는 이 패턴은 훨씬 많은 곳으로 확장됩니다.

우리가 시제품으로 만들고 있는 몇 가지는 다음과 같습니다.

• 밤사이 "진행 중"으로 옮겨진 업무를 읽고 요약을 Slack에 게시하는 일일 스프린트 킥오프 브리프
• Quire 프로젝트에서 완료된 incident 업무를 지켜보다가, 하위 업무에서 타임라인, 기여 요인, 후속 조치를 뽑아 회고 문서 초안을 조립하는 장애 회고 초안 작성기
• 금요일 오후마다 각 고객 프로젝트에서 실행되어, 그 주의 산출물을 고객에게 바로 전달할 수 있는 표현으로 요약하는 고객 상태 다이제스트

구조는 매번 같습니다. 예약 트리거, 한 가지 일에 집중한 에이전트, 소수의 Quire MCP 도구, 그리고 출력으로 나오는 문서나 메시지입니다. 어려운 부분(샌드박싱, 자격 증명, 에이전트 루프)은 Managed Agents가 맡습니다. 도메인 작업(어떤 Quire 데이터를 조회하고 무엇을 할지)은 시스템 프롬프트에 담깁니다.

이 방식이 맞지 않는 경우는 언제인가요?

일회성 질문에는 Managed Agent가 과합니다. "이번 분기에 무엇을 출시했는지" 한 번만 요약하면 된다면, 채팅 창에서 Claude에게 직접 묻고 Quire 데이터를 붙여 넣는 편이 배포형 에이전트를 만드는 것보다 빠릅니다. 같은 작업을 사람의 감독 없이 반복할 때에야 에이전트라는 형태가 값어치를 합니다.

같은 데이터로 사려 깊은 제품 전략을 쓰는 것처럼 정말로 추론 비중이 높은 업무에도 맞지 않습니다. Haiku는 "요약하고 형식을 맞추는" 일에는 충분합니다. "이 문제에 어떻게 대응할지 결정하는" 일에는 Sonnet이나 Opus가 필요하고, 그 단계에서는 사람이 함께 확인하는 편이 좋을 것입니다.

프로젝트 데이터가 빈약한 경우(예를 들어 한 주에 완료된 업무가 두어 개뿐이고 설명이 없는 경우)에도 에이전트가 요약할 만한 내용이 없습니다. 결과물의 품질은 팀이 업무 설명을 얼마나 성실하게 쓰느냐에 달려 있습니다. 초기 테스트 실행에서 업무 이름의 절반이 티켓 ID뿐이라, 기술적으로는 맞지만 전혀 정보가 없는 브리프가 나온 적이 있어 이를 몸소 배웠습니다.

AI가 전혀 필요 없으신가요? Quire CLI는 모델 호출 없이도, 스크립트와 cron으로 돌릴 수 있는 구조화된 명령으로 같은 데이터를 제공합니다.

핵심 요약

주간 변경 내역 에이전트는 범위는 작지만 효과는 큽니다. 아무도 따로 챙기지 않아도 반복적으로 치르던 비용(월요일 회의)을 없애 주기 때문입니다.

성공의 비결은 구체적이었습니다. 비용과 속도 제한 여유를 위한 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 등급에서 속도 제한이 훨씬 높습니다. 사람 없이 도는 주간 작업이라면 추론 성능의 미미한 차이보다 비용과 속도 제한의 여유가 더 중요합니다.

에이전트가 주간 브리프를 만드는 데 시간이 얼마나 걸리나요?

해당 기간에 완료된 업무가 약 스무 개인 프로젝트라면 전체 실행은 처음부터 끝까지 30초 미만입니다. Quire 검색, 결과 처리, 문서 본문 작성, 프로젝트에 문서 생성까지 모두 포함한 시간입니다. 대부분은 도구 호출 왕복이 아니라 모델 호출에 쓰입니다.

에이전트가 내 프로젝트의 기존 업무를 수정하거나 삭제할 수 있나요?

해당 도구 권한을 명시적으로 부여한 경우에만 가능합니다. Quire MCP 서버는 약 95개의 도구를 제공하지만, Claude Managed Agents에서는 에이전트마다 일부만 활성화할 수 있습니다. 변경 내역 용도에서는 읽기와 생성 도구 네 가지만 활성화했으므로, 프롬프트 인젝션으로 시도하더라도 에이전트는 기존 데이터를 수정하거나 삭제할 수 없습니다.

에이전트가 실행되는 주에 완료된 업무가 없으면 어떻게 되나요?

에이전트 프롬프트에는 대체 지침이 들어 있습니다. 검색 결과에 완료된 업무가 하나도 없으면 문서를 만들지 않고, 그 주는 비어 있었다는 한 줄만 기록합니다. 팀이 해당 기간에 아무것도 출시하지 않았을 때 빈 브리프나 오해를 부르는 브리프가 게시되는 일을 막아 줍니다.

Quire MCP를 사용하려면 유료 Quire 플랜이 필요한가요?

Quire MCP는 API 접근이 가능한 모든 플랜에서 작동합니다. 현재 API 할당량은 Quire 요금 페이지에서 확인할 수 있습니다. 실행당 도구 호출이 몇 번에 불과한 주 1회 에이전트라면 무료 등급이나 입문 등급의 한도로도 대체로 충분합니다.

같은 에이전트를 여러 Quire 프로젝트에 적용할 수 있나요?

네. 가장 깔끔한 방식은 워크플로마다 에이전트 정의를 하나 두고, 프로젝트마다 세션을 하나씩 만드는 것입니다. 프로젝트 URL은 세션을 만들 때 넘기는 매개변수가 됩니다. 여러 프로젝트를 아우르는 주간 브리프 하나를 원한다면, 프롬프트를 바꿔 각 프로젝트를 차례로 조회한 뒤 결과를 하나의 문서로 합치세요.

Quire MCP로 나만의 에이전트를 만들 준비가 되셨나요?

quire.io/signup에서 30일 무료 체험 시작하기를 통해 시작하고, Quire 개발자 문서에서 전체 MCP 도구 목록을 확인해 보세요. 신용카드 없이 모든 기능을 사용할 수 있습니다.