스킬.잇다
guide

Claude 는 부탁하고, 내 PC 가 다녀온다 — itda-hyve 소개

Claude Desktop(Cowork)은 격리된 작업 공간에서 돌아서 메일 서버나 공공 API 에 직접 닿지 못하는 경우가 많습니다. itda-hyve 는 내 PC 에서 도는 작은 프로그램으로, Claude 의 부탁을 받아 내 PC 의 네트워크로 메일·일정·공공데이터·웹을 대신 다녀옵니다. 비밀번호와 API 키는 내 PC 에만 두고 Claude 는 이름만 씁니다. 실제로 돌려 본 장면과 안전 설계, 한계까지 정리했습니다.

나무 책상 위 작은 집 모양 코퍼 컴퓨터의 문이 열리고, 황동 전령새가 봉투를 물고 창가의 편지·달력·문서 더미까지 점선으로 다녀오며, 부탁을 담은 말풍선 메모와 자물쇠 잠긴 열쇠 상자는 책상 위에 그대로 남아 있는 수채 일러스트 [코퍼 오렌지 악센트] — AI generated by codex (gpt-6-astra)
나무 책상 위 작은 집 모양 코퍼 컴퓨터의 문이 열리고, 황동 전령새가 봉투를 물고 창가의 편지·달력·문서 더미까지 점선으로 다녀오며, 부탁을 담은 말풍선 메모와 자물쇠 잠긴 열쇠 상자는 책상 위에 그대로 남아 있는 수채 일러스트 [코퍼 오렌지 악센트]
AI generated by codex (gpt-6-astra)

Claude Desktop 의 Cowork 에 “받은편지함에서 첨부 받아서 요약해줘” 라고 부탁해 본 적이 있다면, 이런 장면을 한 번쯤 만났을 겁니다.

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

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

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

itda-hyve 는 내 PC 에서 도는 실행 파일 하나입니다. Claude Desktop 이 이 프로그램을 MCP 서버로 띄워 두고, 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 의 연결 폴더에 파일로 남긴다

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

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

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

메일 첨부 받아 요약

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

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

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

공시 조회

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

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

공공데이터 받아 요약

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

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

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

지금 할 수 있는 것 (0.17.4)

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

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

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

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

  • 보고서·제안서·기안문·회의록·매뉴얼 같은 테마를 고르면 같은 글이 그 모양으로 바뀝니다. 회사 테마도 만들 수 있습니다(macOS 는 Safari 17.4 이상의 WebKit 이 있어야 합니다).
  • 편집을 누르면 왼쪽에 원문, 오른쪽에 미리보기가 나란히 보입니다. 고치면 바로 따라옵니다.
  • 표는 차트로, 수식·흐름도도 그립니다. 같은 글을 슬라이드로 나눠 전체 화면으로 발표할 수도 있습니다.
  • Claude 도 이 문서 창을 씁니다. 문법을 확인하고, 문서 창과 같은 렌더러로 문법 경고를 검사한 뒤(쪽 넘침까지는 보지 않습니다), 다 쓴 문서를 문서 창으로 열어 줍니다. 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)에만 있다. 메일 비밀번호도 같다: 그 계정의 메일·캘린더 서버로만 간다

  • 값은 내 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 에 붙여 줄 뿐, 그 도구를 언제·어떤 순서로 쓸지는 모릅니다. 그걸 아는 쪽이 skillpack입니다. 둘 다 있어야 위의 장면이 나옵니다.

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

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

시작하기

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

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

다음 이야기

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

이 글에서 언급된 스킬

email

itda-hyve 에 등록한 네이버·Gmail·다음/카카오·아이클라우드·회사 메일 계정으로 메일을 찾고 읽고 보내는 스킬입니다. "메일 보내줘", "받은편지함 확인해줘", "naver 메일 읽어줘", "안 읽은 메일 있어?", "이 메일에 답장해줘"처럼 말하면 됩니다. 목록은 제목·보낸 사람만 먼저 보여 주고 고른 메일만 엽니다(읽음 표시 안 바뀜). "첨부 받아서 요약해줘"는 첨부를 폴더에 받아 파일을 열어 읽습니다. 발송은 미리보기를 보여 주고 승인을 받은 뒤에만 합니다. [책임 경계] 본 스킬은 메일 찾기·읽기·발송 전담 — 아침 브리핑 페이지(오늘 일정+미회신 요청 한 장)는 itda-work:morning-brief, 일정 조회·추가는 itda-work:calendar.

dart

금융감독원 DART 전자공시 API로 기업 정보를 수집하는 스킬입니다. "삼성전자 재무제표 조회해줘", "경쟁사 직원수 알려줘", "사업보고서 비교해줘", "네이버 배당 현황", "셀트리온 소송 이력"처럼 말하면 됩니다. 기업 프로필·재무·인력·사업보고서·공시 목록에 더해 배당·증자·소송·전환사채 등 주요사항도 반환합니다.

realty-deals

국토교통부 부동산 실거래 12개 유형을 단일 인터페이스로 수집하는 스킬입니다. "최근 6개월 강남구 아파트 실거래 전부 받아줘", "분당 연립다세대 매매 2025년 데이터 CSV로 줘", "강서구 오피스텔 전월세 조회해줘"처럼 말하면 됩니다. 전체 페이지네이션·다개월 범위·CSV/JSON 출력을 지원합니다. [책임 경계] 본 스킬은 국토교통부 실거래 raw 수집 전담 — 가격지수·평균/중위 파생 통계는 itda-gov:realty-price-stats.

