Configurer NotiBuddy
NotiBuddy transmet 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 restent visibles sur la Watch et la livraison directe nécessite qu’elle soit activée sur le service.
Prérequis pour MCP
- Un iPhone ou iPad sous iOS ou iPadOS 17+ avec NotiBuddy installé.
- Un assistant IA compatible avec 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 ultérieur sur l’ordinateur ou serveur de l’expéditeur. Les commandes ci-dessous utilisent
npx.
Connecter votre téléphone et votre ordinateur
- Ouvrez NotiBuddy, vérifiez les options 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. En cas d’approbation manuelle, comparez l’ID de clé complet dans le 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 lorsque tu as besoin d’une décision de ma part et partage de courtes étapes d’avancement. Attends ma réponse avant toute action critique.
Votre IA doit relever la réponse pour continuer. NotiBuddy ne réveille pas un ordinateur en veille et ne relance pas une session terminée. Les nouvelles demandes restent valables trois heures par défaut. Voir Aide et assistance.
Connecter une app ou un service
MCP n’est qu’une option. Toute app, tout script ou service peut se connecter directement via le 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 inclut 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 disponibles en Markdown brut, en anglais.
1. Vérifier le client publié
Le paquet est notibuddy, publié par Yourbit, LLC (également 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 enregistrées. 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 stockées en privé dans ~/.notibuddy/. Dans les 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. Finaliser 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 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 le 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 optionnel, 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 maximum) |
wait_seconds | Attente par appel : 25 s par défaut, 55 s 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>). En Terminal, --timeout 10800 fixe l’échéance et --wait 55 la durée 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 d’avancement |
timer_minutes | Durée du compte à rebours |
controls | pause, resume, cancel ou add_5m |
Usage et confidentialité
La formule Gratuit inclut cinq demandes par 24 heures glissantes. Les questions et le démarrage d’une Activité en direct comptent dans ce quota ; les mises à jour, fins d’activité et vérifications de réponse ne consomment pas de demande supplémentaire. Les Activités en direct fonctionnent sur Gratuit et Pro. Quotas d’appareils : 1 iPhone/iPad en Gratuit, jusqu’à 3 en Pro Annuel, jusqu’à 12 en Pro À vie (1 Apple Watch incluse par iPhone). Voir formules, 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 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.