Clacky MCP: 모든 도구와 Claude, Cursor, Codex 연결 방법

Q: ChatGPT나 웹의 Claude에서도 되나요?

소셜 캘린더는 돼요. https://clacky.app/api/social/mcp를 커스텀 커넥터로 추가하고 로그인하세요. Mac 도구는 데스크톱 앱(Claude Desktop, Claude Code, Cursor, Codex)이 필요해요.

MCP란

앱에 내장

서버는 Clacky.app 안의 작은 헬퍼(Contents/MacOS/clacky-mcp)예요. Node도, 추가 설치도 필요 없어요.

켜기 전에는 꺼져 있어요

Clacky에서 설정 → AI 도구 연결 (MCP)을 여세요. 도구 그룹마다 각자의 스위치가 있어요.

일은 Mac이 해요

헬퍼가 모든 호출을 실행 중인 Clacky 앱에 넘기고, 앱은 필요할 때 먼저 물어본 뒤 작업을 처리해요.

AI 앱 연결하기

한 번만, 2분이면 돼요. Clacky 설정에도 내 앱 경로가 들어간 같은 스니펫이 표시돼요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 다음을 추가하세요.

{
  "mcpServers": {
    "clacky": {
      "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp"
    }
  }
}

1파일을 저장하고 Claude를 다시 시작하세요.
2“이 창의 스크린샷을 찍어 줘”라고 요청해 보세요.

모든 도구

서버 3개에 도구 27개. 이름과 매개변수는 AI에게 보이는 그대로예요.

Mac에서

clacky-mcp 헬퍼(stdio). Claude Desktop, Claude Code, Cursor, Codex.

알림

notify
Clacky의 에이전트 사운드를 재생하고 알림을 표시해요. 예: 긴 작업이 끝났거나 내 확인이 필요할 때.
매개변수: title, message?, sound?: done | needs | error

스크린샷, Grab Text, 녹화

take_screenshot
화면, 영역 또는 창을 캡처하고 PNG 경로와 작은 미리보기를 돌려줘요. 먼저 물어볼 수 있어요.
매개변수: target?: screen | area | window
grab_text
화면 영역이나 이미지/PDF의 텍스트를 Apple의 기기 내 인식으로 읽고 텍스트만 돌려줘요.
매개변수: source?: area | file, path?, languages?
start_recording
Clacky의 화면 녹화를 시작해요(3초 카운트다운). 자동 정지도 설정할 수 있어요. ~/Movies에 저장돼요.
매개변수: seconds? (3–600)
stop_recording
녹화를 멈추고 영상 경로를 돌려줘요.

Mac Health

get_mac_health
CPU, 메모리 압박, 디스크 공간, 배터리, 온도. 앱이나 프로세스 이름은 없어요.

메모와 할 일

add_note
Clacky 메모에 메모를 추가해요.
매개변수: text
add_task
오늘(또는 내일) 목록에 할 일을 추가해요.
매개변수: text, day?: today | tomorrow
list_today_tasks
오늘의 할 일과 완료한 항목.

집중 및 Keep Awake

start_focus
집중 타이머를 시작해요.
매개변수: minutes? (1–180)
stop_focus
집중 타이머를 멈춰요.
keep_awake
Mac과 디스플레이를 깨어 있게 해요(몇 분 동안 또는 끌 때까지). 덮개를 닫은 상태도 선택할 수 있어요.
매개변수: on, minutes?, lid_closed?

모드

get_mode
켜진 모드(Record, Code, Focus, Call, Quiet 또는 내 모드)와 사용할 수 있는 모드.
set_mode
모드를 바꿔요. “none”이면 모든 것을 원래대로 돌려놓아요.
매개변수: mode (id, name or "none")

소셜 게시물 (캘린더)

list_social_accounts
연결된 계정, 계정 세트, 서명, 이번 달 남은 게시 횟수.
schedule_post
게시물을 예약해요(Clacky에서 승인하면 바로 게시도 가능). 이미지와 서명은 선택 사항이에요.
매개변수: text, at, accounts? | set?, captions?, image_path?, signature?
list_scheduled_posts
두 날짜 사이의 게시물을 플랫폼별 상태와 링크와 함께 보여줘요.
매개변수: from?, to?, include_posted?
cancel_scheduled_post
아직 나가지 않은 것을 취소해요. 이미 게시된 글은 그대로 남고, 캘린더에서 되돌릴 수 있어요.
매개변수: post_id

