Configurer NotiBuddy

NotiBuddy achemine les demandes et progressions de vos logiciels connectés vers votre iPhone ou iPad. La configuration MCP ci-dessous relie un assistant IA compatible. Les apps, scripts et services peuvent aussi se connecter directement.

Obtenir NotiBuddy pour iPhone et iPad, puis jumelez l’app avec le client ordinateur notibuddy 0.4.0 (CLI et serveur MCP local sur npm). Installer le paquet seul n’accorde aucun accès : chaque expéditeur exige une connexion approuvée.

Une Apple Watch jumelée par iPhone est incluse et partage son quota; les demandes enregistrées demeurent consultables sur la Watch et la livraison directe exige qu’elle soit activée sur le service.

Ce qu’il faut pour MCP

Connecter votre téléphone et votre ordinateur

  1. Ouvrez NotiBuddy, vérifiez les choix de confidentialité et autorisez la connexion, le partage des réponses et les notifications.
  2. Ouvrez Connecter → Ajouter une connexion (ou Ajouter). Touchez Créer un code de configuration → Partager la configuration (ou Utiliser l’approbation manuelle) et transférez les instructions en privé par AirDrop ou presse-papiers.
  3. Gardez NotiBuddy ouvert et exécutez la commande de jumelage. Elle inclut --to suivi d’un alias local. Un code à usage unique connecte automatiquement le premier nouvel expéditeur pendant dix minutes. Si une approbation manuelle est demandée, comparez l’ID de clé complet dans Terminal et sur votre iPhone.
  4. Ajoutez NotiBuddy dans les réglages MCP de votre app d’IA, envoyez une question test et répondez depuis votre téléphone.

Partagez ces instructions uniquement avec des expéditeurs de confiance. La configuration est terminée dès que votre IA reçoit votre réponse.

Une fois connecté, vous pouvez indiquer à votre IA :

Utilise NotiBuddy quand tu as besoin d’une décision de ma part et partage de courtes étapes de progression. Attends ma réponse avant toute action critique.

Votre IA doit récupérer votre réponse pour poursuivre. NotiBuddy ne réveille pas un ordinateur en veille et ne redémarre pas une session terminée. Les nouvelles demandes demeurent valides trois heures par défaut. Consultez Aide et soutien.

Connecter une app ou un service

MCP n’est qu’une option. Toute app, tout script ou service peut se connecter directement grâce au protocole chiffré documenté. Importez un paquet nbpair valide, enregistrez l’identité de signature et envoyez des demandes chiffrées et signées vers l’appareil jumelé. Vérifiez toujours les réponses avec la clé de signature du téléphone.

Le paquet notibuddy comprend un client TypeScript/JavaScript pour Node.js 20+. Consultez le code source et README et PROTOCOL.md.


Configuration technique pour votre assistant IA

Les sections ci-dessous sont destinées à un assistant configurant NotiBuddy pour vous. Elles sont aussi offertes en Markdown brut, en anglais.

1. Vérifier le client publié

Le paquet est notibuddy, publié par Yourbit, LLC (aussi sur Homebrew : brew install yourbit-network/tap/notibuddy). La version 0.4.0 est disponible; les commandes npx utilisent ^0.4.0. Vérifiez l’installation :

npx -y notibuddy@^0.4.0 --help

2. Vérifier le jumelage

Exécutez npx -y notibuddy@^0.4.0 status pour inspecter les destinations locales. Si l’ordinateur n’est pas jumelé, invitez l’utilisateur à ouvrir Connecter → Ajouter une connexion → Créer un code de configuration → Partager la configuration et à transférer en privé le paquet nbpair1.. Configuration et clés sont conservées en privé dans ~/.notibuddy/. Dans ces exemples, personal est un alias local (--to personal).

3. Enregistrer le serveur MCP local

Ajoutez un serveur MCP local stdio :

Pour les clients utilisant mcpServers (si un ancien message mentionne 0.2.x ou 0.3.x, remplacez par notibuddy@^0.4.0) :

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

