AI 도구에서 WindowPin 쓰기
MCP 서버를 붙이면 AI 도구가 지금 열린 창을 확인하고, 그 창에 메모나 이름표를 붙일 수 있습니다.
먼저 알아 둘 것
이 연동은 이 PC 안에서만 오갑니다. 메모 내용이 우리 서버로 가는 일은 없습니다. 통로는 지금 로그인한 계정에만 열리고, 설정에서 끄면 아예 열리지 않습니다.
1. 앱에서 연동을 켠다
설정 → 자동화 → “도구 연동 허용(MCP)” 이 켜져 있어야 합니다. 기본으로 켜져 있습니다.
2. Claude Code 에 등록
터미널에서 두 줄입니다. Node 18 이상이 필요합니다.
curl.exe -L -o "$env:USERPROFILE\windowpin-mcp.cjs" https://windowpin.com/windowpin-mcp.cjs
claude mcp add windowpin -- node "$env:USERPROFILE\windowpin-mcp.cjs"npm 패키지는 준비 중입니다. 그때까지는 위와 같이 파일 하나를 받아 쓰면 됩니다.
3. Cursor · Windsurf 등
설정 파일(mcp.json)에 이렇게 넣습니다.
{
"mcpServers": {
"windowpin": {
"command": "node",
"args": [
"C:\\Users\\<name>\\windowpin-mcp.cjs"
]
}
}
}쓸 수 있는 도구
| 도구 | 하는 일 |
|---|---|
windowpin_list_windows | 지금 열린 창 목록과 각 창에 붙은 메모 수 |
windowpin_list_notes | 메모 목록. 특정 창의 것만 볼 수도 있습니다 |
windowpin_search | 메모·라벨의 글과 체크리스트 항목 검색 |
windowpin_pin_note | 창에 여러 줄 메모를 붙입니다 |
windowpin_pin_label | 창 제목줄에 한 줄 이름표를 붙입니다 |
windowpin_update_note | 메모의 내용·색·모드를 바꿉니다 |
windowpin_remove_note | 메모를 휴지통으로 보냅니다 |
windowpin_add_rule | 조건에 맞는 창이 뜨면 자동으로 붙이는 규칙을 만듭니다 |
windowpin_list_rules | 자동 부착 규칙 목록 — 어떤 창에 무엇을 붙이는지 |
windowpin_remove_rule | 자동 부착 규칙 삭제 (이미 붙은 라벨은 그대로) |
windowpin_app_info | WindowPin 연결 상태와 버전 확인 |
WindowPin 이 꺼져 있으면
오류로 멈추지 않고 “실행 중이 아니거나 연동이 꺼져 있습니다” 를 돌려줍니다. AI 도구는 그 말을 그대로 사용자에게 전합니다.