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
- Un iPhone ou iPad sous iOS ou iPadOS 17+ avec NotiBuddy installé.
- Un assistant IA prenant en charge les serveurs MCP locaux.
- Une connexion Internet sur les deux appareils et un ordinateur qui reste éveillé pendant le travail de votre IA.
- Node.js 20 ou plus récent sur l’ordinateur ou le serveur de l’expéditeur. Les commandes ci-dessous utilisent
npx.
Connecter votre téléphone et votre ordinateur
- Ouvrez NotiBuddy, vérifiez les choix de confidentialité et autorisez la connexion, le partage des réponses et les notifications.
- 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.
- Gardez NotiBuddy ouvert et exécutez la commande de jumelage. Elle inclut
--tosuivi 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. - 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 :
- Commande :
npx - Arguments :
["-y", "notibuddy@^0.4.0", "mcp", "--to", "personal"] - Configuration de jumelage : lue automatiquement depuis
~/.notibuddy/.
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ètre | Rôle |
|---|---|
title, message | Titre 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 |
options | Choix de réponse (rend la demande interactive) |
decline_option | Option de options refusant sans authentification |
input_placeholder | Active une réponse texte rapide |
fields | Formulaire natif avec text, email, url, toggle, stepper, picker, date ou secret |
diff | Revue de modifications (filename, language facultatif, original, modified) |
sensitive | Masque le contenu sur l’écran verrouillé et les Activités en direct |
requires_auth | Exige Face ID ou l’authentification locale dans l’app |
timeout_seconds | Durée de validité : 1 à 10 800 s (3 heures par défaut et au maximum) |
wait_seconds | Attente par appel : 25 s par défaut, 55 s au maximum |
resume_id | Vé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ètre | Rôle |
|---|---|
id | Identifiant stable de l’activité |
action | start, update, end ou poll |
title, status | Titre court et statut |
step, total_steps | Étapes de progression |
timer_minutes | Durée du compte à rebours |
controls | pause, 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
- Exécutez
npx -y notibuddy@^0.4.0 devices listpour retrouver l’alias existant. - Sur le même téléphone, ouvrez Connecter → Ajouter et partagez une nouvelle configuration manuelle.
- Remplacez le nom après
--topar l’alias existant et omettez--label. - Comparez l’ID de clé complet si une approbation est demandée.
- 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.