스킬.잇다
itda-hyve 아이콘 — 꿀색 둥근 타일 위의 검은 꿀벌

itda-hyve

Claude 가 내 PC 로
웹·메일·일정을 다룬다

Claude Desktop(Cowork)이 내 PC 의 네트워크로 웹을 읽고, 메일·캘린더·공공데이터 API 를 쓰게 해 주는 작은 프로그램입니다. 계정과 API 키는 내 PC 에만 두고, Claude 는 그 값을 보지 못합니다.

Windows 10/11 · macOS 12 이상 · 무료 · 받아서 두 번 누르면 설치 · 새 판으로 스스로 업데이트

메일 검색
0.2~0.7초
공시 API 조회
0.1초
설치할 라이브러리
0개
Claude 가 보는 키
0개

속도는 실측(itda-hyve 처리 시간) — 자세히

왜 필요한가요

Cowork 는 내 컴퓨터가 아니라 격리된 작업 공간에서 돌아서, 메일 서버나 공공 API 에 직접 닿지 못하는 경우가 많습니다. 비밀번호·API 키를 대화에 붙여 넣으면 Claude 에게 보이고 기록에도 남습니다. itda-hyve 는 내 PC 에서 도는 작은 프로그램으로, Claude 의 부탁을 받아 내 PC 의 네트워크로 대신 다녀옵니다. 열쇠(비밀번호·API 키)는 itda-hyve 만 갖고 있습니다.

  1. 격리된 작업 공간

    Claude · Cowork

    “첨부 받아서 요약해줘”
    키는 이름만 압니다

  2. 내 PC

    itda-hyve

    작은 프로그램 하나 · 늘 대기

    암호화 금고에서 키를 꺼내
    허용된 주소로만 채워 보냅니다

  3. 바깥

    메일 · 캘린더 · API · 웹

    네이버·Gmail·iCloud…
    공공데이터포털·OpenDART…

결과는 Claude 에게 돌려주거나, 첨부·응답처럼 큰 것은 내 PC 의 연결 폴더에 파일로 남깁니다.

Cowork 만으로 itda-hyve 와 함께
준비 스크립트가 쓰는 라이브러리를 새 대화마다 다시 설치합니다 설치 없음. 프로그램이 이미 떠 있어 첫 마디부터 바로 처리합니다
API 키·비밀번호 대화에 붙여 넣으면 Claude 에게 보이고 대화 기록에 남습니다 설정 창에 한 번. Claude 는 이름만 쓰고 값은 끝내 모릅니다
메일 작업 공간에서 메일 서버에 직접 닿지 못하는 경우가 많습니다 네이버·Gmail·다음·iCloud·네이트 메일을 찾고, 읽고, 첨부를 받고, 보냅니다. 읽어도 ‘안 읽음’ 그대로
파일 메일 서버·API 에 닿지 못하면 첨부나 원본 데이터를 가져올 수 없습니다 첨부·API 응답이 내 PC 폴더에 실제 파일로 남습니다. 한글 파일 이름 그대로
일정 캘린더 서버에도 직접 닿지 못하는 경우가 많습니다 네이버·iCloud 캘린더를 메일 계정 그대로 조회·등록합니다
되돌릴 수 없는 일 — 메일 보내기·일정 지우기는 미리보기 뒤 확인해야만 실행됩니다

무엇을 할 수 있나요

Claude 에게 평소 말투로 부탁하면, 스킬팩의 스킬이 itda-hyve 를 거쳐 아래 일을 합니다. 명령어를 외울 필요가 없습니다.

메일

메일함 목록·검색·읽기, 첨부를 폴더에 저장, 보내기. 네이버·Gmail·다음·iCloud·네이트·직접 입력(IMAP/SMTP). 읽어도 ‘안 읽음’ 그대로이고, 실행 파일 첨부는 저장하지 않으며 매크로 문서는 경고합니다.

캘린더

일정 조회·만들기·고치기·지우기. 네이버·iCloud 는 메일 계정 그대로 씁니다. 다른 곳에서 바뀐 일정은 덮어쓰지 않고, 참석자가 있는 일정은 고치거나 지우지 않습니다.

API 키·비밀번호 보관

공공데이터포털·OpenDART·KOSIS·ECOS·법령·네이버 검색 등의 키를 한 번만 넣어 둡니다. 넣는 순간 실제로 한 번 불러 유효한지 알려 주고, Claude 는 키 값을 보지 못합니다.

웹 읽기

내 PC 의 네트워크로 웹페이지를 받아 메뉴·광고를 걷어 낸 본문만 Claude 에게 줍니다. 보도자료·게시판 목록은 날짜 붙은 목록으로, 큰 응답은 파일로 저장합니다.

현재 위치

“여기 날씨 알려줘” 처럼 위치가 필요한 부탁에 시·군·구 수준의 대략적인 위치만 알려 줍니다. 정밀 좌표는 넘기지 않고 기록에도 남기지 않습니다.

문서 도구

Claude 가 만든 마크다운(md) 문서를 기업 문서 모양의 A4 쪽으로 보고, PDF 로 저장하거나 인쇄합니다. 같은 문서를 슬라이드로 나눠 발표할 수도 있습니다. md 파일을 두 번 눌러 바로 열 수도 있습니다 — 설정 방법.

Aside 브라우저 연결

