---
title: "Claude 는 부탁하고, 내 PC 가 다녀온다 — itda-hyve 소개"
description: "Claude Desktop(Cowork)은 격리된 작업 공간에서 돌아서 메일 서버나 공공 API 에 직접 닿지 못하는 경우가 많습니다. itda-hyve 는 내 PC 에서 도는 작은 프로그램으로, Claude 의 부탁을 받아 내 PC 의 네트워크로 메일·일정·공공데이터·웹을 대신 다녀옵니다. 비밀번호와 API 키는 내 PC 에만 두고 Claude 는 이름만 씁니다. 실제로 돌려 본 장면과 안전 설계, 한계까지 정리했습니다."
created_at: 2026-10-15
category: guide
tags: ["itda-hyve", "Claude Desktop", "Cowork", "MCP", "스킬팩", "email", "dart", "공공데이터", "문서 도구"]
published: true
---
Claude Desktop 의 Cowork 에 "받은편지함에서 첨부 받아서 요약해줘" 라고 부탁해 본 적이 있다면, 이런 장면을 한 번쯤 만났을 겁니다.

- **닿지 않는다.** Cowork 는 내 컴퓨터가 아니라 격리된 작업 공간에서 돌아서, 메일 서버나 공공데이터 API 에 직접 닿지 못하는 경우가 많습니다.
- **매번 다시 깐다.** 스킬이 스크립트로 일을 처리하려면 라이브러리를 먼저 설치해야 하는데, 대화가 바뀌면 설치한 것이 사라집니다. Cowork 에서 실제로 재 보니 무거운 설치 한 번에 25~33초가 걸렸습니다.
- **키를 붙여 넣게 된다.** 메일 앱 비밀번호나 API 키를 대화에 붙여 넣으면 Claude 에게 그대로 보이고 대화 기록에도 남습니다.

[itda-hyve](/hyve/) 는 이 세 가지를 한 번에 풀려고 만든 작은 프로그램입니다.

## 한 문장으로: 부탁은 Claude, 다녀오는 일은 내 PC

itda-hyve 는 내 PC 에서 도는 실행 파일 하나입니다. Claude Desktop 이 이 프로그램을 {term:mcp-server|MCP 서버}로 띄워 두고, {term:claude-cowork} 작업 중에 메일·일정·API·웹이 필요하면 itda-hyve 에 부탁합니다. itda-hyve 는 **내 PC 의 네트워크로** 대신 다녀와서 결과를 돌려주고, 첨부나 API 응답처럼 큰 것은 내 PC 의 폴더에 파일로 남깁니다.

![Claude 는 부탁하고 내 PC 가 다녀온다는 흐름도. 왼쪽 ① 격리된 작업 공간 Claude · Cowork 칸에는 "첨부 받아서 요약해줘", 키는 이름만 압니다, 메일 서버·공공 API 에 직접 닿지 못하는 경우가 많다. "부탁" 화살표를 지나 가운데 ② 내 PC itda-hyve 칸에는 실행 파일 하나 · 늘 대기, 암호화 금고에서 키를 꺼내 허용된 주소로만 채워 보낸다, 메일 발송·일정 삭제는 한 번 더 확인. "내 PC 네트워크" 화살표를 지나 오른쪽 ③ 바깥 칸에는 네이버·Gmail·다음·iCloud·네이트, 네이버·iCloud 캘린더, 공공데이터포털·OpenDART·KOSIS, 웹 페이지 본문. 아래 띠: 결과는 Claude 에게 돌려주거나, 첨부·API 응답처럼 큰 것은 내 PC 의 연결 폴더에 파일로 남긴다](./img-1.png)

설치할 라이브러리가 없고, 이미 떠 있는 프로그램이라 새 대화의 첫 마디부터 바로 처리합니다. 같은 메일함을 이어서 쓰면 서버 연결도 다시 써서, 첨부 저장이 1.9초에서 0.09초로 줄었습니다.

## 이렇게 말하면, 이렇게 움직입니다

아래는 Cowork 에서 실제로 돌려 본 문장입니다. 명령어를 외울 필요 없이 평소 말투로 부탁합니다.

### 메일 첨부 받아 요약

