Configurar NotiBuddy

NotiBuddy lleva solicitudes y avances de tu software conectado a tu iPhone o iPad. La configuración MCP de abajo conecta un asistente de IA compatible. Las apps, scripts y servicios también pueden conectarse directamente.

Consigue NotiBuddy para iPhone y iPad y enlázalo con el cliente notibuddy 0.4.0 para ordenador (incluye CLI y servidor MCP local en npm). Instalar el paquete no da acceso a ningún teléfono: cada remitente necesita una conexión aprobada.

Cada iPhone incluye un Apple Watch enlazado que comparte su cupo; las solicitudes guardadas son visibles en el Watch y la entrega directa al Watch requiere que esté habilitada en el servicio.

Qué necesitas para MCP

Conecta tu teléfono y tu ordenador

  1. Abre NotiBuddy, revisa las opciones de privacidad y permite la conexión, el envío de respuestas y las notificaciones.
  2. Abre Conectar → Añadir conexión (o Añadir). Pulsa Crear código de configuración → Compartir configuración (o elige Usar aprobación manual) y transfiere las instrucciones en privado por AirDrop o portapapeles.
  3. Mantén NotiBuddy abierto y ejecuta el comando de enlace. Incluye --to seguido de un alias local. Un código de un solo uso conecta automáticamente al primer remitente nuevo durante diez minutos. Si se solicita aprobación manual, compara el ID de clave completo en el Terminal y en tu iPhone.
  4. Añade NotiBuddy en los ajustes MCP de tu app de IA, envía una pregunta de prueba y respóndela desde el teléfono.

Comparte las instrucciones solo con remitentes de confianza. La configuración termina cuando tu IA recibe tu respuesta.

Después de configurarlo, puedes indicar a tu IA:

Usa NotiBuddy cuando necesites una decisión mía y comparte avances breves. Espera mi respuesta antes de ejecutar pasos críticos.

Tu IA debe recoger tu respuesta para continuar. NotiBuddy no despierta ordenadores en reposo ni reinicia sesiones finalizadas. Las solicitudes nuevas admiten respuesta durante tres horas por defecto. Consulta Ayuda y soporte.

Conecta una app o servicio

MCP es solo una opción. Cualquier app, script o servicio puede conectar directamente implementando el protocolo cifrado documentado. Importa un paquete nbpair válido, registra la identidad de firma del remitente y envía solicitudes cifradas y firmadas al dispositivo enlazado. Verifica siempre las respuestas con la clave de firma del teléfono.

El paquete notibuddy incluye un cliente TypeScript/JavaScript para Node.js 20+. Consulta el código y README y PROTOCOL.md.


Configuración técnica para tu asistente de IA

Las secciones siguientes están pensadas para un asistente que configure NotiBuddy por ti. También están disponibles como Markdown sin formato, en inglés.

1. Comprueba el cliente publicado

El paquete es notibuddy de Yourbit, LLC (también en Homebrew: brew install yourbit-network/tap/notibuddy). La versión 0.4.0 está disponible; los comandos npx usan ^0.4.0. Comprueba la instalación:

npx -y notibuddy@^0.4.0 --help

2. Comprueba el enlace

Ejecuta npx -y notibuddy@^0.4.0 status para ver los destinos guardados. Si el ordenador no está enlazado, pide al usuario que abra Conectar → Añadir conexión → Crear código de configuración → Compartir configuración y transfiera en privado el paquete nbpair1.. Configuración y claves viven en privado en ~/.notibuddy/. En estos ejemplos personal es un alias local (--to personal).

3. Registra el servidor MCP local

Añade un servidor MCP local stdio:

Para clientes con objeto mcpServers (si un mensaje anterior muestra 0.2.x o 0.3.x, cámbialo a notibuddy@^0.4.0):

{
  "notibuddy": {
    "command": "npx",
    "args": ["-y", "notibuddy@^0.4.0", "mcp", "--to", "personal"]
  }
}