Aside 브라우저를 쓰고 있다면 itda-hyve 가 찾아서 Claude Desktop 에 함께 등록합니다. 브라우저에서 사이트를 열고 읽고 누르는 브라우저 자동화가 필요한 스킬이 이 연결을 씁니다. 등록과 해제는 설정 › 연결 한 곳에서 합니다.

스킬팩 확인·설치

스킬.잇다의 최신 스킬팩(itda-work·itda-gov·itda-web·itda-travel)이 몇 판인지, 이 PC 에 설치된 판이 최신인지 보여 줍니다. 파일을 Claude Desktop 으로 끌어다 놓으면 설치됩니다. 새 판은 ↑ 로 알려 줄 뿐 저절로 바꾸지 않습니다.

새 판으로 스스로 업데이트

itda-hyve 는 새 판이 나오면 받아 서명을 확인하고, 10초 알린 뒤 바꿔서 다시 엽니다. 바뀐 뒤에는 Claude Desktop 을 한 번 다시 시작해야 새 판이 쓰입니다. Claude Desktop 에 올린 스킬팩은 저절로 바뀌지 않습니다 — ↑ 가 붙으면 그 파일을 다시 올립니다.

화면 크기 조절

글자가 작거나 크면 Ctrl + / − / 0(macOS 는 ⌘)이나 Ctrl 을 누른 채 마우스 휠로 화면 크기를 바꿉니다. 고른 크기는 다음에 열 때도 그대로이고, Ctrl+0 이면 원래 크기로 돌아갑니다.

내려받기

버튼을 누르면 최신판 설치 파일(Windows 는 압축 파일 zip, macOS 는 디스크 이미지 dmg)을 바로 받습니다. 받은 뒤에는 아래 설치 순서대로 하면 됩니다.

최신판 0.17.6

이 컴퓨터용

Windows (Intel·AMD)

itda-hyve-windows-amd64.zip

Windows 10/11 의 대부분 PC. 어느 쪽인지 모르면 이쪽을 받으세요 — ARM PC 에서도 돌아갑니다.

내려받기0.17.6

이 컴퓨터용

Windows on ARM

itda-hyve-windows-arm64.zip

Snapdragon 등 ARM PC·Mac 의 Parallels. 설정 > 시스템 > 정보 > 시스템 종류에 ‘ARM 기반 프로세서’ 가 보이면 이쪽입니다.

내려받기0.17.6

이 컴퓨터용

macOS (Apple Silicon)

itda-hyve-darwin-arm64.dmg

M1 이후의 Mac. 왼쪽 위 사과 메뉴 > 이 Mac 에 관하여 > ‘칩’ 항목에 Apple M… 이 보이면 이쪽입니다.

내려받기0.17.6

이 컴퓨터용

macOS (Intel)

itda-hyve-darwin-amd64.dmg

‘칩’ 대신 ‘프로세서’ 에 Intel 이 보이는 Mac. macOS 12 이상.

내려받기0.17.6

설치

받은 파일을 두 번 누르면 됩니다. 명령을 입력할 일은 없습니다. 아직 코드 서명을 하지 않은 판이라 처음 한 번 Windows·macOS 가 경고합니다 — 아래처럼 한 번만 넘기면 됩니다.

WindowsmacOS