> naver 받은편지함에서 제목 "첨부 테스트" 메일의 첨부를 연결 폴더에 받아서, 내용을 세 줄로 요약해줘.

1. itda-hyve 가 받은편지함에서 제목으로 메일을 찾습니다(0.4초).
2. 첨부 PDF·XLSX 2개를 내 PC 의 연결 폴더에 저장합니다(1.9초).
3. Claude 가 저장된 파일을 열어 숫자까지 세 줄로 요약합니다.

폴더에는 「3분기 영업 보고서.pdf」「월별 매출 현황.xlsx」가 한글 이름 그대로 생기고, 메일은 여전히 '안 읽음'입니다. 메일은 [email 스킬](/skills/itda-work/email)이 맡습니다.

### 공시 조회

> 삼성전자 최근 공시 3건 알려줘

itda-hyve 가 OpenDART 로 가는 요청에 미리 등록해 둔 API 키를 채워 넣고(0.1초), Claude 가 공시 3건을 골라 정리합니다. 이 과정에서 Claude 는 키 값을 한 번도 보지 않습니다. 키가 없으면 "설정 창에 넣으세요" 라고만 안내하고, 넣는 즉시 재시작 없이 됩니다. [dart 스킬](/skills/itda-gov/dart)이 씁니다.

### 공공데이터 받아 요약

> 강남구 2026년 1월 아파트 매매 실거래를 받아서 요약해줘.

Claude 가 지역 코드를 찾고, itda-hyve 가 공공데이터포털 API 를 여러 페이지 불러 응답을 폴더에 파일로 저장하면, Claude 가 그 파일을 스크립트로 가공해 요약합니다. **원본 응답 파일이 내 PC 에 남기 때문에** 요약이 맞는지 언제든 다시 확인할 수 있습니다. [realty-deals 스킬](/skills/itda-gov/realty-deals)이 씁니다.

itda-hyve 가 요청을 받아 결과를 돌려주기까지는 대부분 1초 안입니다(메일 검색 0.2~0.7초, 공시 조회 0.1초 — Claude 가 생각하는 시간은 빼고 잰 값). 더 자세한 측정은 [itda-hyve 페이지의 "더 알아보기"](/hyve/)에 있습니다.

## 지금 할 수 있는 것 (0.17.4)

- **메일** — 메일함 목록·검색·읽기, 첨부를 폴더에 저장, 보내기. 네이버·Gmail·다음·iCloud·네이트와 직접 입력(IMAP/SMTP). 읽어도 '안 읽음' 그대로이고, 실행 파일 첨부는 저장하지 않으며 매크로 문서는 경고합니다.
- **캘린더** — 네이버·iCloud 캘린더를 메일 계정 그대로 조회·만들기·고치기·지우기. 다른 곳에서 바뀐 일정은 덮어쓰지 않고, 참석자가 있는 일정은 고치거나 지우지 않습니다. [calendar 스킬](/skills/itda-work/calendar)이 씁니다.
- **공공데이터·검색 API** — 공공데이터포털·OpenDART·KOSIS·ECOS·법령·네이버 검색 등. 키 이름·발급처·허용 주소가 미리 들어 있어, 키를 넣는 순간 실제로 한 번 불러 유효한지 알려 줍니다. 발급 방법은 [API 키 발급 안내](/credentials/)에 있습니다.
- **웹 읽기** — 내 PC 의 네트워크로 웹 페이지를 받아 메뉴·광고를 걷어 낸 본문만 Claude 에게 줍니다. 보도자료·게시판 목록은 날짜 붙은 목록으로 받습니다. [web-reader 스킬](/skills/itda-web/web-reader)이 씁니다.
- **문서 도구** — 아래에서 따로 소개합니다.
- 그 밖에 시·군·구 수준의 대략적인 현재 위치, Aside 브라우저 연결, 새 판으로 스스로 업데이트도 합니다.

## 문서 도구: Claude 가 쓴 md 를 보고서로

Claude 에게 보고서를 맡기면 결과는 대개 마크다운(md) 파일로 옵니다. 내용은 좋은데, 그대로 결재 올리거나 출력하기에는 모양이 아쉽습니다. itda-hyve 의 문서 도구는 md 한 파일을 **기업 문서 모양의 A4 쪽**으로 보여 주고, 그 모습 그대로 PDF 로 저장하거나 인쇄합니다.

