clacky
Voltar ao Clacky
Model Context Protocol · integrado ao Clacky

Clacky MCP

MCP é como os apps de IA usam ferramentas. O Clacky tem um servidor MCP integrado, então Claude, Cursor ou Codex podem tirar uma captura de tela, ler o texto da sua tela, gravar, avisar você quando uma tarefa terminar ou agendar um post, direto no seu Mac.

claude mcp add --scope user clacky -- /Applications/Clacky.app/Contents/MacOS/clacky-mcp

O que é

Integrado ao app

O servidor é um pequeno ajudante dentro do Clacky.app (Contents/MacOS/clacky-mcp). Sem Node, sem instalar mais nada.

Desligado até você ligar

No Clacky, abra Ajustes → Conectar ferramentas de IA (MCP). Cada grupo de ferramentas tem seu próprio interruptor.

Seu Mac faz o trabalho

O ajudante repassa cada chamada ao app Clacky em execução, que pergunta a você quando deve e faz o trabalho.

Conecte seu app de IA

Dois minutos, uma única vez. O Clacky mostra os mesmos trechos em Ajustes, com o caminho da sua cópia do app.

Claude Desktop → Settings → Developer → Edit Config, e adicione isto ao claude_desktop_config.json:

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1Salve o arquivo e reinicie o Claude.
  2. 2Peça: “Tire uma captura de tela desta janela.”

Todas as ferramentas

27 ferramentas em três servidores. Nomes e parâmetros exatamente como sua IA os vê.

No seu Mac

O ajudante clacky-mcp (stdio). Claude Desktop, Claude Code, Cursor, Codex.

Alertas
  • notify

    Toca o som de agente do Clacky e mostra uma notificação, p. ex. quando uma tarefa longa termina ou precisa de você.

    Parâmetros: title, message?, sound?: done | needs | error

Capturas de tela, Grab Text e gravação
  • take_screenshot

    Captura a tela, uma área ou uma janela; devolve o caminho do PNG e uma pequena prévia. Pode perguntar antes.

    Parâmetros: target?: screen | area | window

  • grab_text

    Lê o texto de uma área da tela ou de uma imagem/PDF com o reconhecimento da Apple no próprio dispositivo; devolve só texto.

    Parâmetros: source?: area | file, path?, languages?

  • start_recording

    Inicia o gravador de tela do Clacky (contagem de 3 segundos), com parada automática opcional. Salvo em ~/Movies.

    Parâmetros: seconds? (3–600)

  • stop_recording

    Para a gravação e devolve o caminho do vídeo.

Mac Health
  • get_mac_health

    CPU, pressão de memória, espaço em disco, bateria e temperatura. Sem nomes de apps ou processos.

Notas e tarefas
  • add_note

    Adiciona uma nota às Notas do Clacky.

    Parâmetros: text

  • add_task

    Adiciona uma tarefa à lista de hoje (ou de amanhã).

    Parâmetros: text, day?: today | tomorrow

  • list_today_tasks

    As tarefas de hoje e quais já foram feitas.

Foco e Keep Awake
  • start_focus

    Inicia o timer de foco.

    Parâmetros: minutes? (1–180)

  • stop_focus

    Para o timer de foco.

  • keep_awake

    Mantém o Mac e a tela acordados (por alguns minutos ou até desligar), opcionalmente com a tampa fechada.

    Parâmetros: on, minutes?, lid_closed?

Modos
  • get_mode

    Qual modo está ativo (Record, Code, Focus, Call, Quiet ou o seu) e os modos disponíveis.

  • set_mode

    Muda para um modo, ou “none” para deixar tudo como estava.

    Parâmetros: mode (id, name or "none")