Windows

  1. zip 받기

    위 내려받기에서 Windows (Intel·AMD) 를 받습니다. Snapdragon 같은 ARM PC 라면 Windows on ARM 판이 조금 더 빠르지만, 모르면 Intel·AMD 판으로 충분합니다. 받은 파일은 보통 다운로드 폴더에 있습니다.
    브라우저 다운로드 목록. itda-hyve-windows-amd64.zip 과 파일 열기 링크
    브라우저의 다운로드 목록에 itda-hyve-windows-amd64.zip 이 보입니다.
  2. zip 압축 풀기

    받은 zip 을 오른쪽 단추로 눌러 압축을 풉니다 — Windows 기본 메뉴는 모두 압축 풀기, 반디집 같은 압축 프로그램은 … 에 풀기. 같은 이름의 폴더가 생기고, 그 안에 itda-hyve.exe 와 설명서(README.txt·LICENSE.txt)가 있습니다. (압축을 풀지 않고 탐색기에서 zip 을 열어 itda-hyve.exe 를 눌러도 됩니다.)
    탐색기에서 itda-hyve-windows-amd64.zip 을 오른쪽 단추로 누른 메뉴. 여기에 풀기·알아서 풀기·itda-hyve-windows-amd64 에 풀기 항목
    zip 을 오른쪽 단추로 눌러 압축을 풉니다(그림은 반디집의 … 에 풀기).
    탐색기 파일 목록. itda-hyve-windows-amd64.zip 압축 폴더와 itda-hyve-windows-amd64 파일 폴더
    zip 옆에 같은 이름의 폴더가 생깁니다.
    탐색기 파일 목록. LICENSE.txt, README.txt, itda-hyve.exe 세 파일
    풀린 폴더 안 — itda-hyve.exe 와 설명서 README.txt·LICENSE.txt.
  3. itda-hyve.exe 두 번 누르기 — “Windows 의 PC 보호” 창 넘기기

    풀린 폴더의 itda-hyve.exe 를 두 번 누릅니다. 파란 “Windows 의 PC 보호” 창이 뜨면 추가 정보를 누르고, 아래에 나오는 실행을 누릅니다(창이 뜨지 않으면 다음 단계로).
    Windows 의 PC 보호 창. 인식할 수 없는 앱의 시작을 차단했다는 글 아래에 추가 정보 링크, 오른쪽 아래에 실행 안 함 단추만 있는 상태
    파란 ‘Windows 의 PC 보호’ 창이 뜨면 글 아래의 추가 정보를 누릅니다.
    Windows 의 PC 보호 창. 앱 itda-hyve.exe, 게시자 알 수 없는 게시자, 아래에 실행·실행 안 함 단추
    추가 정보를 누르면 게시자 ‘알 수 없는 게시자’ 와 실행 단추가 나옵니다. 실행을 누릅니다.
  4. “이 PC 에 설치할까요?” 에서 설치

    설치를 누르면 itda-hyve 가 스스로 설치되고(관리자 권한 필요 없음) 시작 메뉴에 itda-hyve 가 생긴 뒤 창이 열립니다. 이제 itda-hyve.exe 는 사용자 폴더 안의 설치 위치에서 돌고, 받은 파일은 더 쓰지 않습니다.
    itda-hyve 를 이 PC 에 설치할까요 창. 설치할 위치와 관리자 권한이 필요 없다는 설명, 설치·이번엔 그냥 실행 단추
    ‘itda-hyve 를 이 PC 에 설치할까요?’ — 설치를 누릅니다.
    Windows 에서 처음 연 itda-hyve 대시보드. 맨 위 카드에 Claude Desktop 칩, 왼쪽 아래 판 번호
    설치가 끝나면 itda-hyve 창이 열립니다. Claude Desktop 연결은 아래 처음 설정에서 합니다.
  5. 마지막으로 받은 설치 파일 지우기

    itda-hyve 창이 열렸으면 받은 zip 과 풀린 폴더(itda-hyve.exe·README.txt·LICENSE.txt)를 지웁니다. 남겨 두면 나중에 그 itda-hyve.exe 를 눌러 이미 설치한 것과 헷갈립니다. 다음부터는 시작 메뉴에서 itda-hyve 를 검색해 엽니다.
    탐색기에서 LICENSE.txt, README.txt, itda-hyve.exe 세 파일을 고르고 도구 막대의 삭제를 가리킨 모습
    다운로드 폴더의 풀린 파일(과 zip)을 골라 삭제합니다.
    Windows 시작 메뉴 검색. 검색어 hyve, 최고의 매치에 벌 아이콘의 itda-hyve 앱
    설치한 뒤에는 시작 메뉴에서 hyve 를 검색하면 itda-hyve 앱이 나옵니다.
  6. 화면 오른쪽 아래 알림 영역(^ 안에 숨어 있을 수 있습니다)에 벌 아이콘이 생깁니다. 창을 닫아도 꺼지지 않고 이 아이콘으로 숨습니다.

macOS

  1. dmg 받기

    위 내려받기에서 내 Mac 에 맞는 판을 받습니다 — M1 이후 Mac 은 Apple Silicon, 그 전 Mac 은 Intel.
  2. dmg 를 열고 Applications 로 끌어다 놓기

    받은 dmg 를 두 번 눌러 엽니다. 나온 창에서 itda-hyve 를 같은 창의 Applications(응용 프로그램) 폴더로 끌어다 놓은 뒤 창을 닫습니다. 응용 프로그램 폴더에 있어야 새 판으로 스스로 바뀝니다.
    dmg 를 연 Finder 창. 볼륨 itda-hyve(판 번호) 안에 Applications 폴더, itda-hyve 앱, LICENSE.txt, README.txt
    받은 dmg 를 열면 나오는 창 — itda-hyve 를 같은 창의 Applications 폴더로 끌어다 놓습니다.
  3. 처음 열면 뜨는 경고 — 완료

    응용 프로그램 폴더에서 itda-hyve 를 두 번 눌러 처음 열면 “‘itda-hyve’을(를) 열지 않음 — 악성 코드가 없음을 확인할 수 없습니다” 창이 뜹니다 (macOS 14 이하는 “확인되지 않은 개발자”). 아직 Apple 공증을 받지 않은 판이라 그렇습니다 — 휴지통으로 이동이 아니라 완료(또는 취소)를 누릅니다.
    macOS 경고 창. ‘itda-hyve’을(를) 열지 않음, 악성 코드가 없음을 확인할 수 없다는 글과 휴지통으로 이동·완료 단추
    처음 열면 뜨는 ‘열지 않음’ 창 — 휴지통으로 이동이 아니라 완료를 누릅니다.
  4. 시스템 설정에서 그래도 열기

    시스템 설정 › 개인정보 보호 및 보안을 열고 아래로 내리면 보안 칸에 “Mac 을 보호하기 위해 ‘itda-hyve’을(를) 차단했습니다” 줄이 있습니다. 그 옆의 그래도 열기를 누릅니다.
    macOS 시스템 설정의 개인정보 보호 및 보안 화면. 보안 칸에 Mac 을 보호하기 위해 itda-hyve 를 차단했다는 줄과 그래도 열기 단추
    시스템 설정 › 개인정보 보호 및 보안 — 보안 칸의 차단 줄 옆 ‘그래도 열기’.
  5. 한 번 더 그래도 열기 → Touch ID·암호

    “‘itda-hyve’을(를) 열겠습니까?” 창이 다시 뜨면 그래도 열기를 누르고, 이어지는 창에서 Touch ID 를 대거나 암호 사용… 으로 Mac 암호를 넣습니다. itda-hyve 창이 열리면 끝입니다 — 이 과정은 처음 한 번만 합니다. 창의 “Claude Desktop 미등록” 은 아래 처음 설정에서 잇습니다.
    macOS 확인 창. ‘itda-hyve’을(를) 열겠습니까? 글 아래 휴지통으로 이동·그래도 열기·완료 단추
    한 번 더 묻는 ‘열겠습니까?’ 창 — 그래도 열기를 누릅니다.
    macOS 인증 창. 개인정보 보호 및 보안으로 계속하려면 Touch ID 나 관리자 암호를 넣으라는 글과 암호 사용·취소 단추
    Touch ID 를 대거나 암호 사용… 으로 Mac 암호를 넣습니다.
    macOS 에서 처음 연 itda-hyve 대시보드. Claude Desktop 미등록 칩과 최근 1시간 도구 호출 없음, 왼쪽 아래 판 번호
    itda-hyve 창이 열리면 설치 끝 — Claude Desktop ‘미등록’ 은 처음 설정에서 잇습니다.
  6. 받은 dmg 꺼내고 지우기

    설치가 끝나면 Finder 왼쪽 목록의 itda-hyve 디스크 옆 ⏏ 를 눌러 꺼낸 뒤, 받은 dmg 파일을 지워 주세요. 다음부터는 응용 프로그램 폴더·Launchpad·Spotlight(⌘ 스페이스)에서 itda-hyve 를 찾아 엽니다. 받은 파일을 다시 누르면 이미 설치한 것과 헷갈릴 수 있습니다.
  7. 화면 위 메뉴 막대에 벌 아이콘이 생깁니다. 창을 닫아도 꺼지지 않고 이 아이콘으로 숨습니다.