![itda-hyve 문서 창의 편집 화면. 위 도구 막대에 보기·편집, 쪽·이어보기·슬라이드, 테마 "보고서", 고쳐 달라기, 새 문서, 열기·저장·인쇄·PDF 저장 단추. 그 아래 굵게·제목·목록·표·CSV 표·링크·그림·알림·컨테이너·차트·쪽 나눔·발표·목차·각주 넣기 단추. 왼쪽에는 md 원문(title: itda-hyve 문서 창 둘러보기 등 머리말과 본문), 오른쪽에는 같은 글이 A4 보고서 쪽으로 보이는 미리보기 — 문서번호·판·작성일 표, 1. 문서 창으로 할 수 있는 일, 내보내기 표](./01-doc-window.png)

- **보고서·제안서·기안문·회의록·매뉴얼** 같은 테마를 고르면 같은 글이 그 모양으로 바뀝니다. 회사 테마도 만들 수 있습니다(macOS 는 Safari 17.4 이상의 WebKit 이 있어야 합니다).
- **편집**을 누르면 왼쪽에 원문, 오른쪽에 미리보기가 나란히 보입니다. 고치면 바로 따라옵니다.
- 표는 차트로, 수식·흐름도도 그립니다. 같은 글을 **슬라이드**로 나눠 전체 화면으로 발표할 수도 있습니다.
- Claude 도 이 문서 창을 씁니다. 문법을 확인하고, 문서 창과 같은 렌더러로 문법 경고를 검사한 뒤(쪽 넘침까지는 보지 않습니다), 다 쓴 문서를 문서 창으로 열어 줍니다. [markdown-doc 스킬](/skills/itda-work/markdown-doc)이 이 흐름을 맡습니다.

메일·API 가 "바깥에서 가져오는" 일이라면, 문서 도구는 Claude 가 만든 결과를 "사람이 쓰는 모양으로 내보내는" 일입니다.

## 왜 믿고 맡길 수 있나: 안전 설계

itda-hyve 의 기본 원칙은 하나입니다. **Claude 에게 일을 맡기되, 비밀번호와 키는 넘기지 않는다.**

![공시 조회 요청에서 키가 지나가는 네 단계. 1 Claude 가 쓴 요청: 주소 opendart.fss.or.kr, 키 자리에는 {{secret:DART_API_KEY}} — 값은 모른다, 이름만 쓴다. 2 주소 확인: DART_API_KEY 의 허용 주소 opendart.fss.or.kr 와 같으면 값을 채우고, 다른 주소면 채우지 않고 요청 자체를 보내지 않는다. 3 보내고 받기: 내 PC 네트워크로 OpenDART 에 다녀오고, 응답에 키가 되비치면 crtfc_key=•••• 로 가린 뒤 돌려준다. 4 Claude 가 정리: 공시 3건을 골라 표로 정리하고, 키가 없으면 "설정 창에 넣으세요" 라고만 안내한다. 아래 띠: 값을 읽어 가는 도구가 itda-hyve 에 아예 없다 — 값은 내 PC 의 암호화 파일(vault.enc)에만 있다. 메일 비밀번호도 같다: 그 계정의 메일·캘린더 서버로만 간다](./img-2.png)

- **값은 내 PC 의 암호화 파일에만.** 메일 앱 비밀번호와 API 키는 내 PC 의 암호화 파일(AES-256-GCM)에 둡니다. 설정 파일에는 비밀값이 없습니다.
- **Claude 는 값을 보지 못합니다.** 값을 읽어 가는 도구가 아예 없습니다. 스킬은 `{{secret:이름}}` 같은 자리표시자만 쓰고, 요청이 나가는 순간 itda-hyve 가 채워 넣습니다.
- **허용된 주소로 나갈 때만.** 키마다 쓸 수 있는 주소가 정해져 있어, 다른 곳으로 가는 요청이면 값을 채우지 않고 요청 자체를 보내지 않습니다.
- **메일 보내기·일정 지우기는 2단계 확인.** 첫 호출은 미리보기만 보여 주고 아무것도 보내지 않습니다. 확인은 10분 안에 한 번만 쓸 수 있고, 메일은 수신자·제목·본문·첨부 중 하나라도, 일정은 그사이 그 일정이 바뀌면 무효입니다.
- **모든 호출은 기록, 포트는 열지 않음.** 감사 로그에 시각·도구·대상·결과가 남습니다(본문·수신자·비밀번호는 남기지 않습니다). Claude Desktop 과는 표준 입출력으로만 이어지고 로컬 포트를 열지 않습니다.

