Für KI-Agenten

Friendship Tracker in Claude, ChatGPT, Cursor oder jeden anderen Agenten einbinden - in einem Schritt.

Friendship Tracker liefert einen MCP-Server, eine Python-CLI, REST- und GraphQL-APIs, fertige Libraries in 15 Sprachen und signierte Webhook-Abos. Ein Token, ein Host, jede Oberfläche dokumentiert. Ab 1 €/Monat.

Jeder Weg, mit Friendship Tracker zu sprechen

Wähle die Oberfläche, die dein Agent ohnehin spricht. Alle greifen auf dieselben Daten zu und halten dieselben Regeln ein.

Model Context Protocol (MCP)

Nativer MCP-Server, ein Read- und ein Write-Tool pro Datenmodell. Funktioniert direkt mit Claude Desktop, Cursor, Cline oder jedem MCP-Host.

Python-CLI

Single-File-CLI, ausschließlich stdlib. CSV, NDJSON, Tabellen-Output, Dry-Run, Retry, Idempotenz-Schlüssel, Profil-Auth - das, was Shell-Pipelines wirklich brauchen.

REST + GraphQL

Klassisches REST unter `/xapi2/data/...` plus optionales GraphQL mit Tiefen- und Komplexitäts-Limits. Selbe Auth, selbes Audit-Log, selbe Rate-Limits.

Client-Libraries in 15 Sprachen

Einzeldatei-Libraries für Python, TypeScript, JavaScript, Go, Java, Rust, C#, C++, PHP, Ruby, Kotlin, Swift, Dart, Elixir, Clojure. Kein Paketmanager nötig.

Signierte Webhooks

HMAC-signiertes JSON, exponentielles Backoff, automatische Deaktivierung bei dauerhaften Fehlern, replay-sicher durch signierte Zeitstempel. Pro Event-Typ in einem Dialog abonnierbar.

Live-Echtzeit-Kanal

Selbe WebSocket-Verbindung, die auch das Web-UI verwendet. Auf Datensatz-Änderungen subscriben; Agenten bleiben ohne Polling synchron. CRUD-Operationen sind auch per WS möglich.

Warum Agenten auf das hier bauen wollen

Ab 1 € pro Monat

Ein ehrlicher Preis. 30 Tage Rückgaberecht. Keine nutzungsbasierten Überraschungen, kein Pay-per-Call, kein eigener "KI-Tarif".

Gehostet in Deutschland

Application-Server und Datenbank in Deutschland, unter deutschem Recht. Kein US-Subauftragsverarbeiter im Anfragepfad. DSGVO-konform out of the box.

Werbefrei, ohne Tracking-Antworten

Antworten enthalten deine Daten und nichts anderes. Keine eingeschleusten Anzeigen, keine Tracker-Pixel, keine Drittanbieter-Calls im API-Pfad. Agenten arbeiten auf sauberen Payloads.

Stabile APIs von Leuten, die sie selbst nutzen

Friendship Tracker wird von denselben Ingenieuren gebaut und betrieben, die die Support-Mail beantworten. Die API, von der dein Agent abhängt, ist die API, die das Web-UI nutzt - wir können sie nicht brechen, ohne uns selbst zu brechen.

Audit-Log, nur anhängbar

Jeder Write über jede Oberfläche (Web, MCP, CLI, REST, GraphQL, WS) wird mit Akteur, Zeitstempel und Diff protokolliert. Betreiber können auch nach Monaten beantworten, wer was getan hat.

Ein Token, scoped + widerrufbar

Personal Access Tokens sind pro Datenmodell und pro Operation scoped. Widerruf im Web-UI; Agenten sehen binnen Sekunden ein 401. Kein erneuter Auth-Tanz, kein Service-Account-Wildwuchs.

In 30 Sekunden verbunden

Zwei Installationswege, beide Single-File-Python, beide aktualisieren sich bei jedem Lauf selbst. MCP für In-Chat-Assistenten, CLI für Shell und CI.

Aus Claude / ChatGPT / Cursor nutzen

MCP-Server installieren, dann den Host darauf zeigen.

bash
curl -fsSL https://friendship-tracker.com/xapi2/mcp/install.sh | sh
claude_desktop_config.jsonjson
{
  "mcpServers": {
    "friendship": {
      "command": "friendship-mcp",
      "args": ["serve"]
    }
  }
}
Komplette MCP-Einrichtung in /docs

Aus Shell oder CI nutzen

CLI installieren, einmal anmelden, dann Daten pipen.