처음 설정

itda-hyve 를 설치했으면 바로 이어서 1~4 를 합니다. 10분이면 됩니다. itda-hyve 는 메일·일정·웹 같은 도구를 Claude 에 붙여 주고, 스킬팩은 Claude 에게 그 도구를 언제·어떻게 쓰는지 알려 줍니다 — 둘 다 있어야 합니다. itda-hyve 의 설정은 창 왼쪽 아래 설정(⚙)에 모여 있습니다.

  1. Claude Desktop 에 로그인 — 이미 했다면 넘어갑니다

    Claude Desktop 을 설치하고 내 Claude 계정으로 로그인해 둡니다.
  2. Claude Desktop 에 연결 — 다시 시작이 핵심

    itda-hyve 의 설정 › 연결 › Claude 연결에서 등록을 누릅니다. 단추가 등록됨으로 바뀌고 경로 옆에 “최신” 이 보입니다. 그다음 Claude Desktop 을 완전히 종료했다가 다시 엽니다 — 창만 닫으면 안 됩니다. Windows 는 화면 오른쪽 아래 알림 영역의 Claude 아이콘 › 종료, macOS 는 메뉴 막대의 Claude 아이콘 › 종료(또는 ⌘Q). (선택) Aside 브라우저를 쓴다면 같은 화면의 Aside 연결에서 함께 등록합니다 — 브라우저 자동화가 필요한 스킬이 씁니다.
    itda-hyve 설정 창의 Claude 연결 화면. Claude Desktop 에 itda-hyve 등록 카드에 현재 등록 경로와 최신 표시, 등록됨·등록 해제·새로고침 단추
    itda-hyve 설정 › 연결 › Claude 연결 — 등록을 누르면 단추가 ‘등록됨’ 이 되고 경로 옆에 ‘최신’ 이 보입니다.
    Windows 알림 영역의 Claude 아이콘 메뉴. 앱 표시와 종료 항목
    알림 영역의 Claude 아이콘을 누르면 나오는 메뉴 — 종료로 Claude Desktop 을 완전히 끈 뒤 다시 엽니다.
  3. Claude Desktop 에서 연결 확인

    다시 연 Claude Desktop 의 설정 › 커넥터에 itda-hyve 가 보이고 상태에 ✓ 가 있으면 이어진 것입니다. 채팅 입력칸의 + › 커넥터에서 itda-hyve 가 켜져 있는지도 봅니다(꺼져 있으면 켭니다). 설정 › 개발자 › 로컬 MCP 서버에서는 itda-hyve(Aside 를 등록했다면 aside 도)가 실행 중인지 볼 수 있습니다.
    Claude Desktop 설정의 커넥터 목록. itda-hyve 줄이 유형 데스크톱·로컬 개발, 상태 체크 표시
    Claude Desktop 설정 › 커넥터 — itda-hyve 줄의 상태에 ✓ 가 있으면 이어진 것입니다.
    Claude Desktop 채팅 입력칸의 더하기 메뉴에서 커넥터를 펼친 모습. itda-hyve 스위치가 켜져 있음
    Claude Desktop 채팅 입력칸의 + › 커넥터 — itda-hyve 가 켜져 있는지 봅니다.
    Claude Desktop 설정의 로컬 MCP 서버 화면. 목록에 aside 와 itda-hyve, itda-hyve 를 고른 오른쪽에 실행 중 표시와 명령어 itda-hyve.exe, 인수 serve
    Claude Desktop 설정 › 개발자 › 로컬 MCP 서버 — itda-hyve 가 ‘실행 중’ 이면 Claude Desktop 이 itda-hyve 를 띄운 것입니다.
    Claude Desktop 설정의 로컬 MCP 서버 화면. aside 를 고른 오른쪽에 실행 중 표시와 명령어 aside.exe, 인수 mcp
    Aside 를 함께 등록했다면 같은 화면에서 aside 도 ‘실행 중’ 입니다.
  4. 스킬팩 설치

    itda-hyve 창 왼쪽의 스킬팩을 열면 itda-work·itda-gov·itda-web·itda-travel 파일 줄이 보입니다. Claude Desktop 설정 › 플러그인 › 추가 › 플러그인 업로드를 열고, itda-hyve 의 파일 줄을 그 화면으로 끌어다 놓은 뒤 업로드 — 팩마다 한 번씩 합니다. Claude Desktop 의 목록에 Itda work·Itda gov·Itda web·Itda travel 이 보이면 끝입니다. 끌기가 안 되면 받기로 받은 파일을 탐색기·Finder 에서 끌어다 놓습니다. 새 판이 나오면 스킬팩 옆에 ↑ 가 붙습니다.
    • itda-work — 메일(email)·일정(calendar) 스킬 — 메일 계정을 itda-hyve 에 등록해 둡니다
    • itda-gov — DART 공시·부동산 실거래(dart·realty-deals) 등 공공데이터 — 발급받은 API 키를 itda-hyve 에 넣어 둡니다
    • itda-web — 웹 검색·웹페이지 읽기(web-search·web-reader) — 여러 검색 엔진으로 찾고, itda-hyve 의 웹 읽기로 본문만 가져옵니다
    • itda-travel — 숙소 요금 비교·여행지 맛집(hotel-search·eatery-trend) — 숙소 요금은 키 없이, 맛집은 발급받은 네이버 API 키를 itda-hyve 에 넣어 둡니다

    교육에서 스킬팩 파일을 받았다면 같은 업로드 화면에 올립니다.

    itda-hyve 스킬팩 화면. itda-work 와 itda-gov 가 v15.0.0 설치 안 됨, 각각 끌어다 놓을 파일 줄과 받기 단추
    itda-hyve 의 스킬팩 — itda-work·itda-gov 의 최신 판과 설치 여부, 끌어다 놓을 파일 줄과 받기 단추가 보입니다.
    Claude Desktop 설정 › 플러그인 화면. 추가 단추를 펼쳐 플러그인 업로드 항목이 보이는 모습
    Claude Desktop 설정 › 플러그인 › 추가 › 플러그인 업로드 를 엽니다.
    왼쪽에 Claude Desktop 플러그인 업로드 화면(itda-work 파일이 들어간 상태), 오른쪽에 itda-hyve 스킬팩 화면
    itda-hyve 의 파일 줄을 Claude Desktop 의 플러그인 업로드 화면으로 끌어다 놓고 업로드를 누릅니다.
    Claude Desktop 설정 › 플러그인 목록. 내가 만듦 2개 — Itda gov 와 Itda work
    올린 팩은 Claude Desktop 설정 › 플러그인 목록에 보입니다(그림은 Itda gov·Itda work 를 올린 뒤).
  5. 메일 계정 넣기 — 메일·일정 스킬을 쓸 때

    설정 › 서비스 › 메일 계정에서 계정 추가를 누르고 제공자(네이버·Gmail·다음·iCloud·네이트)를 고릅니다. 이메일 주소와 앱 비밀번호를 넣고 연결 테스트 — IMAP·SMTP 모두 “성공” 이면 저장. 네이버·iCloud 는 같은 계정으로 캘린더도 씁니다. 메일 앱 비밀번호는 일반 비밀번호가 아닙니다 — 만드는 법.
  6. API 키 넣기 — 공공데이터·검색 스킬을 쓸 때

    설정 › 서비스 › API 키·비밀번호에서 새 값 등록을 누르고 필요한 키를 고릅니다. 발급처 열기로 키를 받아 붙여 넣고 저장하고 확인 — 실제로 한 번 불러 “확인됨” 알림과 그 줄의 ✓ 가 뜨면 됩니다. 키 발급 방법은 API 키 발급 안내에 있습니다.
  7. 확인

    메일 계정을 넣었다면 Claude Desktop 의 새 대화(Cowork)에서 “등록된 메일 계정 알려줘” 라고 물어봅니다. 계정 이름이 나오면 끝입니다. “itda-hyve 에서 … 을(를) 사용하려고 합니다” 창이 뜨면 항상 허용을 권합니다.