웹사이트 통계

get_site_stats
내 사이트 하나의 방문자, 페이지뷰, 상위 유입 경로와 페이지, 매출. 숫자만 제공해요.
매개변수: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m
get_live_visitors
지금(최근 5분) 사이트에 있는 사람: 페이지와 유입 경로만, 신원은 없어요.
매개변수: site?

소셜 캘린더, 온라인

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT 또는 커스텀 커넥터를 지원하는 모든 앱.

캘린더

list_accounts
연결된 계정, 계정 세트, 서명, 곧 지원될 플랫폼.
list_posts
두 날짜 사이의 예약된 게시물과 게시된 게시물을 상태와 링크와 함께 보여줘요.
매개변수: from?, to?
schedule_post
계정이나 세트에 미래 시각으로 게시물을 예약해요. 플랫폼별 캡션도 넣을 수 있어요.
매개변수: text, at, accounts? | set?, captions?, signature?
post_now
바로 게시해요. 분명히 요청했을 때만, confirm: true가 필요해요.
매개변수: text, confirm, accounts? | set?, captions?, signature?
reschedule_post
아직 나가지 않은 게시물을 새 시각으로 옮겨요.
매개변수: post_id, at
cancel_post
아직 나가지 않은 것을 취소해요. 이미 게시된 글은 삭제되지 않아요.
매개변수: post_id
get_stats
7일, 30일, 90일 플랫폼별 통계: 게시물, 좋아요, 댓글, 공유, 방문자, 판매.
매개변수: days?: 7 | 30 | 90

개인정보 보호와 안전

어떤 도구도 키 입력, 입력한 텍스트, 클립보드를 읽지 않아요.
Mac 도구는 아무것도 업로드하지 않아요. 스크린샷과 녹화는 Mac에 남고, AI 앱에는 파일 경로(와 작은 미리보기)만 전달돼요.
Grab Text는 Mac에서 Apple Vision으로 읽고 텍스트만 돌려줘요. 저장되는 것도, 클립보드에 들어가는 것도 없어요.
“묻지 않고 스크린샷”을 켜지 않으면 스크린샷은 매번 물어봐요. 게시물용 이미지는 내가 허용한 뒤에만 읽어요.
지금 게시는 항상 Clacky에서 먼저 물어봐요. 예약 게시물은 알림이 표시되고 취소할 수 있어요.
소셜과 사이트 도구만 내 Clacky 로그인으로 clacky.app과 통신해요. AI는 토큰을 볼 수 없어요.
헬퍼는 내 사용자만 열 수 있는 비공개 로컬 소켓으로 앱과 통신해요.

질문

MCP가 뭐예요?

Model Context Protocol의 약자로, Claude, Cursor, Codex 같은 AI 앱이 도구를 호출할 수 있게 해 주는 개방형 표준이에요. Clacky의 MCP 서버는 AI에게 Mac의 도구를 제공해요.

따로 설치할 게 있나요?

아니요. 서버는 Clacky.app 안에 있어요. 설정 → AI 도구 연결 (MCP)을 켜고 스니펫 하나를 AI 앱에 붙여 넣으면 돼요.

Clacky가 실행 중이어야 하나요?

네. 헬퍼가 모든 호출을 열려 있는 Clacky 앱에 넘겨요. Clacky가 닫혀 있거나 스위치가 꺼져 있으면 AI는 분명하게 “사용할 수 없음”이라는 응답을 받아요.

AI가 제가 입력하는 내용을 읽을 수 있나요?

아니요. 어떤 도구도 키 입력, 입력한 텍스트, 클립보드를 읽지 않아요.

제 허락 없이 게시할 수 있나요?

지금 게시는 항상 Clacky에서 먼저 물어보고, 아니라고 하면 아무것도 나가지 않아요. 예약 게시물은 알림이 표시되고 취소할 수 있어요.

ChatGPT나 웹의 Claude에서도 되나요?

소셜 캘린더는 돼요. https://clacky.app/api/social/mcp를 커스텀 커넥터로 추가하고 로그인하세요. Mac 도구는 데스크톱 앱(Claude Desktop, Claude Code, Cursor, Codex)이 필요해요.