Posts sociais (Calendário)
  • list_social_accounts

    Suas contas conectadas, conjuntos de contas, assinaturas e posts restantes neste mês.

  • schedule_post

    Agenda um post (ou publica agora, depois que você disser sim no Clacky), com imagem e assinatura opcionais.

    Parâmetros: text, at, accounts? | set?, captions?, image_path?, signature?

  • list_scheduled_posts

    Posts entre duas datas, com o status e o link de cada plataforma.

    Parâmetros: from?, to?, include_posted?

  • cancel_scheduled_post

    Cancela o que ainda não saiu. Posts já publicados continuam no ar; você pode desfazer no Calendário.

    Parâmetros: post_id

Estatísticas do site
  • get_site_stats

    Visitantes, visualizações de página, principais origens e páginas e receita de um dos seus sites. Só números.

    Parâmetros: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m

  • get_live_visitors

    Quem está no seu site agora (últimos 5 minutos): páginas e origens, sem identidades.

    Parâmetros: site?

Calendário social, online

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT ou qualquer app com conectores personalizados.

Calendário
  • list_accounts

    Contas conectadas, conjuntos de contas, assinaturas e plataformas que ainda estão por vir.

  • list_posts

    Posts agendados e publicados entre duas datas, com status e links.

    Parâmetros: from?, to?

  • schedule_post

    Agenda um post para contas ou um conjunto em um horário futuro, com legendas por plataforma.

    Parâmetros: text, at, accounts? | set?, captions?, signature?

  • post_now

    Publica na hora. Só quando você pediu claramente; exige confirm: true.

    Parâmetros: text, confirm, accounts? | set?, captions?, signature?

  • reschedule_post

    Move um post que ainda não saiu para um novo horário.

    Parâmetros: post_id, at

  • cancel_post

    Cancela o que ainda não saiu. Posts já publicados não são apagados.

    Parâmetros: post_id

  • get_stats

    Estatísticas por plataforma de 7, 30 ou 90 dias: posts, curtidas, comentários, compartilhamentos, visitantes e vendas.

    Parâmetros: days?: 7 | 30 | 90

Privacidade e segurança

  • Nenhuma ferramenta lê teclas digitadas, texto digitado nem sua área de transferência.
  • As ferramentas do Mac nunca enviam nada. Capturas e gravações ficam no seu Mac; só o caminho do arquivo (e uma pequena prévia) vai para o seu app de IA.
  • O Grab Text lê no seu Mac com o Apple Vision e devolve só o texto: nada é salvo, nada vai para a área de transferência.
  • As capturas de tela perguntam toda vez, a menos que você ligue “Capturas sem perguntar”. Uma imagem para um post só é lida depois que você permitir.
  • Publicar agora sempre pergunta a você no Clacky primeiro. Um post agendado mostra uma notificação e pode ser cancelado.
  • Só as ferramentas sociais e de site falam com o clacky.app, com o seu próprio login do Clacky. Sua IA nunca vê um token.
  • O ajudante fala com o app por um socket local privado que só o seu usuário pode abrir.

Perguntas

O que é MCP?

O Model Context Protocol: um padrão aberto que permite que apps de IA como Claude, Cursor e Codex chamem ferramentas. O servidor MCP do Clacky dá a eles as ferramentas do seu Mac.

Preciso instalar mais alguma coisa?

Não. O servidor está dentro do Clacky.app. Ligue Ajustes → Conectar ferramentas de IA (MCP) e cole um trecho no seu app de IA.

O Clacky precisa estar aberto?

Sim. O ajudante repassa cada chamada ao app Clacky aberto. Se o Clacky estiver fechado ou o interruptor desligado, a IA recebe um claro “indisponível”.

Minha IA consegue ler o que eu digito?

Não. Nenhuma ferramenta lê teclas digitadas, texto digitado nem a área de transferência.

Ela consegue postar sem mim?

Publicar agora sempre pergunta a você no Clacky primeiro, e nada sai se você disser não. Posts agendados mostram uma notificação e podem ser cancelados.

Funciona com o ChatGPT ou o Claude na web?

Para o calendário social, sim: adicione https://clacky.app/api/social/mcp como conector personalizado e entre. As ferramentas do Mac precisam de um app de desktop (Claude Desktop, Claude Code, Cursor, Codex).