md 문서를 두 번 눌러 열기

Claude 가 만든 마크다운(md) 문서를 파일을 두 번 눌러 바로 itda-hyve 문서 창(A4 쪽 보기·PDF 저장·인쇄)으로 열 수 있습니다. itda-hyve 를 설치하면 함께 들어 있고, 한 번만 정해 두면 됩니다.

WindowsmacOS

Windows

  1. md 연결 등록

    itda-hyve 의 설정(⚙) › 일반에 있는 md 파일 연결 카드에서 md 연결 등록을 누릅니다. 관리자 권한은 필요 없습니다. 카드에 “기본 앱 아님” 이 보이면 다음 단계로 넘어갑니다.
  2. Windows 설정에서 기본 앱으로 정하기

    같은 카드의 기본 앱으로 정하기… 를 누르면 Windows 설정의 앱 › 기본 앱 › itda-hyve 문서 페이지가 열립니다. .md 줄을 누르고 itda-hyve 문서 › 기본값 설정을 고릅니다. .markdown 파일도 쓰면 .markdown 줄도 똑같이 고릅니다. 줄에 이미 “itda-hyve 문서” 가 보여도 한 번 눌러 골라야 합니다 — 고르기 전에는 파일을 두 번 누를 때 앱 고르는 창이 뜹니다.
  3. 설정이 열리지 않으면 — 연결 프로그램 — 2 가 안 될 때

    md 파일을 오른쪽 단추로 눌러 연결 프로그램 › 다른 앱 선택에서 itda-hyve 문서를 고르고 항상을 누릅니다. 한 번만 열 때는 연결 프로그램 › itda-hyve 문서를 고릅니다 — 파일마다 창이 따로 뜹니다.
  4. itda-hyve 창으로 돌아와 카드에 기본 앱: itda-hyve 문서 가 보이면 끝입니다. 이제 md 파일을 두 번 누르면 바로 문서 창이 열립니다.