Il s’agit d’un processus MCP local. Ne configurez pas l’URL du relais comme serveur MCP distant (notibuddy.com redirige vers notibuddy.app; le relais est https://notibuddy.app).

4. Terminer la connexion

Gardez NotiBuddy ouvert et en ligne jusqu’à confirmation. Vérifiez ensuite avec npx -y notibuddy@^0.4.0 doctor --to personal l’accès au relais, l’approbation, le protocole et la réception de fichiers. Pour plusieurs appareils, utilisez des alias distincts (--to personal, --to work) dans ~/.notibuddy/destinations.

5. Vérifier dans les deux sens

Rechargez MCP puis appelez notibuddy_notify :

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

Si la réponse est en attente, rappelez l’outil avec requestId dans resume_id. Vous pouvez aussi tester depuis Terminal :

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

En cas d’attente, lancez npx -y notibuddy@^0.4.0 notify --resume REQUEST_ID --to personal --wait 55 avant l’échéance de trois heures.

Outils et réponses

notibuddy_notify envoie une notification chiffrée de bout en bout (unidirectionnelle par défaut) et attend une réponse signée lorsque des options interactives ou resume_id sont fournis.

ParamètreRôle
title, messageTitre et contexte
screenÉcran natif personnalisé (templateId ou template en ligne composé de 12 blocs natifs); exclusif avec message, options, fields, input_placeholder, diff et resume_id
optionsChoix de réponse (rend la demande interactive)
decline_optionOption de options refusant sans authentification
input_placeholderActive une réponse texte rapide
fieldsFormulaire natif avec text, email, url, toggle, stepper, picker, date ou secret
diffRevue de modifications (filename, language facultatif, original, modified)
sensitiveMasque le contenu sur l’écran verrouillé et les Activités en direct
requires_authExige Face ID ou l’authentification locale dans l’app
timeout_secondsDurée de validité : 1 à 10 800 s (3 heures par défaut et au maximum)
wait_secondsAttente par appel : 25 s par défaut, 55 s au maximum
resume_idVérifie une demande en cours sans nouvel envoi

Pour les Écrans personnalisés (0.4.0+), choisissez parmi 8 modèles intégrés ou envoyez un template personnalisé (ou pré-enregistrez-le via nb screen register <file> [--strict] puis nb notify --screen <json-file>). Dans Terminal, --timeout 10800 fixe l’échéance et --wait 55 le budget d’attente. N’interprétez jamais une expiration, une erreur ou un silence comme une approbation.

notibuddy_activity démarre, met à jour ou termine une progression ou un minuteur (poll lit les commandes envoyées par le téléphone).

ParamètreRôle
idIdentifiant stable de l’activité
actionstart, update, end ou poll
title, statusTitre court et statut
step, total_stepsÉtapes de progression
timer_minutesDurée du compte à rebours
controlspause, resume, cancel ou add_5m

Utilisation et confidentialité

Le forfait Gratuit comprend cinq demandes par période mobile de 24 heures. Les questions et le démarrage d’une Activité en direct comptent dans cette limite; les mises à jour, fins d’activité et vérifications de réponse n’utilisent pas de demandes supplémentaires. Les Activités en direct fonctionnent sur Gratuit et Pro. Limites d’appareils : 1 iPhone/iPad sur Gratuit, jusqu’à 3 sur Pro Annuel, jusqu’à 12 sur Pro À vie (1 Apple Watch incluse par iPhone). Voir forfaits, conditions et confidentialité.

Destinations multiples et libellés d’expéditeur

Utilisez --sender "Coding assistant" pour décrire la source dans le contenu chiffré (sans isoler les permissions). Pour exposer plusieurs destinations en MCP, utilisez --allow-to personal --allow-to work et précisez to à chaque appel; notibuddy_list_destinations liste uniquement les destinations exposées.

Mettre à jour une destination existante

  1. Exécutez npx -y notibuddy@^0.4.0 devices list pour retrouver l’alias existant.
  2. Sur le même téléphone, ouvrez Connecter → Ajouter et partagez une nouvelle configuration manuelle.
  3. Remplacez le nom après --to par l’alias existant et omettez --label.
  4. Comparez l’ID de clé complet si une approbation est demandée.
  5. Redémarrez MCP et vérifiez avec npx -y notibuddy@^0.4.0 doctor --to personal.

Recevoir un fichier depuis votre téléphone

Sur le téléphone, choisissez Connecter → connexion → Partager un fichier ou Partager → NotiBuddy (limite de 10 Mo (10 000 000 octets) par fichier). L’ordinateur doit récupérer le fichier manuellement; aucun collecteur automatique en arrière-plan n’existe :

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

Avec MCP, appelez notibuddy_files avec action "list", puis "receive" avec l’id (remplacez FILE_ID_FROM_LIST par l’ID retourné; un libellé --sender n’isole pas l’accès aux fichiers). Le client vérifie, déchiffre et enregistre le fichier dans ~/.notibuddy/inbox/ sans jamais l’ouvrir. « Livré » signifie enregistré, pas lu par un agent. En cas de saved_pending_receipt, relancez la commande avec le même ID. Si doctor signale l’absence de réception de fichiers, suivez les instructions du client.