NotiBuddy einrichten
NotiBuddy bringt Anfragen und Fortschritte von verbundener Software auf dein iPhone oder iPad. Die folgende MCP-Einrichtung verbindet einen kompatiblen KI-Assistenten. Apps, Skripte und Dienste können sich auch direkt verbinden.
Hol dir die NotiBuddy-App für iPhone und iPad und kopple sie mit dem notibuddy 0.4.0 Computer-Client (enthält die CLI und den lokalen MCP-Server auf npm). Die Installation allein gewährt keinen Zugriff auf ein Telefon — jeder Absender benötigt eine genehmigte Verbindung.
Pro iPhone ist eine gekoppelte Apple Watch enthalten, die das Kontingent dieses iPhones teilt; gespeicherte Anfragen sind auf der Watch sichtbar, und direkte Watch-Zustellung erfordert, dass sie im Dienst aktiviert ist.
Voraussetzungen für MCP
- Ein iPhone oder iPad mit iOS oder iPadOS 17+ und installierter NotiBuddy-App.
- Ein KI-Assistent mit Unterstützung für lokale MCP-Server.
- Internetverbindung auf beiden Geräten sowie ein Computer, der wach bleibt, während deine KI arbeitet.
- Node.js 20 oder neuer auf dem Computer oder Server des Absenders. Die folgenden Befehle nutzen
npx.
Telefon und Computer verbinden
- Öffne NotiBuddy, prüfe die Datenschutzeinstellungen und erlaube Verbindung, Antwort-Teilen sowie Mitteilungen.
- Öffne Verbinden → Verbindung hinzufügen (oder Hinzufügen). Tippe auf Einrichtungscode erstellen → Einrichtung teilen (oder wähle Stattdessen manuell genehmigen) und übertrage die Anleitung privat per AirDrop oder Zwischenablage.
- Lass NotiBuddy geöffnet und führe den Kopplungsbefehl aus. Er enthält
--togefolgt von einem lokalen Zielnamen. Ein Einmal-Code verbindet den ersten berechtigten neuen Absender innerhalb von zehn Minuten automatisch. Bei manueller Freigabe vergleiche die vollständige Absenderschlüssel-ID im Terminal und auf dem iPhone. - Füge NotiBuddy in den MCP-Einstellungen deiner KI-App hinzu, sende eine Testfrage und beantworte sie auf dem Telefon.
Teile Einrichtungsanleitungen nur mit vertrauenswürdigen Absendern. Die Einrichtung ist abgeschlossen, sobald deine KI deine Antwort empfängt.
Nach der Einrichtung kannst du deiner KI sagen:
Nutze NotiBuddy, wenn du eine Entscheidung von mir brauchst, und sende kurze Fortschritte. Warte vor kritischen Schritten auf meine Antwort.
Deine KI muss die Antwort aktiv abholen. NotiBuddy weckt keinen Computer im Ruhezustand und startet keine beendeten Sitzungen neu. Neue Anfragen bleiben standardmäßig drei Stunden beantwortbar. Siehe Hilfe & Support.
App oder Dienst direkt verbinden
MCP ist nur eine Option. Jede App, jedes Skript und jeder Dienst kann das dokumentierte Kopplungs- und Verschlüsselungsprotokoll direkt umsetzen. Importiere ein gültiges nbpair-Dokument, registriere die Signaturidentität des Absenders und sende verschlüsselte, signierte Anfragen an das gekoppelte Gerät. Prüfe Antworten immer gegen den angepinnten Signaturschlüssel des Telefons.
Das Paket notibuddy enthält einen TypeScript/JavaScript-Client für Node.js 20+. Siehe Quellcode und README sowie PROTOCOL.md.
Technische Einrichtung für deinen KI-Assistenten
Die folgenden Abschnitte richten sich an einen Assistenten, der NotiBuddy für dich einrichtet. Sie sind auch als reines Markdown (Englisch) verfügbar.
1. Veröffentlichten Client prüfen
Das Paket heißt notibuddy von Yourbit, LLC (auch über Homebrew: brew install yourbit-network/tap/notibuddy). Version 0.4.0 ist verfügbar; die npx-Befehle nutzen ^0.4.0. Prüfe die Installation:
npx -y notibuddy@^0.4.0 --help
2. Kopplung prüfen
Führe npx -y notibuddy@^0.4.0 status aus, um gespeicherte lokale Ziele anzuzeigen. Ist der Computer noch nicht gekoppelt, lasse den Nutzer in der App Verbinden → Verbindung hinzufügen → Einrichtungscode erstellen → Einrichtung teilen öffnen und das nbpair1.-Paket privat übertragen. Konfiguration und Schlüssel liegen privat unter ~/.notibuddy/. In den Beispielen ist personal ein lokaler Alias (gewählt mit --to personal).
3. Lokalen MCP-Server registrieren
Füge einen lokalen stdio-MCP-Server hinzu:
- Befehl:
npx - Argumente:
["-y", "notibuddy@^0.4.0", "mcp", "--to", "personal"] - Kopplungskonfiguration: automatisch aus
~/.notibuddy/geladen.
Für Clients mit mcpServers-Objekt (falls ein älterer Hinweis 0.2.x oder 0.3.x nennt, ändere ihn auf notibuddy@^0.4.0):
{
"notibuddy": {
"command": "npx",
"args": ["-y", "notibuddy@^0.4.0", "mcp", "--to", "personal"]
}
}
Dies ist ein lokaler MCP-Prozess. Konfiguriere die Relay-URL nicht als Remote-MCP-Server (notibuddy.com leitet auf notibuddy.app weiter; der gebrandete Endpunkt ist https://notibuddy.app).
4. Verbindung abschließen
Halte NotiBuddy geöffnet und online, bis die Verbindung bestätigt ist. Prüfe anschließend mit npx -y notibuddy@^0.4.0 doctor --to personal Relay-Zugriff, Freigabe, Protokoll und Dateiempfang. Für mehrere Geräte kopple jedes mit eigenem Namen (--to personal, --to work) unter ~/.notibuddy/destinations.
5. Beide Richtungen prüfen
Lade die MCP-Konfiguration neu und rufe notibuddy_notify auf:
{
"title": "NotiBuddy connected",
"message": "Tap OK to finish setup.",
"options": ["OK"]
}
Bei offenem Status rufe das Tool erneut mit der zurückgegebenen requestId als resume_id auf. Du kannst auch direkt im Terminal testen:
npx -y notibuddy@^0.4.0 notify "Connection check" --to personal --message "Reply OK to test both directions." --options "OK" --wait 55
Bei einer offenen ID nutze npx -y notibuddy@^0.4.0 notify --resume REQUEST_ID --to personal --wait 55 innerhalb der dreistündigen Frist.
Tools und Antworten
notibuddy_notify sendet eine Ende-zu-Ende-verschlüsselte Mitteilung (standardmäßig einseitig) und wartet bei interaktiven Optionen oder resume_id auf eine signierte Antwort.
| Parameter | Zweck |
|---|---|
title, message | Titel und Kontext |
screen | Eigener nativer Screen (templateId oder inline template aus 12 nativen Blöcken); exklusiv zu message, options, fields, input_placeholder, diff und resume_id |
options | Antwortoptionen (macht die Anfrage interaktiv) |
decline_option | Option aus options, die ohne Authentifizierung ablehnt |
input_placeholder | Aktiviert schnelle Textantworten |
fields | In-App-Formular mit text, email, url, toggle, stepper, picker, date oder secret |
diff | Code-/Textvergleich (filename, optional language, original, modified) |
sensitive | Verbirgt Inhalte auf Sperrbildschirm und Live-Aktivitäten |
requires_auth | Erfordert Face ID / Geräteauthentifizierung in der App |
timeout_seconds | Antwortfrist: 1–10.800 Sekunden (Standard und Maximum 3 Stunden) |
wait_seconds | Wartezeit pro Aufruf: Standard 25 s, Maximum 55 s |
resume_id | Prüft eine laufende Anfrage ohne neuen Versand |
Für Eigene Screens (0.4.0+) wähle aus 8 fertigen Layouts oder sende ein eigenes template (oder registriere es vorab mit nb screen register <file> [--strict] und sende per nb notify --screen <json-file>). Im Terminal setzt --timeout 10800 die Frist und --wait 55 das Aufruf-Budget. Interpretiere Zeitüberschreitung, Fehler oder fehlende Antwort niemals als Freigabe.
notibuddy_activity startet, aktualisiert oder beendet Fortschrittsanzeigen oder Timer (poll liest Steuerbefehle vom Telefon).
| Parameter | Zweck |
|---|---|
id | Stabile Kennung der Aktivität |
action | start, update, end oder poll |
title, status | Kurzer Titel und Status |
step, total_steps | Fortschrittsschritte |
timer_minutes | Countdown-Dauer |
controls | pause, resume, cancel oder add_5m |
Nutzung und Datenschutz
Kostenlos erlaubt fünf Anfragen in gleitenden 24 Stunden. Fragen und der Start einer Live-Aktivität zählen zum Kontingent; Aktualisierungen, das Beenden von Aktivitäten und Antwortabfragen verbrauchen keine zusätzlichen Anfragen. Live-Aktivitäten funktionieren in Kostenlos und Pro. Gerätegrenzen: 1 iPhone/iPad in Kostenlos, bis zu 3 in Pro Jährlich, bis zu 12 in Pro Lebenslang (je 1 Apple Watch pro iPhone inklusive). Siehe Tarife, Nutzungsbedingungen und Datenschutz.
Mehrere Ziele und Absendernamen
Nutze --sender "Coding assistant", um die Quelle innerhalb des verschlüsselten Inhalts zu benennen (ohne eigene Berechtigungsgrenze). Für mehrere MCP-Ziele nutze --allow-to personal --allow-to work und gib to bei jedem Aufruf an; notibuddy_list_destinations zeigt nur freigegebene Ziele.
Bestehendes Ziel aktualisieren
- Führe
npx -y notibuddy@^0.4.0 devices listaus und finde den bestehenden Zielnamen. - Öffne auf demselben Telefon Verbinden → Hinzufügen und teile eine neue manuelle Einrichtung.
- Ersetze den Namen nach
--todurch den bestehenden Zielnamen und lass--labelweg. - Vergleiche bei Bedarf die vollständige Absenderschlüssel-ID und bestätige.
- Starte den MCP-Server neu und prüfe mit
npx -y notibuddy@^0.4.0 doctor --to personal.
Datei vom Telefon empfangen
Wähle auf dem Telefon Verbinden → Verbindung → Datei teilen oder Teilen → NotiBuddy (maximal 10 MB (10.000.000 Byte) pro Datei). Der Computer holt Dateien manuell ab; es gibt keinen automatischen Hintergrundempfänger:
npx -y notibuddy@^0.4.0 files list --to personal
npx -y notibuddy@^0.4.0 files receive FILE_ID_FROM_LIST --to personal
In MCP nutze notibuddy_files mit action "list" und anschließend "receive" mit der id (ersetze FILE_ID_FROM_LIST durch die zurückgegebene ID; ein --sender-Label trennt den Dateizugriff nicht). Dateien werden nach Prüfung und Entschlüsselung unter ~/.notibuddy/inbox/ gespeichert, niemals automatisch geöffnet. „Zugestellt“ heißt gespeichert, nicht von einem Agenten gelesen. Bei saved_pending_receipt wiederhole den Empfangsbefehl mit derselben ID. Falls doctor fehlenden Dateiempfang meldet, folge der Client-Anleitung.