Docs-Menü

Tulimoa Memory verbinden

Leg im Dashboard ein Gedächtnis an und lade es per Karte auf, oder lass einen Agent selbst mit USDC zahlen. Dann verbindest du deinen MCP-Client.

Stand: 30. Sept. 2026

Tulimoa Memory ist ein MCP-Server, der streamable HTTP spricht. Jede Anfrage trägt ein Bearer-Token. Clients wie claude.ai und ChatGPT bekommen es, indem du dich mit deinem Tulimoa-Konto anmeldest (OAuth). Alles andere nutzt einen API-Key, den du auf zwei Wegen bekommst: Du legst im Dashboard ein Gedächtnis an und lädst es per Karte auf, oder ein Agent meldet sich selbst mit einer Krypto-Zahlung an.

Der Endpoint
https://memory.tulimoa.com/mcp

In claude.ai oder ChatGPT: anmelden

  1. Füge einen eigenen Connector mit der Adresse https://memory.tulimoa.com/mcp hinzu. In ChatGPT braucht das den Entwicklermodus.
  2. Der Client schickt dich zu tulimoa.com. Melde dich mit deinem Tulimoa-Konto an.
  3. Wähl das Gedächtnis, das die App nutzen darf, oder leg ein neues an (dein erstes startet mit 1 $ Guthaben). Leg fest, ob sie Personendaten im Klartext sehen darf, und erlaube den Zugriff.

Aufrufe kosten dieselben 0,002 $ und gehen vom Guthaben dieses Gedächtnisses ab; aufladen kannst du per Karte im Dashboard. Die App bleibt angemeldet und erneuert ihren Zugang selbst. Unter Gedächtnis siehst du jede verbundene App und kannst sie jederzeit trennen. API-Keys, die Selbstanmeldung von Agents und Verknüpfungscodes funktionieren weiter daneben.

API-Key holen

Für Menschen: Öffne im Dashboard Gedächtnis und klick auf „Gedächtnis anlegen“. Du siehst den Key einmal, zusammen mit dem Verbindungsbefehl, und startest mit 1 $ Guthaben. Keys aus dem Dashboard dürfen Personendaten im Klartext lesen; nimm den Haken beim Anlegen eines weiteren Keys weg, wenn ein Agent nur Platzhalter sehen soll. Aufladen per Karte unter Abrechnung, ab 5 $. Für Agents ohne Menschen: Keys werden in USDC auf Base bezahlt, über das Zahlungsprotokoll x402. Die zahlende Wallet wird zum Konto. Die Registrierung ist die erste Aufladung: Der ganze Betrag landet auf deinem Guthaben, das Minimum sind 0,01 $.

  1. Schick POST /register ohne Zahlung. Der Server antwortet mit HTTP 402 und den Zahlungsbedingungen: Betrag, Asset und Empfänger.
  2. Signiere eine EIP-3009-transferWithAuthorization über genau diesen Betrag, kodiere den Payment-Payload in Base64 und schick dieselbe Anfrage mit ihm im X-PAYMENT-Header noch einmal.
  3. Die Antwort (201) enthält deinen api_key, er beginnt mit tlm_mem_. Speichere ihn sofort: Er wird genau einmal angezeigt.
Registrieren mit 1,00 $ Startguthaben
# 1. Ask for the payment requirements (answers HTTP 402)
curl -i -X POST "https://memory.tulimoa.com/register?amount_micro_usd=1000000"

# 2. Retry with the signed payment and an optional label for this agent
curl -X POST "https://memory.tulimoa.com/register?amount_micro_usd=1000000" \
  -H "X-PAYMENT: <base64 payment payload>" \
  -H "Content-Type: application/json" \
  -d '{"agent_label": "support-agent"}'

Beträge sind in Micro-USD, der kleinsten Einheit von USDC: 1000000 sind 1,00 $, 10000 ist das Minimum von 0,01 $. Ohne amount_micro_usd gilt das Minimum. agent_label benennt den Agent in der Timeline, bis zu 120 Zeichen. Die maschinenlesbaren Bedingungen für Agents liegen unter /.well-known/x402.

Key verloren? Ruf POST /register noch einmal von derselben Wallet auf. Das zählt als Aufladung und liefert einen neuen Key; frühere Keys bleiben gültig. Keys laufen nach 365 Tagen ab. Keine Wallet zur Hand? Schreib an accounts@tulimoa.com.

Client verbinden

Claude Code
claude mcp add --transport http tulimoa-memory https://memory.tulimoa.com/mcp --header "Authorization: Bearer tlm_mem_..."
Claude Desktop, Cursor, Windsurf, VS Code und jeder MCP-Client (mcp.json)
{
  "servers": {
    "tulimoa-memory": {
      "type": "http",
      "url": "https://memory.tulimoa.com/mcp",
      "headers": { "Authorization": "Bearer tlm_mem_..." }
    }
  }
}

Jede MCP-Anfrage braucht den Key, initialize und tools/list eingeschlossen. Abgerechnet werden nur Tool-Calls. Beim Verbinden gibt der Server deinem Agent einen kurzen Wach-Zustand mit: das aktuelle Ziel, den letzten Zwischenstand, offene Punkte, Warnungen, die Überschrift des letzten Briefings, das restliche Guthaben und die Speicherstufe.

Die erste Erinnerung speichern

Sag deinem Agent
Today:        "Remember that our staging URL is https://staging.example.com"
              -> the agent calls tulimoa__remember

Next session: "What is our staging URL?"
              -> the agent calls tulimoa__recall and answers without searching

Direkt nach dem Schreiben findet recall die Erinnerung unter den rohen Erlebnissen. Nach der ersten Nacht ist sie Teil des Wissensgraphen und kommt über Assoziation zurück, zusammen mit dem, was dazugehört. Mehr unter Schlaf, Wissen und Morgenbriefing.

Pay as you go oder Guthaben

  • Pro Call zahlen. Reicht das Guthaben für einen Call nicht, antwortet tools/call mit HTTP 402 und einer Forderung über genau einen Call-Preis. Dein Client bezahlt diesen einen Call mit einem X-PAYMENT-Header von der Wallet des Kontos, und der Call läuft durch. Kein Minimum, kein Guthaben nötig.
  • Guthaben halten. POST /topup funktioniert wie die Registrierung (ab 0,01 $, ohne Maximum) und spart den Zahlungs-Umweg bei jedem Call. Schick deinen Bearer-Key mit; die Zahlung muss dann von der Wallet kommen, die an diesen Key gebunden ist.

Preise, Speichergebühr, Warnungen und Tageslimit stehen unter Preise und Limits.

Ein Agent kann sein Gedächtnis ohne einen Menschen nutzen und bezahlen. Wenn du das Guthaben sehen und rechtzeitig vor dem Ende der Speichergebühr gewarnt werden willst, verknüpfe das Gedächtnis mit deinem Tulimoa-Konto: Der Agent ruft tulimoa__link_account auf (kostenlos) und bekommt einen Code wie ABCD-2345, gültig für 30 Minuten. Trag ihn unter Gedächtnis im Dashboard ein. Mit email oder webhook_url gehen die Warnungen direkt an dich.

Im Dashboard sieht ein Mensch alles zum Gedächtnis: Wissen und einzelne Einträge, Widersprüche zum Prüfen, Personendaten im Tresor, Schlüssel, Guthaben und Briefings. Ohne Konto zeigt memory.tulimoa.com/briefing kostenlos die letzten 14 Morgenbriefings, sobald du deinen Key ins Formular eingibst; der Key landet nie in einer URL.