Es un proceso MCP local. No configures la URL del servicio de retransmisión como servidor MCP remoto (notibuddy.com redirige a notibuddy.app; el servicio es https://notibuddy.app).

4. Completa la conexión

Mantén NotiBuddy abierto y conectado hasta confirmar el enlace. Después ejecuta npx -y notibuddy@^0.4.0 doctor --to personal para comprobar acceso, aprobación, protocolo y recepción de archivos. Para varios dispositivos, usa nombres distintos (--to personal, --to work) en ~/.notibuddy/destinations.

5. Verifica ambos sentidos

Recarga MCP y llama a notibuddy_notify:

{
  "title": "NotiBuddy connected",
  "message": "Tap OK to finish setup.",
  "options": ["OK"]
}

Si devuelve estado pendiente, llama de nuevo con requestId en resume_id. También puedes probar directamente en Terminal:

npx -y notibuddy@^0.4.0 notify "Connection check" --to personal --message "Reply OK to test both directions." --options "OK" --wait 55

Si queda pendiente, ejecuta npx -y notibuddy@^0.4.0 notify --resume REQUEST_ID --to personal --wait 55 antes del vencimiento original de tres horas.

Herramientas y respuestas

notibuddy_notify envía una notificación cifrada de extremo a extremo (unidireccional por defecto) y espera respuesta cuando se pasan opciones interactivas o resume_id.

ParámetroFunción
title, messageTítulo y contexto
screenPantalla nativa personalizada (templateId o template en línea con 12 bloques nativos); excluyente con message, options, fields, input_placeholder, diff y resume_id
optionsOpciones de respuesta (hace interactiva la solicitud)
decline_optionOpción de options que rechaza sin requerir autenticación
input_placeholderActiva una respuesta rápida de texto
fieldsFormulario en la app con text, email, url, toggle, stepper, picker, date o secret
diffRevisión de cambios (filename, language opcional, original, modified)
sensitiveOculta el contenido en pantalla bloqueada y Actividades en directo
requires_authExige Face ID o autenticación del dispositivo en la app
timeout_secondsPlazo de respuesta: 1–10.800 segundos (3 horas por defecto y máximo)
wait_secondsEspera por llamada: 25 s por defecto, máximo 55 s
resume_idConsulta una solicitud previa sin reenviarla

Para Pantallas personalizadas (0.4.0+), elige entre 8 diseños integrados o envía un template propio (o preregístralo con nb screen register <file> [--strict] y envíalo con nb notify --screen <json-file>). En Terminal, --timeout 10800 define la vigencia y --wait 55 el presupuesto de espera. Nunca interpretes un vencimiento, error o silencio como aprobación.

notibuddy_activity inicia, actualiza o termina un progreso o temporizador (poll recoge los controles del teléfono).

ParámetroFunción
idIdentificador estable de la actividad
actionstart, update, end o poll
title, statusEtiqueta breve y estado
step, total_stepsPasos de progreso
timer_minutesDuración de cuenta atrás
controlspause, resume, cancel o add_5m

Uso y privacidad

El plan Gratis permite cinco solicitudes cada 24 horas móviles. Las preguntas y el inicio de cada Actividad en directo cuentan en ese cupo; las actualizaciones, cierres y consultas de respuesta no consumen solicitudes extra. Las Actividades en directo están disponibles en Gratis y Pro. Límites de dispositivos: 1 iPhone/iPad en Gratis, hasta 3 en Pro Anual, hasta 12 en Pro de por vida (con 1 Apple Watch incluido por iPhone). Consulta planes, condiciones y privacidad.

Varios destinos y nombres de remitente

Usa --sender "Coding assistant" para describir el origen dentro del contenido cifrado (sin aislar permisos). Para exponer varios destinos en MCP usa --allow-to personal --allow-to work e incluye to en cada llamada; notibuddy_list_destinations lista solo los destinos expuestos.

Actualizar un destino existente

  1. Ejecuta npx -y notibuddy@^0.4.0 devices list y localiza el alias existente.
  2. En el mismo teléfono abre Conectar → Añadir y comparte una configuración manual nueva.
  3. Sustituye el nombre tras --to por el alias existente y omite --label.
  4. Compara el ID de clave completo si se solicita aprobación.
  5. Reinicia MCP y comprueba con npx -y notibuddy@^0.4.0 doctor --to personal.

Recibir un archivo desde tu teléfono

En el teléfono elige Conectar → conexión → Compartir archivo o Compartir → NotiBuddy (máximo 10 MB (10.000.000 bytes) por archivo). El ordenador debe recogerlo manualmente; no hay receptor automático en segundo plano:

npx -y notibuddy@^0.4.0 files list --to personal
npx -y notibuddy@^0.4.0 files receive FILE_ID_FROM_LIST --to personal

Con MCP usa notibuddy_files con action "list" y después "receive" con el id (sustituye FILE_ID_FROM_LIST por el ID devuelto; una etiqueta --sender no aísla el acceso a los archivos). El receptor guarda el archivo descifrado en ~/.notibuddy/inbox/ sin abrirlo. «Entregado» significa guardado, no leído por un agente. Si devuelve saved_pending_receipt, repite el comando con el mismo ID. Si doctor indica que falta recepción de archivos, sigue las instrucciones del cliente.