macOS

  1. 정보 가져오기에서 모두 변경

    md 파일 하나를 고르고 ⌘I(정보 가져오기)를 누릅니다. 다음으로 열기에서 itda-hyve 문서를 고른 뒤 모두 변경… 을 누릅니다.
  2. 한 번만 열 때

    md 파일을 오른쪽 클릭 › 다음으로 열기 › itda-hyve 문서. 이미 창이 떠 있어도 파일마다 새 창으로 열립니다.
  3. 따로 승인하지 않아도 됩니다 — 설치에서 itda-hyve 를 그래도 열기로 한 번 승인했으면 안에 든 itda-hyve 문서도 함께 승인됩니다.

itda-hyve 는 스스로 기본 앱을 바꾸지 않습니다. 원래 앱으로 되돌릴 때도 같은 곳에서 고릅니다. 문서 창만 열려면 시작 메뉴(Windows)나 Spotlight(macOS)에서 itda-hyve 문서를 찾습니다. Windows 에서 연결을 그만 쓰려면 카드의 해제를 누릅니다 — itda-hyve 가 등록한 것만 지워지고 다른 앱의 연결은 그대로입니다.

새 판으로 바꾸기

새 판이 나오면 itda-hyve 가 받아 서명을 확인하고, “새 판으로 바꿉니다” 를 10초 알린 뒤 스스로 바꿔 다시 엽니다(Windows·macOS). 설정과 저장한 계정·키는 그대로입니다. 사용자가 할 일은 Claude Desktop 다시 시작 하나입니다.

  • 바뀐 뒤에는 Claude Desktop 을 완전히 종료했다가 다시 여세요. 그 전까지 Claude 는 옛 판 itda-hyve 를 계속 씁니다(멈추지는 않습니다). itda-hyve 대시보드의 Claude Desktop 칩이 “재시작 대기” 로 알려 줍니다.

  • 서두르면 알림의 지금 바꾸기, 곤란하면 나중에(다음에 itda-hyve 를 열 때 다시 합니다). 저장하지 않은 문서가 있거나 Claude 가 itda-hyve 를 쓰는 중이면 끝날 때까지 기다립니다.

  • Claude Desktop 에 올린 스킬팩은 저절로 바뀌지 않습니다. itda-hyve 의 스킬팩에서 팩 옆에 ↑ 가 붙으면, 처음 설정 4 처럼 새 파일을 Claude Desktop 에 다시 올립니다.

  • 저절로 바뀌지 않았다면(회사 PC 의 쓰기 제한 등) 손으로 바꿉니다 — 위 내려받기에서 새 판을 받아, 벌 아이콘 › 종료로 itda-hyve 를 끈 뒤 Windows 는 새 itda-hyve.exe 를 두 번 눌러 “바꿀까요?” 에서 바꾸기, macOS 는 itda-hyve 를 Applications 로 끌어다 놓고 대치.

  • 수업처럼 판을 고정해야 하면 설정 › 정보에서 “새 판 확인” 을 끕니다. 끄면 묻지도 바꾸지도 않습니다.

자주 묻는 것

Claude 가 내 비밀번호나 API 키를 알게 되나요?

아니요. 값은 내 PC 의 암호화 파일에만 있고, 값을 읽어 가는 기능이 itda-hyve 에 아예 없습니다. 대화에서 Claude 가 키를 물어보면 알려 주지 말고 itda-hyve 설정에 넣으세요.

앱 비밀번호는 무엇인가요?

메일 프로그램 전용으로 따로 만드는 비밀번호입니다. 로그인 비밀번호가 아닙니다. 네이버는 메일 › 환경설정 › POP3/IMAP 설정에서 IMAP 을 켜고(2단계 인증을 쓰면 ‘애플리케이션 비밀번호’), Gmail 은 Google 계정 › 보안 › 2단계 인증 › 앱 비밀번호(16자리), 다음은 메일 환경설정 › IMAP/POP3 의 IMAP 전용 비밀번호, iCloud 는 appleid.apple.com › 로그인 및 보안 › 앱 암호에서 만듭니다. 네이트는 IMAP 사용을 켜고 일반 비밀번호를 씁니다.

어느 파일을 받아야 할지 모르겠어요.