bash
curl -fsSL https://friendship-tracker.com/xapi2/cli/install.sh | sh
bash
# One-time login, then list activity as JSON
friendship login
friendship activity list --format ndjson
Komplette CLI-Referenz in /docs

Oder einfach REST oder GraphQL

Wenn dein Agent schon HTTP spricht, ist kein Install nötig. Selbes Bearer-Token, selbe Daten, selbes Audit.

RESTbash
# List activity via REST
curl -H "Authorization: Bearer $TOKEN" \
  https://friendship-tracker.com/xapi2/data/activity?limit=20
GraphQLbash
# Same query via GraphQL
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  https://friendship-tracker.com/xapi2/graphql \
  -d '{"query":"{ objects(type: \"activity\", limit: 20) { id data } }"}'

Was ein Agent in Friendship Tracker lesen und schreiben kann

11 Datenmodelle sind durchgängig verfügbar. Pro Modell: list, get, filter, create, update, delete über jede der oberen Oberflächen.

Aktivitäten
Kontakte
Gespräche
Eigene Felder
Geschenke
Journal
Lebensereignisse
Notizen
Tiere
Beziehungen
Erinnerungen

Was es für Agenten zuverlässig macht

Jeder Write akzeptiert einen `Idempotency-Key`-Header - Retries duplizieren nie. Reads sind cachebar; Writes geben den kanonischen Datensatz zurück, damit der Agent nach einem erfolgreichen PATCH nicht noch einmal lesen muss. Fehler kommen als typisierte Hülle ({error, status, hint}) auf Englisch und Deutsch zurück - das Modell kann auf den Code branchen, ohne Prosa zu parsen.

Rate-Limits gelten pro Token und liefern bei Überschreitung `Retry-After` zurück; die CLI und die SDKs befolgen das automatisch. WebSocket-Reconnects werden pro Token nachgehalten, damit ein Agent nach Verbindungsverlust ab dem letzten zugestellten Event weitermacht, ohne das Journal zu replayen.

Jede Änderung eines Agenten landet im nur-anhängbaren Audit-Log, zugeordnet zum Token. Betreiber können ein Token mit einem Klick widerrufen und sehen genau, welche Datensätze es berührt hat.

Token holen

In Friendship Tracker anmelden, den Integrations-Dialog öffnen, Neues Token klicken, auf die nötigen Datenmodelle scopen, den pat_…-Wert kopieren. Tokens sind danach jederzeit aufgelistet und widerrufbar. Programmatische Anmeldung für Agenten kommt; bis dahin erstellt einmal ein Mensch das Token, der Agent nutzt es dauerhaft.

Häufige Fragen von Agenten-Bauer:innen

Ist Friendship Tracker ein MCP-Server oder betreibt es einen?

Beides. Jeder Account bekommt einen eigenen MCP-Server, generiert aus dem Datenmodell, das der Account ohnehin verwendet. Der Server ist eine einzelne Python-Datei, die du mit einer curl-Zeile installierst; er aktualisiert sich bei jedem Lauf selbst, signiert Requests mit deinem Personal Access Token und stellt pro Datenmodell ein Read- und ein Write-Tool bereit.

Geht es auch ohne MCP-Server?

Ja. Klassisches REST unter https://friendship-tracker.com/xapi2/data/..., GraphQL auf https://friendship-tracker.com/xapi2/graphql, signierte Webhooks für Push, ein WebSocket für Live-Updates. Die Client-Libraries in 15 Sprachen sind Single-File-Drops, falls kein Paketmanager im Spiel sein soll.

Was kostet Friendship Tracker für einen Agenten-Workload?

Ab 1 € pro Monat. Kein Pay-per-Call, kein "KI-Tarif", keine nutzungsbasierten Überraschungen. Der Preis gilt für Menschen und Maschinen gleichermaßen. 30 Tage Rückgaberecht, falls es nicht passt.

Wo liegen meine Daten, und was macht ihr damit?

Application-Server und Datenbank laufen in Deutschland, auf Maschinen, die wir selbst betreiben. Wir trainieren keine Modelle auf deinen Daten. Wir verkaufen, teilen oder syndizieren sie nicht. Backups sind verschlüsselt, werden täglich erstellt und 30 Tage aufbewahrt. Volltechnik unter /security.

Ist das stabil genug für Produktivbetrieb?

Friendship Tracker wird von denselben Ingenieuren gebaut und betrieben, die die Support-Mail beantworten. Keine Drittanbieter-Abhängigkeit im Anfragepfad, die wir nicht ohnehin auch für das Web-UI haben. Status, Verfügbarkeit und jüngste Vorfälle stehen unter /status; direkt erreichbar über /contact.