### 알고 쓰셔야 할 한계

- **처음 열 때 경고가 뜹니다.** 아직 코드 서명·공증을 받지 않은 판이라 Windows·macOS 가 처음 한 번 경고합니다. 실행 정책이 엄격한 회사·학교 PC 에서는 열리지 않을 수 있어, 지금은 개인 PC 를 권합니다.
- **가림은 안전 인증이 아닙니다.** 응답에 키가 되비치면 `••••` 로 가리지만, 서버가 값을 조각내거나 특이하게 바꿔 되돌려 주면 남을 수 있습니다. 그래서 가리기보다 "애초에 허용된 주소로만 보낸다" 를 먼저 둡니다.
- **발송 횟수 제한은 없습니다.** 메일 발송을 막는 고정 장치는 2단계 확인 하나입니다. 미리보기를 꼭 읽고 확인하세요.
- **프록시를 거쳐야만 밖으로 나가는 사내망에서는 API·웹 읽기가 안 됩니다.** 키가 엉뚱한 곳으로 새지 않게 목적지를 직접 확인하려고 프록시 설정을 쓰지 않습니다. 메일·캘린더는 이 제한과 무관합니다.
- **새 판으로 바뀐 뒤에는 Claude Desktop 을 다시 시작해야 합니다.** 그 전까지는 옛 판을 씁니다. Claude Desktop 에 올린 스킬팩은 저절로 바뀌지 않으니, 새 판 표시(**↑**)가 붙으면 다시 올립니다.

## 도구와 방법: 스킬팩과 함께

itda-hyve 는 **통로**입니다. 메일·일정·웹 같은 도구를 Claude 에 붙여 줄 뿐, 그 도구를 언제·어떤 순서로 쓸지는 모릅니다. 그걸 아는 쪽이 {term:skillpack}입니다. 둘 다 있어야 위의 장면이 나옵니다.

itda-hyve 의 **스킬팩** 메뉴를 열면 스킬.잇다의 최신 스킬팩(itda-work·itda-gov·itda-web·itda-travel)이 몇 판인지, 이 PC 에 설치된 판이 최신인지 보입니다. 파일 줄을 Claude Desktop 의 플러그인 업로드 화면으로 끌어다 놓으면 설치됩니다(화면은 [itda-hyve 페이지의 처음 설정](/hyve/)에 있습니다).

- [itda-work](/skills/itda-work/) — 메일·일정·문서
- [itda-gov](/skills/itda-gov/) — DART 공시·부동산 실거래 등 공공데이터
- [itda-web](/skills/itda-web/) — 웹 검색·웹 페이지 읽기
- [itda-travel](/skills/itda-travel/) — 숙소 요금 비교·여행지 맛집

## 시작하기

itda-hyve 는 Windows 10/11·macOS 12 이상에서 무료로 씁니다. 받아서 두 번 누르면 설치되고, 새 판이 나오면 스스로 바뀝니다. 내려받기와 설치·처음 설정(Claude Desktop 연결, 스킬팩, 메일 계정·API 키 넣기)은 모두 [itda.work/hyve](/hyve/) 한 곳에 정리해 두었습니다. 10분이면 됩니다.

설치를 마쳤으면 Cowork 새 대화에서 **"등록된 메일 계정 알려줘"** 라고 물어보세요. 계정 이름이 나오면 준비가 끝난 것입니다. 막히는 곳이 있으면 [문의 폼](/#contact)으로 알려 주세요.

## 다음 이야기

itda-hyve 는 내 PC 의 열쇠와 도구를 안전하게 내어 주는 자리로 계속 넓혀 가고 있습니다. 새 기능이 공개 판에 들어오면 다시 소개하겠습니다.