Windows 는 ‘Windows (Intel·AMD)’ 를 받으세요 — ARM PC 에서도 돌아갑니다. Mac 은 사과 메뉴 › 이 Mac 에 관하여에서 ‘칩’ 에 Apple M… 이 보이면 Apple Silicon, ‘프로세서’ 에 Intel 이 보이면 Intel 판입니다.

창을 닫았는데 꺼진 건가요?

아니요. 창을 닫으면 화면 오른쪽 아래 알림 영역(Windows — ^ 안에 숨어 있을 수 있습니다)이나 화면 위 메뉴 막대(macOS)의 벌 아이콘으로 숨습니다. 다시 열 때는 아이콘 › itda-hyve 열기, 끝낼 때는 아이콘 › 종료. 켤 때마다 띄워 두려면 설정 › 일반의 ‘로그인 시 자동 실행’ 을 켭니다.

화면이 너무 크거나 작아요. 왼쪽 메뉴가 사라졌어요.

Ctrl+0(macOS 는 ⌘0)을 누르면 원래 크기로 돌아옵니다. 크기는 Ctrl + / − 로 바꿉니다.

Claude 가 “도구가 없다” 고 해요.

Claude Desktop 에 연결한 뒤 Claude Desktop 을 완전히 종료했다가 다시 열었는지 확인하세요. 창만 닫으면 안 됩니다 — Windows 는 알림 영역 아이콘에서 종료, macOS 는 ⌘Q. itda-hyve 의 설정 › 연결 › Claude 연결에서 ‘등록됨’ 인지, Claude Desktop 채팅 입력칸의 + › 커넥터에서 itda-hyve 가 켜져 있는지도 봅니다.

회사·학교 PC 에서 열리지 않아요.

아직 코드 서명을 하지 않은 판이라, 실행 정책이 엄격한 회사·학교 PC 와 ‘Smart App Control’ 이 켜진 Windows 11 PC 일부에서는 열 수 없습니다. 개인 PC 에서 써 주세요.

Cowork 가 “itda-hyve 에서 … 을(를) 사용하려고 합니다” 라고 물어요.

‘항상 허용’ 을 권합니다. 메일 보내기·일정 지우기처럼 되돌릴 수 없는 일은 itda-hyve 가 따로 미리보기를 보여 주고 한 번 더 확인을 받습니다.

그만 쓰려면 어떻게 지우나요?

itda-hyve 의 설정 › 정보 맨 아래 itda-hyve 제거… 를 누르고, 지울 것을 보여 주는 창에서 제거를 누릅니다. Claude Desktop 연결·로그인 시 자동 실행·바로가기를 정리하고 앱을 지운 뒤 끝내기로 마칩니다(macOS 는 앱을 휴지통으로 옮깁니다). 저장한 메일 계정·API 키까지 지우려면 그 창에서 ‘내 설정·계정·비밀 정보도 지우기’ 를 켭니다. 다 되면 Claude Desktop 을 다시 시작하세요. Claude Desktop 에 설치한 스킬팩은 Claude Desktop 에서 지웁니다.
Windows 는 설정 › 앱 › 설치된 앱에서 itda-hyve 를 찾아 제거를 눌러도 같은 창이 뜹니다.
앱이 열리지 않으면 손으로 지웁니다. 설정 › 연결 › Claude 연결에서 ‘등록 해제’, 설정 › 일반의 ‘로그인 시 자동 실행’ 을 끈 뒤 아이콘 › 종료로 끝냅니다. 그다음 macOS 는 응용 프로그램 폴더의 itda-hyve 를 휴지통으로, Windows 는 설치 폴더 %LOCALAPPDATA%\Programs\itda-hyve 와 시작 메뉴의 itda-hyve 바로가기를 지웁니다. 저장한 계정·키까지 지우려면 사용자 폴더의 .itda\hyve 폴더도 지웁니다 — 그 옆의 master.key 는 다른 itda 앱도 쓰는 열쇠라 남겨 두세요.

더 알아보기

실제로 돌려 본 예시, 잰 속도, 설계를 더 자세히 보고 싶다면 펼쳐 보세요.

이렇게 말하면, 이렇게 움직입니다Cowork 에서 실제로 돌려 본 문장입니다.

메일 첨부

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

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

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

공시 조회

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

  1. itda-hyve OpenDART 로 가는 요청에 등록해 둔 API 키를 채워 넣는다 0.1초
  2. itda-hyve 응답에서 키가 되비치면 •••• 로 가려 돌려준다
  3. Claude 공시 3건을 골라 정리한다

Claude 는 키 값을 한 번도 보지 않았습니다. 키가 없으면 ‘설정 창에 넣으세요’라고만 안내하고, 넣는 즉시 재시작 없이 됩니다.

공공데이터

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

  1. Claude 지역 코드를 찾는다
  2. itda-hyve 공공데이터포털 API 를 여러 페이지 부르고 응답을 연결 폴더에 파일로 저장한다
  3. Claude 저장된 파일을 스크립트로 가공해 요약한다

원본 응답 파일이 내 PC 폴더에 남습니다. 요약은 그 파일에서 나오므로 언제든 다시 확인할 수 있습니다.

일정

내일 오후 3시에 "주간 회의" 30분 일정 만들어줘 → 방금 만든 일정 지워줘

  1. itda-hyve 캘린더에 일정을 만든다
  2. itda-hyve 지우기 전에 제목·시각 미리보기만 보여 주고 멈춘다
  3. itda-hyve 사용자가 확인하면 그때 지운다