calendar

itda-hyve 에 등록한 네이버·아이클라우드·직접 입력(CalDAV 주소) 계정의 캘린더에서 일정을 조회·검색·추가·수정·삭제하고 빈 시간을 찾아주는 스킬입니다. "내일 3시 회의 추가해줘", "이번 주 일정 보여줘", "다음 주에 1시간 빈 시간 찾아줘", "OO 프로젝트 회의 다 찾아줘", "그 약속 취소해줘"처럼 말하면 됩니다. 수정은 조회한 etag 로만, 삭제는 미리보기를 보여 주고 승인을 받은 뒤에만 합니다. [책임 경계] 본 스킬은 일정 조회·추가·수정·삭제·빈 시간 탐색 전담 — 아침 브리핑 페이지(오늘 일정+미회신 메일 한 장)는 itda-work:morning-brief, 메일 읽기·발송은 itda-work:email.

web-reader

WebFetch가 못 다루는 한국 웹페이지(EUC-KR/CP949 등 정적 페이지)의 본문을 출처가 붙은 마크다운으로, 목록 페이지·RSS 는 항목 레코드로 가져오는 폴백 스킬입니다. "이 한국 사이트 읽어줘", "EUC-KR 페이지 가져와줘", "이 목록 페이지 항목만 뽑아줘"처럼 말하면 됩니다. 받기·본문 추출은 itda-hyve 의 web_read 가 합니다. [책임 경계] 본 스킬은 공개 웹 페이지 단건 읽기 전담 — 키워드 검색은 itda-web:web-search, JS 렌더·로그인·봇 차단 페이지는 브라우저 경로(itda-web:aside-browser-mcp).

markdown-doc

itda-hyve 문서 창에서 보는 마크다운 문서(보고서·제안서·기안문·회의록·매뉴얼·발표 자료)를 쓰고 고치는 스킬입니다. "분기 보고서 md 로 써줘", "이 문서 경고 고쳐줘", "이 차트 도넛으로 바꿔줘", "회의록 양식으로 정리해줘", "발표 자료 md 로 만들어줘"처럼 말하면 됩니다. 문서 창의 "Claude 에게 고쳐 달라기"로 복사한 요청 글(파일 경로·대상 줄·경고·문법 해시가 든 글)을 붙여 넣었을 때도 이 스킬을 씁니다. 지금 설치된 앱의 문법을 itda-hyve 에서 받아 쓰고, 같은 렌더러로 검사해 경고 0 으로 맞춥니다. [책임 경계] 본 스킬은 itda-hyve 문서 창용 md 전담 — 한글(HWPX) 문서를 만들거나 읽는 일은 itda-doc:hwpx.

관련 스킬 추천

morning-brief

오늘 일정 전체·일정별 관련 메일·일정과 무관한 미회신 메일(요약)을 모아 아침 브리핑 HTML 한 장을 그리는 스킬입니다(itda-hyve). "아침 브리핑 만들어줘", "/morning-brief"처럼 말하면 됩니다. 기본은 시간축 모양, "보고서 형식으로"·"표로"·"인쇄용으로" 하면 그 모양. 날씨 절이 기본(Sections: 환율 추가·none 제외), 정확 문구 "액션 버튼 포함"일 때만 버튼. 형식만 보려면 "샘플 브리핑 보여줘". 일정 질문·메일 확인엔 쓰지 않습니다. [책임 경계] 본 스킬은 아침 브리핑 페이지 전담 — itda-work:calendar 는 일정, itda-work:email 은 메일.

aside-browser-mcp

Aside(사용자의 로그인 세션·쿠키·메모리를 쥔 AI 브라우저)를 MCP 도구 exec·repl·memory_search 로 다루는 규율 정본입니다. 이미 로그인해 둔 사이트(Slack·Gmail·Notion·클라우드 콘솔)에서 조회·작성·조작하거나 사용자의 개인 맥락이 필요할 때 씁니다. "슬랙 확인해줘", "지메일에서 찾아줘", "지금 열려 있는 탭 봐줘", "장바구니에 담아줘"처럼 말하면 됩니다. Aside MCP 도구가 없는 환경에서는 동작하지 않습니다. [책임 경계] 본 스킬은 Aside MCP 커넥터 전담 — 로그인 불요 정적 페이지는 itda-web:web-reader.

imagegen

발표자료·블로그·문서용 이미지와 삽화를 품질 하한과 함께 만드는 스킬입니다. 사용자의 ChatGPT 구독(codex)으로 그립니다. "블로그 히어로 이미지 만들어줘", "슬라이드 배경 비주얼", "쇼츠용 세로 삽화", "제품 컷", "이 사진처럼 한 장 더"처럼 말하면 됩니다. 실측으로 검증한 케이스 카드(cases/, 9종)로 프롬프트를 짜고, 생성은 itda-hyve 가 사용자 PC 에 설치한 codex 로 합니다. 여러 장은 한꺼번에 병렬로 만듭니다. [책임 경계] 본 스킬은 이미지 새로 생성 전담 — 이미 있는 이미지의 크기·여백·포맷 가공은 다루지 않습니다.

질문·제안·버그 신고 무엇이든 환영합니다.

문의하기