clacky
Volver a Clacky
Model Context Protocol · integrado en Clacky

Clacky MCP

MCP es la forma en que las apps de IA usan herramientas. Clacky lleva un servidor MCP integrado, así que Claude, Cursor o Codex pueden hacer una captura, leer texto de tu pantalla, grabar, avisarte cuando termina una tarea o programar una publicación, directamente en tu Mac.

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

Qué es

Integrado en la app

El servidor es un pequeño ayudante dentro de Clacky.app (Contents/MacOS/clacky-mcp). Sin Node, sin instalar nada más.

Apagado hasta que lo actives

En Clacky, abre Ajustes → Conectar herramientas de IA (MCP). Cada grupo de herramientas tiene su propio interruptor.

Tu Mac hace el trabajo

El ayudante pasa cada llamada a la app Clacky en ejecución, que te pregunta cuando corresponde y hace el trabajo.

Conecta tu app de IA

Dos minutos, una sola vez. Clacky muestra los mismos fragmentos en Ajustes, con la ruta a tu copia de la app.

Claude Desktop → Settings → Developer → Edit Config, y añade esto a claude_desktop_config.json:

{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }
  1. 1Guarda el archivo y reinicia Claude.
  2. 2Pregunta: «Haz una captura de esta ventana».

Todas las herramientas

27 herramientas en tres servidores. Nombres y parámetros exactamente como los ve tu IA.

En tu Mac

El ayudante clacky-mcp (stdio). Claude Desktop, Claude Code, Cursor, Codex.

Avisos
  • notify

    Reproduce el sonido de agente de Clacky y muestra una notificación, p. ej. cuando una tarea larga termina o te necesita.

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

Capturas, Grab Text y grabación
  • take_screenshot

    Captura la pantalla, un área o una ventana; devuelve la ruta del PNG y una vista previa pequeña. Puede preguntarte antes.

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

  • grab_text

    Lee el texto de un área de la pantalla o de una imagen/PDF con el reconocimiento de Apple en el dispositivo; devuelve solo texto.

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

  • start_recording

    Inicia el grabador de pantalla de Clacky (cuenta atrás de 3 segundos), con parada automática opcional. Se guarda en ~/Movies.

    Parámetros: seconds? (3–600)

  • stop_recording

    Detiene la grabación y devuelve la ruta del vídeo.

Mac Health
  • get_mac_health

    CPU, presión de memoria, espacio en disco, batería y temperatura. Sin nombres de apps ni procesos.

Notas y tareas
  • add_note

    Añade una nota a las Notas de Clacky.

    Parámetros: text

  • add_task

    Añade una tarea a la lista de hoy (o de mañana).

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

  • list_today_tasks

    Las tareas de hoy y cuáles están hechas.

Concentración y Keep Awake
  • start_focus

    Inicia el temporizador de concentración.

    Parámetros: minutes? (1–180)

  • stop_focus

    Detiene el temporizador de concentración.

  • keep_awake

    Mantiene el Mac y la pantalla despiertos (unos minutos o hasta que lo apagues), opcionalmente con la tapa cerrada.

    Parámetros: on, minutes?, lid_closed?

Modos
  • get_mode

    Qué modo está activo (Record, Code, Focus, Call, Quiet o el tuyo) y los modos disponibles.

  • set_mode

    Cambia a un modo, o “none” para dejarlo todo como estaba.

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

Publicaciones sociales (Calendario)
  • list_social_accounts

    Tus cuentas conectadas, conjuntos de cuentas, firmas y publicaciones que te quedan este mes.

  • schedule_post

    Programa una publicación (o la publica ya, después de que digas que sí en Clacky), con imagen y firma opcionales.

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

  • list_scheduled_posts

    Publicaciones entre dos fechas, con el estado y el enlace de cada plataforma.

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

  • cancel_scheduled_post

    Cancela lo que aún no ha salido. Las publicaciones ya publicadas se quedan; puedes deshacerlo en el Calendario.

    Parámetros: post_id

Estadísticas del sitio
  • get_site_stats

    Visitantes, páginas vistas, principales fuentes y páginas e ingresos de uno de tus sitios. Solo números.

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

  • get_live_visitors

    Quién está en tu sitio ahora mismo (últimos 5 minutos): páginas y fuentes, sin identidades.

    Parámetros: site?

Calendario social, en línea

https://clacky.app/api/social/mcp. Claude.ai, ChatGPT o cualquier app con conectores personalizados.

Calendario
  • list_accounts

    Cuentas conectadas, conjuntos de cuentas, firmas y plataformas que llegarán pronto.

  • list_posts

    Publicaciones programadas y publicadas entre dos fechas, con estado y enlaces.

    Parámetros: from?, to?

  • schedule_post

    Programa una publicación en cuentas o un conjunto a una hora futura, con textos por plataforma.

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

  • post_now

    Publica al instante. Solo cuando lo pediste claramente; requiere confirm: true.

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

  • reschedule_post

    Mueve una publicación que aún no ha salido a una nueva hora.

    Parámetros: post_id, at

  • cancel_post

    Cancela lo que aún no ha salido. Las publicaciones ya publicadas no se borran.

    Parámetros: post_id

  • get_stats

    Estadísticas por plataforma de 7, 30 o 90 días: publicaciones, me gusta, comentarios, compartidos, visitantes y ventas.

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

Privacidad y seguridad

  • Ninguna herramienta lee pulsaciones de teclas, texto escrito ni tu portapapeles.
  • Las herramientas del Mac nunca suben nada. Las capturas y grabaciones se quedan en tu Mac; a tu app de IA solo llega la ruta del archivo (y una vista previa pequeña).
  • Grab Text lee en tu Mac con Apple Vision y devuelve solo el texto: no se guarda nada ni se copia al portapapeles.
  • Las capturas preguntan cada vez, salvo que actives “Capturas sin preguntar”. Una imagen para una publicación solo se lee después de que lo permitas.
  • Publicar ahora siempre te pregunta antes en Clacky. Una publicación programada te muestra una notificación y se puede cancelar.
  • Solo las herramientas sociales y de sitio hablan con clacky.app, con tu propio inicio de sesión de Clacky. Tu IA nunca ve un token.
  • El ayudante habla con la app por un socket local privado que solo tu usuario puede abrir.

Preguntas

¿Qué es MCP?

El Model Context Protocol: un estándar abierto que permite a apps de IA como Claude, Cursor y Codex llamar a herramientas. El servidor MCP de Clacky les da las herramientas de tu Mac.

¿Tengo que instalar algo más?

No. El servidor está dentro de Clacky.app. Activa Ajustes → Conectar herramientas de IA (MCP) y pega un fragmento en tu app de IA.

¿Clacky tiene que estar abierto?

Sí. El ayudante pasa cada llamada a la app Clacky abierta. Si Clacky está cerrado o el interruptor apagado, la IA recibe un claro “no disponible”.

¿Puede mi IA leer lo que escribo?

No. Ninguna herramienta lee pulsaciones de teclas, texto escrito ni el portapapeles.

¿Puede publicar sin mí?

Publicar ahora siempre te pregunta antes en Clacky, y no sale nada si dices que no. Las publicaciones programadas te muestran una notificación y se pueden cancelar.

¿Funciona con ChatGPT o Claude en la web?

Para el calendario social, sí: añade https://clacky.app/api/social/mcp como conector personalizado e inicia sesión. Las herramientas del Mac necesitan una app de escritorio (Claude Desktop, Claude Code, Cursor, Codex).