네이버·iCloud 캘린더를 메일 계정 그대로 씁니다. 지우기와 메일 보내기는 언제나 한 번 더 묻습니다.

기다림은 대부분 1초 안itda-hyve 가 요청을 받아 결과를 돌려주기까지 걸린 시간입니다. macOS·Windows 에서 실제 계정으로 잰 범위이고, Claude 가 생각하는 시간은 들어 있지 않습니다.

메일 한 통 열기 네이버

0.06~0.07초

공시 조회 OpenDART

0.07~0.1초

메일 검색 네이버

0.2~0.7초

첨부 저장 네이버

0.09~1.9초

캘린더 조회 네이버

0.4초

캘린더 조회 iCloud

1.2~3.3초

막대는 여러 번 잰 최솟값~최댓값. 같은 메일함을 이어서 쓰면 연결을 재사용해 더 빨라집니다(첨부 저장 1.9초 → 0.09초). iCloud 캘린더에 일정을 만들거나 지우는 일은 서버 왕복이 많아 8~9초 걸립니다.
설치 기다림 없이, 첫 마디부터스킬이 스크립트로 직접 처리하면 필요한 라이브러리를 먼저 깔아야 합니다. 그런데 Cowork 작업 공간은 대화가 바뀌면 설치한 라이브러리가 사라져서 새 대화마다 다시 설치합니다. itda-hyve 는 실행 파일 하나라 설치할 것이 없고, Claude Desktop 이 켜 둔 채로 기다리다 바로 응답합니다.

스크립트로 직접 처리할 때

  1. 새 대화
  2. 라이브러리 설치대화마다 다시
  3. 서버 연결실행마다 새로
  4. 처리

itda-hyve 를 거칠 때

  1. 새 대화
  2. 바로 처리이미 떠 있고, 연결도 이어 씀

0개

설치할 라이브러리

파이썬도 패키지도 필요 없는 실행 파일 하나입니다. 예를 들어 캘린더는 예전 스킬이 caldav·icalendar 를 설치해야 했지만, 이제 itda-hyve 안에 들어 있습니다.

25~33초

무거운 설치 한 번의 대기

Cowork 에서 실제로 잰 설치 시간입니다(도구 하나 첫 설치 25.5초, 다른 도구는 대화마다 151MB·약 33초 재설치). itda-hyve 가 맡은 일에는 이 대기가 없습니다.

1.9초 → 0.09초

연결을 이어 쓰기

늘 떠 있는 프로그램이라 메일 서버 연결을 다시 씁니다. 같은 메일함에서 이어 받은 첨부 저장이 1.9초에서 0.09초로 줄었습니다.

안전 설계Claude 에게 일을 맡기되, 비밀번호와 키는 넘기지 않습니다.
  • 값은 내 PC 의 암호화 파일에만

    메일 앱 비밀번호와 API 키는 ~/.itda/hyve/vault.enc 에 AES-256-GCM 으로 암호화해 둡니다. 설정 파일에는 비밀값이 없습니다. 값이 PC 밖으로 나가는 때는 그 값을 쓰는 요청이 허용된 주소로 갈 때뿐입니다.

  • Claude 는 값을 보지 못합니다

    값을 읽어 가는 도구가 아예 없습니다. 스킬은 {{secret:이름}} 같은 자리표시자만 쓰고, 요청이 나가는 순간 itda-hyve 가 채워 넣습니다. 응답에 값이 되비치면 •••• 로 가립니다. 대화에서 Claude 가 키를 물어보면 알려 주지 말고 설정 창에 넣으세요.

  • 허용된 주소로 나갈 때만

    키마다 쓸 수 있는 호스트가 정해져 있습니다. 다른 주소로 가는 요청이면 값을 채우지 않고 요청 자체를 보내지 않습니다. 메일 비밀번호도 그 계정의 메일·캘린더 서버로만 갑니다.

  • 메일 발송·일정 삭제는 2단계 확인

    첫 호출은 미리보기만 보여 주고 아무것도 보내지 않습니다. 확인한 뒤에야 보냅니다. 확인은 10분 안에 한 번만 쓸 수 있고, 수신자·제목·본문·첨부 중 하나라도 바뀌면 무효가 됩니다. 발송 횟수 제한 같은 다른 장치는 없으니 미리보기를 꼭 읽고 확인하세요.

  • 모든 호출은 기록, 포트는 열지 않음

    감사 로그에 시각·도구·대상·결과가 남습니다(본문·수신자·비밀번호는 남기지 않습니다). Claude Desktop 과는 표준 입출력(stdio)으로만 이어지고 로컬 포트를 열지 않습니다 — 같은 PC 의 다른 프로그램이 포트로 도구를 부를 길을 만들지 않기 위해서입니다.

  • 새 판은 서명을 확인한 뒤에만

    스스로 업데이트할 때 받은 파일의 서명을 확인하고, 맞을 때만 바꿉니다. 판을 고정해야 하면 설정 › 정보에서 ‘새 판 확인’ 을 끕니다.

문의

설치나 사용 중에 막히면 문의 폼으로 알려 주세요. itda-hyve 대시보드의 맨 위 카드(“지금 무슨 일이 일어나고 있나” — 연결 상태)와 최근 1시간 요약, 그리고 화면에 뜬 오류 메시지를 캡처해 함께 보내면 빠릅니다(이 화면에는 메일 본문·비밀번호가 나오지 않습니다).