에이전트 연결: AI가 데스크톱 앱 기능 쓰기
%BRAND% 데스크톱 앱의 집중, 할 일, 나의 하루, Agents, 음악, 메일 등을 로컬 MCP와 CLI로 Claude Code, Codex, Cursor가 써요. 한 번에 연결, 권한, 위험한 작업 확인, 되돌릴 수 있는 기록.
%BRAND% 데스크톱 앱이 이 컴퓨터에서 할 수 있는 일은 내 AI도 쓸 수 있어요. Claude Code, Codex, Cursor, Claude Desktop 등이 로컬 MCP나 widgetstore CLI로 호출해요. 모든 기능이 하나의 목록에서 만들어지니 새 기능도 자동으로 쓸 수 있어요.
한 번에 연결
데스크톱 앱 → 설정 → 에이전트 연결을 열어요.
- ‘한 번에 연결’에서 Claude Code / Codex / Cursor / Claude Desktop 옆의 연결을 눌러요.
- 어떤 파일에 무엇을 추가하는지 보여 주고, 권한을 읽기만, 읽기와 쓰기, 위험한 작업 포함(매번 확인) 중에서 고르게 해요.
- 그 AI 도구를 다시 시작하면 바로 쓸 수 있어요.
연결마다 전용 토큰이 만들어지고 그 도구의 설정 파일에만 쓰여요. 다른 내용은 그대로이고, 처음 바꾸기 전에 백업(<파일>.widgetstore-backup)을 남겨요. ‘연결된 클라이언트’에서 권한을 바꾸거나, 다시 묻게 하거나, 취소(토큰이 바로 무효가 되고 설정에서 항목을 지워요)할 수 있어요.
할 수 있는 일
- 읽기: 데스크톱 앱 상태, 시스템 모니터, 런처 검색, 집중 상태, 오늘의 할 일, Agents 보드 / 백그라운드 작업 / 끝난 작업, Loops, 데스크톱 위젯, 펫, 재생 중인 곡, 읽지 않은 메시지 수, 리더 피드와 글, 모델 게이트웨이 모델과 사용량, AI 사용량.
- 개인 정보 읽기(클라이언트마다 처음 한 번 데스크톱 앱에서 확인, 기억할 수 있어요): 나의 하루 타임라인, 스크린 타임, 최근 대화, 메일 목록과 본문.
- 쓰기: 집중 시작 / 끝내기, 할 일 추가 / 완료, 알림, 페이지 열기, 위젯 고정, Loop 켜기 / 끄기, 음악 조작, 피드 구독, 메일과 글 표시, 새 노트 시작, 스크린 타임 기록 일시 정지.
- 위험(매번 데스크톱 앱에서 확인, 클라이언트별로 기억할 수 있어요): 에이전트 작업 실행, 친구에게 메시지 보내기, 메일 보내기, 피드 구독 취소, 터미널 명령 실행.
- 터미널 명령: 확인 창에 전체 명령과 폴더를 보여 줘요. 명령 앞부분별로 기억할 수 있어요(
git status를 기억해도git push는 다시 물어요). 명령은 깨끗한 환경에서 실행돼 앱의 로그인 정보나 키를 받지 않아요. 기본 60초 뒤 시간 초과되고, 중지할 수 있고, 출력은 잘려요. 실제로 실행되니 되돌릴 수 없어요. 활동 기록에는 명령, 폴더, 종료 코드만 남기고 출력은 남기지 않아요. - 절대 제공하지 않는 것: 비밀번호, 보관함, 일회용 코드, 쿠키, API 키와 토큰.
인수까지 포함한 전체 목록은 widgetstore help --json 또는 widgetstore docs로 볼 수 있어요. 설정 폴더에도 AGENTS.md와 llms.txt를 만들어 둬요(설정 → ‘폴더에서 보기’).
직접 설정
- stdio:
widgetstore mcp에 환경 변수WIDGETSTORE_AGENT_TOKEN을 붙여 써요(‘연결’이 자동으로 설정해요). 연결하지 않은 프로그램은 호출할 수 없고, ‘설정 → 에이전트 연결’에서 연결하라고 안내해요. Claude Code는 Claude Code 자체의claude mcp add-json --scope user로 연결해요. - HTTP:
127.0.0.1의 임의 포트에서 MCP를 제공해요. 주소는 설정 폴더의agent-mcp.json(나만 읽을 수 있어요)에 있어요.Authorization: Bearer <연결할 때 받은 토큰>을 붙여 보내요. 브라우저의 웹 페이지에서는 접근할 수 없어요. - CLI:
widgetstore <기능> --json. 종료 코드: 0 성공 · 1 오류 · 2 사용법 오류 · 3 권한 없음 / 꺼짐 · 4 데스크톱 앱이 실행 중이 아님 · 5 내가 거부함. 자세한 내용은 WidgetStore CLI.
활동 기록과 되돌리기
모든 호출(성공, 실패, 거부)은 설정 → 에이전트 연결 → 활동 기록에 남아요. 이 컴퓨터에만 저장되고 비밀번호 같은 항목은 지워요. 되돌릴 수 있는 작업(할 일 완료, Loop 켜기 / 끄기, 구독, 메일 표시, 보내기 취소 시간 안의 메일, 데스크톱 위젯 제거, 기록 일시 정지, 집중 시작)에는 실행 취소 버튼이 있어요.
맨 위의 스위치로 로컬 호출을 한꺼번에 멈출 수 있어요.
최종 업데이트: 2026년 11월 18일