# Palim > Palim is a hosted MCP memory server. It stores sessions, decisions, and memories you explicitly save, then makes them searchable from every connected AI client — ChatGPT, Claude, Claude Code, Cursor, Perplexity, and other MCP-compatible tools. ## Category - Hosted MCP memory server (not a local SQLite sidecar) - Cross-tool / cross-LLM persistent context - EU hosting (Frankfurt, AWS eu-central-1) - AES-256-GCM encryption for supported stored content fields - Search today: PostgreSQL full-text + text match (not vector/semantic embeddings) ## Quick setup (copy-paste) MCP endpoint: `https://api.usepalim.com/mcp` Setup / API key: https://api.usepalim.com/setup Claude Code: ``` claude mcp add --transport http palim https://api.usepalim.com/mcp ``` Cursor (`mcp.json` / Settings → MCP): ```json { "mcpServers": { "palim": { "url": "https://api.usepalim.com/mcp" } } } ``` Claude Desktop / Claude.ai: add a custom connector / remote MCP with URL `https://api.usepalim.com/mcp` (OAuth). No API key required for that flow. ChatGPT: Developer Mode → Create app → URL `https://api.usepalim.com/mcp` → OAuth with **OIDC disabled**. In each chat, mention `@Palim`. ## Key pages Website: https://www.usepalim.com/ Documentation: https://www.usepalim.com/en/docs/ Updates: https://www.usepalim.com/en/releases/ Hosted MCP memory server: https://www.usepalim.com/en/use-cases/hosted-mcp-memory-server/ Share context ChatGPT ↔ Claude: https://www.usepalim.com/en/use-cases/share-context-chatgpt-claude/ Share context Claude ↔ Cursor: https://www.usepalim.com/en/use-cases/share-context-claude-cursor/ Claude Code persistent memory: https://www.usepalim.com/en/use-cases/claude-code-persistent-memory/ Palim vs ChatGPT Memory: https://www.usepalim.com/en/compare/palim-vs-chatgpt-memory/ Palim vs OpenMemory (mem0 local): https://www.usepalim.com/en/compare/palim-vs-openmemory/ Palim vs Mem0 (hosted alternative): https://www.usepalim.com/en/compare/palim-vs-mem0/ # Documentation (de) ## Palim verstehen Source: https://www.usepalim.com/de/docs/ Palim verbindet MCP-kompatible KI-Tools mit einer gemeinsamen Wissensbasis. Verbundene Agents speichern nach substanziellen Ergebnissen standardmäßig einen kompakten Arbeitsstand. Vollständige Chats werden nur gespeichert, wenn der Agent dafür `palim_save_session` verwendet. Ein anderes verbundenes Tool kann diese Inhalte später wiederfinden. ## Die vier Bausteine | Baustein | Geeignet für | Inhalt | | --- | --- | --- | | **Context Snapshot** | Übergaben zwischen KI-Tools | Kompakter Arbeitsstand ohne vollständigen Nachrichtenverlauf | | **Session** | Nachvollziehbare Chat-Historie | Vollständiger Chat mit Nachrichten, Summary und Metadaten | | **Memory** | Dauerhafte Fakten und Entscheidungen | Einzelne, editier- und löschbare Information | | **Brain** | Überblick über wiederkehrende Themen | Aus gespeicherten Inhalten abgeleitete Themenansicht im Dashboard | Der Palim-MCP-Server weist verbundene Agents an, nach wichtigen Ergebnissen, Entscheidungen oder Richtungswechseln `palim_save_context` aufzurufen. Dabei wird eine kompakte, eigenständige Summary gespeichert – nicht automatisch der vollständige Nachrichtenverlauf. Triviale Unterhaltungen, Secrets und Inhalte, deren Speicherung du untersagst, sollen nicht gespeichert werden. ## Typischer Ablauf 1. Verbinde mindestens einen KI-Client mit Palim. 2. Arbeite an einer substanziellen Aufgabe. Der verbundene Agent legt danach normalerweise selbst einen Context Checkpoint an. 3. Öffne später ein anderes verbundenes Tool. 4. Frage: **„Was haben wir beim Projekt Atlas zum Auth-Flow entschieden?“** Palim durchsucht die gespeicherten Inhalte und liefert passende Ergebnisse an den Client zurück. Die KI entscheidet anschließend, wie sie diese Ergebnisse in ihre Antwort einbezieht. Du kannst einen Checkpoint jederzeit ausdrücklich anfordern: **„Halte den aktuellen Stand für andere KI-Tools fest.“** Für einen vollständigen Chat sage stattdessen: **„Speichere diesen vollständigen Chat in Palim.“** ## Was die Suche heute kann Palim verwendet PostgreSQL-Volltextsuche und Textabgleich. Du kannst außerdem nach Zeitraum, Tags, Projekt und Quelle filtern. Eine semantische Embedding-Suche ist derzeit nicht implementiert. Account anlegen, Client verbinden und den ersten Kontext speichern. Sessions, Context Snapshots, Memories, Suche und Export richtig einsetzen. ## Schnellstart Source: https://www.usepalim.com/de/docs/getting-started/ ## 1. Account anlegen Öffne [api.usepalim.com/setup](https://api.usepalim.com/setup), registriere dich und melde dich an. Für die meisten Desktop-Clients ist OAuth der einfachste Weg; für Clients ohne OAuth-Unterstützung kannst du auf der Setup-Seite einen API-Key erstellen. Ein API-Key gewährt Zugriff auf deine Palim-Daten. Teile ihn nicht und speichere ihn nur in der sicheren Konfiguration deines Clients. ## 2. Ersten Client verbinden Nutze für Cursor, Claude, ChatGPT oder Perplexity die passende [Integrationsanleitung](https://www.usepalim.com/de/docs/integrations/). Die gemeinsame MCP-Adresse lautet: ```text https://api.usepalim.com/mcp ``` Bei OAuth-kompatiblen Clients reicht normalerweise diese URL. Der Browser öffnet die Palim-Anmeldung beim ersten Verbindungsversuch. ## 3. Verbindung prüfen Öffne einen neuen Chat in deinem verbundenen Client und sage: ```text Palim Help ``` Der Client sollte `palim_help` aufrufen und eine Übersicht der verfügbaren Palim-Werkzeuge anzeigen. Falls der Client das Tool nicht sieht, prüfe zuerst, ob Palim für den aktuellen Chat aktiviert wurde. ## 4. Ersten Arbeitsstand speichern Nach einem substanziellen Ergebnis soll ein verbundener Agent automatisch einen kompakten Context Checkpoint anlegen. Du kannst den Checkpoint auch ausdrücklich anfordern: ```text Halte den aktuellen Stand für andere KI-Tools fest. ``` Der Client verwendet dafür `palim_save_context`. Der Checkpoint enthält eine eigenständige Summary, aber keinen vollständigen Nachrichtenverlauf. Wenn du stattdessen den vollständigen Chat archivieren möchtest, sage: ```text Speichere diesen vollständigen Chat als "Mein erster Palim-Chat". ``` ## 5. Kontext wiederfinden Öffne einen anderen verbundenen Client und frage: ```text Suche in Palim nach meinem ersten Palim-Chat und fasse den Arbeitsstand zusammen. ``` Wenn Palim ein Ergebnis liefert, funktioniert der komplette Ablauf aus Speichern und Abrufen. ## Nächster Schritt Lies [Palim im Alltag](https://www.usepalim.com/de/docs/workflows/), um Context Snapshots, Sessions und Memories bewusst einzusetzen. Mit [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/) stimmst du deinen KI-Client anschließend dauerhaft auf Palim ab und testest das Verhalten. ## KI-Clients verbinden Source: https://www.usepalim.com/de/docs/integrations/ Alle Clients verbinden sich mit demselben gehosteten MCP-Endpunkt: ```text https://api.usepalim.com/mcp ``` Die Authentifizierung hängt vom Client ab. Nutze OAuth, wenn der Client Remote-MCP mit OAuth unterstützt. Verwende andernfalls einen API-Key aus der [Palim Setup-Seite](https://api.usepalim.com/setup). Remote MCP per OAuth oder `mcp.json`. Connector in der App oder ein CLI-Befehl. Developer Mode, OAuth ohne OIDC und `@Palim` im Chat. Unterstützter Ablauf für die Perplexity Mac App. OAuth, API-Key und generisches Remote-MCP. ## Nach jeder Verbindung Starte einen neuen Chat und sage `Palim Help`. Der Client muss `palim_help` in seiner Werkzeugliste sehen. Bei ChatGPT muss Palim zusätzlich für jeden Chat mit `@Palim` aktiviert werden. Die technische Verbindung allein garantiert noch keinen automatischen Abruf. Unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/) findest du eine kopierbare Grundanweisung, den passenden Speicherort pro Client und einen Zuverlässigkeitstest. ## Verbindungsarten | Methode | Wann verwenden | Geheimnis im Client | | --- | --- | --- | | OAuth | Cursor, Claude, Claude Code, ChatGPT, Antigravity | Nein | | `x-api-key` | Perplexity Mac, n8n, rohe HTTP-/JSON-RPC-Clients | Ja | | Connection URL | Nur wenn ein Client keine Header unterstützt und du sie ausdrücklich in Palim erzeugst | Token ist Teil der URL | ## Unterstützte Verbindungswege | Client | Dokumentierter Weg | Authentifizierung | Besonderheit | | --- | --- | --- | --- | | Cursor | Remote MCP in Settings oder `mcp.json` | OAuth | Keine zusätzliche `config.json` nötig. | | Claude Desktop | Custom Connector | OAuth | Kein manueller Desktop-Config-Eintrag nötig. | | Claude Code | `claude mcp add --transport http` | OAuth | Browser-Login beim ersten Zugriff. | | ChatGPT | Custom App im Developer Mode | OAuth | OIDC deaktivieren und Palim pro Chat mit `@Palim` aktivieren. | | Perplexity Mac | Advanced Connector mit `mcp-remote` | `x-api-key` | Der Web-Connector ist derzeit nicht der unterstützte Ablauf. | | Antigravity | Remote MCP URL | OAuth | MCP-Adresse genügt. | | n8n und eigene Clients | Streamable HTTP | `x-api-key` | `initialize` und `mcp-session-id` beachten. | Die Produktoberflächen der Clients ändern sich unabhängig von Palim. Wenn ein Menüname abweicht, bleiben MCP-Adresse, Authentifizierungsart und die Hinweise in der jeweiligen Anleitung maßgeblich. ## ChatGPT Source: https://www.usepalim.com/de/docs/integrations/chatgpt/ ChatGPT benötigt einen Plan oder Workspace, in dem Developer Mode und benutzerdefinierte Apps verfügbar sind. ## Connector erstellen 1. Öffne **Settings → Apps → Advanced Settings**. 2. Aktiviere **Developer Mode**. 3. Wähle **Create app**. 4. URL: `https://api.usepalim.com/mcp`. 5. Authentifizierung: **OAuth**. 6. Öffne die erweiterten OAuth-Einstellungen und deaktiviere **OIDC enabled**. 7. Erstelle die App und schließe Anmeldung sowie Freigabe im Browser ab. Mit aktiviertem OIDC kann die Verbindung mit „Authorization Request Expired“ oder „Token exchange failed“ abbrechen. ## Palim in einem Chat verwenden Die Verbindung in den Einstellungen allein reicht nicht. Tippe im Chat-Eingabefeld `@`, wähle **Palim** und beginne dann deine Anfrage. Dieser Schritt ist für jeden neuen Chat nötig. ## Verhalten personalisieren Nutze globale **Custom Instructions** für eine kontoweite Palim-Grundregel oder **Project Instructions** für ein bestimmtes Projekt. Die Anweisung erhöht die Wahrscheinlichkeit für proaktive Suche und Checkpoints, aktiviert die Palim-App aber nicht selbst. Kopiere die Vorlage unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/). ## Test ```text @Palim Palim Help ``` Wenn ChatGPT keine Tools sieht, entferne die App, lege sie mit deaktiviertem OIDC neu an und füge sie anschließend erneut mit `@Palim` zum Chat hinzu. ## Claude Desktop und Claude Code Source: https://www.usepalim.com/de/docs/integrations/claude/ ## Claude Desktop Claude Desktop verwendet für gehostete Remote-MCP-Server den Connector-Dialog: 1. Öffne **Settings → Connectors**. 2. Wähle **Add custom connector**. 3. Name: `Palim`. 4. Remote MCP Server URL: `https://api.usepalim.com/mcp`. 5. Füge den Connector hinzu und schließe OAuth ab. Du brauchst dafür weder einen API-Key noch eine manuelle `claude_desktop_config.json`. ## Claude Code Führe im Terminal aus: ```bash claude mcp add --transport http palim https://api.usepalim.com/mcp ``` Claude Code öffnet beim ersten Zugriff den OAuth-Flow. Prüfe anschließend die Verbindung: ```bash claude mcp list ``` ## Verhalten personalisieren Nutze in Claude kontoweite Profile Preferences oder Project Instructions. In Claude Code gehört die kurze Grundregel in `CLAUDE.md`; einen längeren, wiederholbaren Ablauf kannst du als Skill anlegen. Vorlagen und Testschritte stehen unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/). ## Test Bitte Claude oder Claude Code um `Palim Help`. Wird Palim nicht angezeigt, entferne die Verbindung, füge sie erneut hinzu und beende die Browser-Anmeldung vollständig. ## Cursor Source: https://www.usepalim.com/de/docs/integrations/cursor/ ## Über die Einstellungen 1. Öffne **Settings → Tools & MCP**. 2. Füge einen neuen MCP-Server hinzu. 3. Verwende `https://api.usepalim.com/mcp` als URL. 4. Schließe die Palim-Anmeldung im Browser ab. ## Über `mcp.json` Lege den Server in `~/.cursor/mcp.json` oder projektbezogen in `.cursor/mcp.json` an: ```json { "mcpServers": { "palim": { "url": "https://api.usepalim.com/mcp" } } } ``` Cursor startet beim ersten Verbindungsversuch den OAuth-Flow. Ein API-Key ist für diesen Ablauf nicht nötig. ## Verhalten personalisieren Hinterlege die kurze Palim-Grundregel als persönliche oder projektbezogene Cursor Rule. Wenn dein Repository bereits mit `AGENTS.md` arbeitet, kann die projektspezifische Regel auch dort stehen. Den vollständigen Text, den Zuverlässigkeitstest und einen optionalen Skill findest du unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/). ## Test Öffne einen neuen Agent-Chat und sage `Palim Help`. Falls Cursor „No tools“ anzeigt, trenne den Server in **Tools & MCP**, verbinde ihn erneut und schließe den OAuth-Flow vollständig ab. Zusätzliche lokale `config.json`-Dateien sind nicht erforderlich. ## Antigravity und andere MCP-Clients Source: https://www.usepalim.com/de/docs/integrations/other-clients/ ## Antigravity Füge `https://api.usepalim.com/mcp` als Remote-MCP-Server hinzu. Antigravity startet beim ersten Zugriff den OAuth-Flow; ein API-Key ist für diesen Ablauf nicht erforderlich. ## Generische Clients mit API-Key Clients ohne OAuth können den auf der Setup-Seite erzeugten Key als Header senden: ```http x-api-key: palim_... ``` Das gilt beispielsweise für n8n MCP Client oder eigene JSON-RPC-Integrationen. Sende zuerst `initialize` und übernimm anschließend bei zustandsbehafteten HTTP-Aufrufen den vom Server gelieferten `mcp-session-id`-Header. ## n8n Verwende einen MCP-Client-Node beziehungsweise die MCP-Client-Credentials deiner n8n-Version: 1. Transport: **Streamable HTTP**. 2. Server URL: `https://api.usepalim.com/mcp`. 3. Authentifizierung: benutzerdefinierter Header. 4. Header-Name: `x-api-key`. 5. Header-Wert: dein `palim_...` API-Key. Speichere den Key in n8n-Credentials, nicht direkt in einem Workflow-Feld oder Prompt. Der Client muss die MCP-Initialisierung übernehmen und den zurückgegebenen `mcp-session-id` für weitere zustandsbehaftete Aufrufe mitsenden. ## Raw JSON-RPC Der erste Request ist ein `initialize`-Aufruf an `/mcp` mit `Content-Type: application/json`, `Accept: application/json, text/event-stream` und dem `x-api-key`-Header. Übernimm den `mcp-session-id` aus der Antwort in die folgenden Requests, sende anschließend `notifications/initialized` und rufe danach beispielsweise `tools/list` auf. Ein einzelner POST auf `tools/call` ohne vorheriges `initialize` und ohne die Session-ID ist kein vollständiger MCP-Handshake. ## Agent-Verhalten abstimmen Füge die Palim-Grundanweisung in den System Prompt deines n8n-Agent-Nodes, Antigravity-Projekts oder eigenen Clients ein. Die Anweisung und der technische Zuverlässigkeitstest stehen unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/). Der Prompt ersetzt weder `initialize` noch Authentifizierung und Session-Header. ## Clients ohne Header-Unterstützung Ein bereits verbundener Agent kann mit `palim_create_connection_url` eine Connection URL erstellen. Pro Account sind höchstens fünf aktive Connection Tokens möglich. Eine öffentliche Verwaltungs- oder Widerrufsoberfläche existiert derzeit nicht. Behandle die URL deshalb wie ein Passwort und nutze nach Möglichkeit OAuth oder `x-api-key`. ## Kompatibilitätscheck Ein Client ist grundsätzlich geeignet, wenn er Remote MCP über Streamable HTTP unterstützt und entweder OAuth oder benutzerdefinierte HTTP-Header zulässt. Sichtbare Tool-Namen und die Art, wie ein Connector pro Chat aktiviert wird, unterscheiden sich je Produkt. ## Perplexity Mac App Source: https://www.usepalim.com/de/docs/integrations/perplexity/ Der derzeit unterstützte Perplexity-Ablauf verwendet die **Mac App**, die erweiterte Connector-Konfiguration und einen API-Key. Erstelle den Key auf [api.usepalim.com/setup](https://api.usepalim.com/setup). ## Konfiguration Öffne in Perplexity **Settings → Connectors → Add Connector → Advanced** und füge diese Konfiguration ein: ```json { "args": [ "mcp-remote", "https://api.usepalim.com/mcp", "--header", "x-api-key:${PALIM_API_KEY}" ], "command": "npx", "env": { "PALIM_API_KEY": "DEIN_PALIM_API_KEY" }, "useBuiltInNode": true } ``` Speichere den Connector und starte Perplexity neu. Teile diese Konfiguration nicht, weil sie deinen API-Key enthält. Der Custom-Connector-Ablauf in der Perplexity-Weboberfläche ist derzeit nicht zuverlässig. Nutze für Palim die Mac App. ## Verhalten personalisieren Nutze die Custom Instructions deines Accounts oder die Custom AI Instructions eines Perplexity Projects. Stelle unabhängig davon sicher, dass der Palim-Connector im Thread verfügbar ist. Eine kurze Startanweisung und den Zuverlässigkeitstest findest du unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/). ## Test Öffne einen neuen Thread mit aktiviertem Palim-Connector und frage nach `Palim Help`. ## MCP-Tool-Referenz Source: https://www.usepalim.com/de/docs/reference/ Der Server stellt die folgenden Tools bereit. Welche Tools ein Client tatsächlich anzeigt, hängt zusätzlich von der Serverkonfiguration, der Authentifizierungsart und gegebenenfalls einer Staff-Freischaltung ab. ## Checkpoints und Sessions - `palim_save_context` — Standardmäßiger proaktiver Checkpoint: aktualisiert eine kompakte Summary ohne Nachrichtenverlauf. - `palim_save_session` — Speichert oder erweitert einen vollständigen Chat mit Messages, Summary und Metadaten. - `palim_list_sessions` — Listet Sessions mit Filtern für Quelle, Tags, Status und Zeitraum. - `palim_browse_sessions` — Liefert eine maschinenlesbare Session-Liste für UI- und Browser-Clients. - `palim_get_session` — Lädt eine vollständige Session. - `palim_get_sessions` — Lädt bis zu 15 Sessions in einem Aufruf. - `palim_show_session` — Rendert eine Session in einer lesbaren Nachrichtenansicht. - `palim_get_summary` — Lädt nur die Summary einer Session. - `palim_list_summaries` — Listet Session-Summaries ohne vollständige Messages. - `palim_create_summary` — Ergänzt eine Summary für eine Session, die noch keine besitzt. - `palim_update_session_metadata` — Ändert Titel, Tags, Projekt, Status oder Erstellungsdatum. - `palim_update_session_references` — Ergänzt oder ersetzt Quellen-URLs. - `palim_export_session` — Exportiert eine Session als Markdown, JSON oder Text. - `palim_delete_session` — Setzt standardmäßig Status `deleted`; `hard_delete: true` löscht dauerhaft. - `palim_find_similar` — Findet ähnliche Sessions per Keyword- und Inhaltsabgleich. - `palim_get_stats` — Liefert Bestands- und Aktivitätsstatistiken. ## Suche und Abruf - `palim_search` — Volltext- und Textsuche mit optionalen Metadatenfiltern. - `palim_search_by_date_range` — Filtert Sessions nach Datum sowie optional Tags, Projekt und Tool-Quelle. Durchsucht dabei nicht zusätzlich den Nachrichteninhalt. - `palim_get_context` — Sucht relevante Sessions und formatiert daraus einen kompakten Kontextblock. Die Suche ist derzeit nicht embedding- oder vektorbasiert. Bei verschlüsselten Inhalten verwendet Palim entschlüsselten Textabgleich im Serverprozess. Exakte Titelphrasen können in der Volltextsuche schlechter funktionieren als mehrere charakteristische Begriffe, Tags oder ein Projektfilter. ## Memories - `palim_add_memory` — Speichert einen einzelnen Fakt, eine Entscheidung, Präferenz, Erkenntnis oder Notiz. - `palim_search_memories` — Sucht Memories nach Text, Typ und Tags. - `palim_update_memory` — Ändert Inhalt, Typ, Tags oder Metadaten einer Memory. - `palim_delete_memory` — Löscht eine Memory dauerhaft. ## Brain - `palim_get_brain` — Lädt ohne Argument den Topic-Index oder mit `topic` ein vollständiges Topic. - `palim_export_brain` — Exportiert alle Topics als Obsidian-kompatibles Markdown-Vault. - `palim_update_brain_topic` — Erstellt, bearbeitet, benennt um oder löscht ein Topic. - `palim_backfill_brain` — Liest bis zu 1.000 bestehende Sessions mit Summary nachträglich in das Brain ein. ## Nutzerkontext, Regeln und Profil - `palim_set_user_context` — Setzt einen nutzereigenen Kontextblock, wenn User Modeling in der Umgebung aktiviert ist. - `palim_get_user_context` — Liest diesen Kontextblock. - `palim_add_user_rule` — Erstellt eine dauerhafte Arbeits- oder Verhaltensregel. - `palim_list_user_rules` — Listet die eigenen Regeln. - `palim_update_user_rule` — Ändert Inhalt, Aktivierung, Tags oder Reihenfolge einer Regel. - `palim_delete_user_rule` — Löscht eine Regel. - `palim_get_user_profile` — Liest das abgeleitete User Profile. In Produktion derzeit nur für freigeschaltete Staff-Accounts. - `palim_update_user_profile` — Ändert Consent, Refinement und Profilfelder. In Produktion derzeit nur für freigeschaltete Staff-Accounts. ## Account, Verbindung und Wartung - `palim_register` — Registriert einen Account und gibt einen neuen API-Key aus. Für normale Hosted-Nutzung ist die Setup-Seite vorgesehen. - `palim_login` — Meldet einen bestehenden Account an und erzeugt einen neuen API-Key. - `palim_logout` — Löscht standardmäßig alle API-Keys und versucht OAuth-Sessions zu widerrufen. - `palim_create_connection_url` — Erzeugt im HTTP-Modus eine URL mit Connection Token. Maximal fünf aktive Tokens pro Account. - `palim_help` — Zeigt eine kategorisierte Übersicht der Palim-Tools. - `palim_migrate_encryption` — Migriert ältere Klartext-Inhalte. Standardmäßig nur Vorschau mit `dry_run: true`; kein normaler Endnutzer-Workflow. ## Beta und Limits Palim ist derzeit eine kostenlose Beta; bezahlte Pläne sind noch nicht aktiv. Es gibt aktuell keine veröffentlichte Speicherquote pro Plan. Einzelne Tools haben jedoch technische Aufruflimits, unter anderem: - `palim_get_sessions`: höchstens 15 Session-IDs pro Aufruf - `palim_list_sessions`: höchstens 100 Ergebnisse - `palim_list_summaries`: höchstens 200 Ergebnisse - `palim_backfill_brain`: höchstens 1.000 gescannte Sessions - Connection URLs: höchstens fünf aktive Tokens pro Account Änderungen an zukünftigen Preisen, Speicherquoten oder Planlimits werden vor Aktivierung bezahlter Pläne veröffentlicht. ## Sicherheit und Datenschutz Source: https://www.usepalim.com/de/docs/security/ ## Verschlüsselung im Ruhezustand Unterstützte Inhaltsfelder werden serverseitig mit AES-256-GCM verschlüsselt, bevor sie in der Datenbank gespeichert werden. Palim leitet dafür per scrypt einen separaten Schlüssel pro Nutzer aus einem serverseitig verwalteten Master-Key ab. | Datenart | Verschlüsselter Inhalt | Lesbare Betriebsmetadaten | | --- | --- | --- | | Sessions | Nachrichten, Summary-Text und strukturierte Summary-Felder | Session-ID, Titel, Status, Tool-Quelle, Zeitstempel, Projekt, Tags, Quellen-URLs und bei Context Checkpoints eine `summary_preview` mit bis zu 280 Zeichen | | Memories | Inhalt; zusätzlich existieren verschlüsselte Kopien von Tags und zusätzlichen Memory-Metadaten | ID, Typ, Nutzerzuordnung, Zeitstempel sowie die Tags und zusätzlichen Metadaten in aktuell ebenfalls lesbaren Feldern | | Brain | Markdown-Inhalt eines Topics | Slug, Titel, Hook, Eintragszahl, Quell-Session-IDs und Zeitstempel. Der Hook kann einen kurzen Summary-Ausschnitt enthalten. | | User Modeling | Für User Context, Rules und Profile werden verschlüsselte Kopien angelegt | Die zugehörigen Content- beziehungsweise Profilfelder werden aktuell zusätzlich in lesbarer Form gespeichert. Diese Funktionen sind konfigurationsabhängig; Profile sind in Produktion Staff-only. | Diese Metadaten bleiben für Zuordnung, Filterung, Navigation und Betrieb lesbar. „Verschlüsselt“ bedeutet deshalb nicht, dass jeder Datenbankwert verschlüsselt ist. Der Palim-Server kann Inhalte entschlüsseln, um Suche, Abruf und Export bereitzustellen. Die serverseitige Laufzeit und der Master-Key gehören deshalb zur Vertrauensgrenze. ## Account-Isolation Authentifizierung und Datenbankregeln ordnen gespeicherte Daten einem Nutzer zu. OAuth-Clients erhalten keine gemeinsam genutzten Zugangsdaten. API-Keys sind nutzerspezifisch und sollten sofort erneuert werden, wenn sie offengelegt wurden. ## Deine Kontrolle - Verbundene Agents legen nach substanziellen Ergebnissen standardmäßig proaktive Context Checkpoints an. Diese enthalten eine kompakte Summary, nicht automatisch den vollständigen Nachrichtenverlauf. - Du kannst die Speicherung einzelner Inhalte untersagen; Secrets und triviale Unterhaltungen sollen nicht gespeichert werden. - Sessions können geprüft, über MCP-Tools in ihren Metadaten geändert und gelöscht werden. Messages und Summary einer Session sind nicht allgemein editierbar. - Memories können geprüft, bearbeitet und dauerhaft gelöscht werden. - Einzelne Sessions lassen sich in offenen Formaten exportieren. - Die Brain-Ansicht lässt sich als Markdown-Vault exportieren. - Palim verwendet deine gespeicherten Gespräche nicht zum Trainieren von Modellen. Ein vollständiger Export aller Datenklassen in einem einzigen Vorgang ist derzeit nicht verfügbar. Kontaktiere für Account-Löschung oder Datenschutzanfragen [privacy@usepalim.com](mailto:privacy@usepalim.com). ## Verarbeitung durch verbundene KI-Tools Palim liefert entschlüsselte Suchergebnisse und gespeicherte Inhalte an den KI-Client zurück, der das jeweilige Tool aufruft. Ab diesem Punkt gelten auch die Datenverarbeitungsbedingungen des verbundenen KI-Anbieters. Die normale Brain-Destillation läuft deterministisch auf dem Palim-Server und verwendet gespeicherte Session-Summaries. Wenn ein Brain-Topic seine Größenbegrenzung überschreitet und auf dem Server ein Anthropic API-Key konfiguriert ist, kann der entschlüsselte Topic-Inhalt zur Konsolidierung an Claude Haiku gesendet werden. Ohne konfigurierten Anthropic API-Key findet dieser externe Konsolidierungsschritt nicht statt. ## Sicher arbeiten 1. Bevorzuge OAuth gegenüber API-Keys, wenn dein Client es unterstützt. 2. Speichere API-Keys nur in Secret- oder Connector-Konfigurationen. 3. Teile keine Connection URLs; ihr Token ist ein Zugangsschlüssel. 4. Prüfe Exportdateien, bevor du sie weitergibst. 5. Lösche oder rotiere Zugangsdaten nach einem möglichen Leak. Die konkreten Unterschiede zwischen Status-Löschung, dauerhafter Dashboard-Löschung, API-Keys und Connection URLs stehen unter [Daten und Zugänge verwalten](https://www.usepalim.com/de/docs/workflows/data-management/). ## Fehlerbehebung Source: https://www.usepalim.com/de/docs/troubleshooting/ ## Palim oder seine Tools werden nicht angezeigt 1. Prüfe, ob `https://api.usepalim.com/mcp` exakt eingetragen ist. 2. Trenne den Connector und verbinde ihn erneut. 3. Schließe den Browser-Login vollständig ab. 4. Starte einen neuen Chat und frage nach `Palim Help`. 5. Bei ChatGPT: Füge Palim mit `@Palim` zum aktuellen Chat hinzu. Cursor und andere SSE-/Streamable-HTTP-Clients benötigen keine zusätzliche `config.json` neben ihrer normalen MCP-Konfiguration. ## ChatGPT: Authorization Request Expired Entferne die Palim-App und erstelle sie erneut. Wähle OAuth und deaktiviere in den erweiterten Einstellungen **OIDC enabled**. Schließe die Anmeldung ohne lange Unterbrechung ab und aktiviere danach `@Palim` im Chat. ## Authentication failed oder ungültiger API-Key - Entferne Leerzeichen vor oder nach dem Key. - Verwende den Header `x-api-key`. - Erstelle auf der Setup-Seite einen neuen Key und ersetze den alten. - Vermeide es, API-Keys in Chat-Nachrichten oder Screenshots einzufügen. ## Perplexity verbindet sich nicht Nutze die Perplexity Mac App und die [Advanced-Konfiguration](https://www.usepalim.com/de/docs/integrations/perplexity/). Der Custom-Connector in der Weboberfläche ist derzeit nicht zuverlässig. ## Suche findet einen bekannten Chat nicht - Verwende mehrere Begriffe aus dem Inhalt statt nur einer exakten Titelphrase. - Suche zusätzlich nach Tags, Projekt oder Tool-Quelle. - Bei einer Zeitangabe verwende eine Datumssuche mit `palim_search_by_date_range`. - `palim_search_by_date_range` filtert nach Datum und Metadaten, durchsucht aber nicht zusätzlich den Nachrichteninhalt. - Verschlüsselte Inhalte werden über Textabgleich durchsucht; semantische Embeddings stehen noch nicht zur Verfügung. ## Palim soll einen Inhalt nicht speichern Sage dem verbundenen Agent ausdrücklich: `Speichere diesen Chat beziehungsweise diesen Inhalt nicht in Palim.` Die Server-Anweisung für proaktive Checkpoints schließt Inhalte aus, deren Speicherung du untersagst. Eine globale Opt-out-Einstellung für alle verbundenen Clients gibt es derzeit nicht. Wenn bereits ein Context Checkpoint angelegt wurde, suche die Session und lösche sie. Beachte dabei den Unterschied zwischen Status `deleted` und dauerhafter Löschung unter [Daten und Zugänge verwalten](https://www.usepalim.com/de/docs/workflows/data-management/). ## Brain bleibt trotz gespeicherter Sessions leer Das Brain verwendet Session-Summaries. Bitte einen Agent um `palim_backfill_brain` oder nutze im Dashboard **Bestehende Sessions einlesen**. Sessions ohne Summary können beim Backfill nicht destilliert werden. ## Hilfe erhalten Sende eine kurze Fehlerbeschreibung, Client, Zeitpunkt und sichtbare Fehlermeldung an [hello@usepalim.com](mailto:hello@usepalim.com). Sende niemals API-Keys, Connection URLs oder private Chatinhalte mit. ## Palim im Alltag verwenden Source: https://www.usepalim.com/de/docs/workflows/ ## Arbeitsstand oder vollständiger Chat? ### Context Snapshot `palim_save_context` ist der Standard-Checkpoint für die Übergabe an ein anderes KI-Tool. Der MCP-Server weist verbundene Agents an, ihn nach substanziellen Ergebnissen, Entscheidungen oder Richtungswechseln proaktiv aufzurufen. Der Client erstellt einen eigenständigen, kompakten Arbeitsstand mit Ziel, Entscheidungen, aktuellem Stand und nächsten Schritten – ohne den vollständigen Nachrichtenverlauf zu speichern. ```text Halte den aktuellen Stand für andere KI-Tools fest. ``` ### Session Nutze `palim_save_session`, wenn der vollständige Gesprächsverlauf nachvollziehbar bleiben soll. ```text Speichere diesen vollständigen Chat als "Auth-Review Juli" und tagge ihn mit auth und atlas. ``` Context Snapshot für die standardmäßige Übergabe, Session für das ausdrücklich gewünschte vollständige Archiv. Triviale Unterhaltungen, Secrets und Inhalte, deren Speicherung du untersagst, sollen nicht in einem Checkpoint landen. Wenn dein KI-Client Palim nicht zuverlässig automatisch verwendet, kopiere die Grundanweisung unter [Prompts und Personalisierung](https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/) in dessen dauerhafte Instructions. Dort findest du außerdem Alltags-Prompts, einen clientübergreifenden Zuverlässigkeitstest und einen optionalen Agent Skill. ## Gespeicherte Inhalte finden | Absicht | Beispiel | Passendes Werkzeug | | --- | --- | --- | | Stichwörter finden | „Suche nach Datenbankmigration“ | `palim_search` | | Zeitraum und Projekt | „Was war letzte Woche bei Atlas?“ | `palim_search_by_date_range` | | Relevanten Überblick holen | „Gib mir Kontext zum Auth-Flow“ | `palim_get_context` | | Vollständigen Chat lesen | „Zeige Session abc-123“ | `palim_show_session` | Die heutige Suche basiert auf Volltext- und Textabgleich. Verwende mehrere charakteristische Begriffe, Tags oder ein Projekt, wenn eine exakte Titelphrase nicht gefunden wird. ## Memories verwalten Memories eignen sich für einzelne langlebige Fakten und Entscheidungen: ```text Merke dir: Im Projekt Atlas verwenden wir PostgreSQL 15. ``` Mit `palim_search_memories` findest du gespeicherte Fakten. `palim_update_memory` korrigiert veraltete Inhalte; `palim_delete_memory` löscht eine Memory endgültig. ## Brain und Dashboard Das [Palim Dashboard](https://api.usepalim.com/dashboard) zeigt Sessions, Memories und die aus gespeicherten Session-Summaries aufgebaute Brain-Ansicht. Dort kannst du deine Daten durchsuchen, prüfen und verwalten. Lies [Brain und Dashboard](https://www.usepalim.com/de/docs/workflows/brain-and-dashboard/) für Aufbau, Backfill, Bearbeitung und die genaue Löschsemantik. Automatisierte User-Profile sind in der Produktionsumgebung derzeit nur für freigeschaltete Staff-Accounts verfügbar und gehören nicht zum allgemeinen Palim-Angebot. ## Metadaten, Export und Löschen - `palim_update_session_metadata` ändert Titel, Tags, Projekt oder Datum. - `palim_update_session_references` ergänzt Quellen-URLs. - `palim_export_session` exportiert eine Session als Markdown, JSON oder Text. - `palim_export_brain` erzeugt einen Markdown-/Obsidian-Export der Brain-Ansicht. - `palim_delete_session` setzt eine Session standardmäßig auf den Status `deleted`. Mit `hard_delete: true` werden Session, Messages und Summary dauerhaft gelöscht. Das Dashboard verwendet beim Löschen immer die dauerhafte Variante. Eine öffentliche Wiederherstellungsfunktion für Sessions mit Status `deleted` ist derzeit nicht vorhanden. Details zu Export, Löschung und Zugangsdaten stehen unter [Daten und Zugänge verwalten](https://www.usepalim.com/de/docs/workflows/data-management/). ## Brain und Dashboard Source: https://www.usepalim.com/de/docs/workflows/brain-and-dashboard/ ## Was das Brain speichert Wenn Brain-Destillation auf dem Server aktiviert ist, verarbeitet Palim die bereits gespeicherte Summary einer neuen oder aktualisierten Session. Der vollständige Nachrichtenverlauf wird dafür nicht erneut ausgewertet. Ein Thema enthält: - datierte Entscheidungen - offene Punkte - einen datierten Session-Log mit Titel und kurzem Summary-Ausschnitt Das Projekt der Session wird bevorzugt als Topic verwendet. Fehlt ein Projekt, verwendet Palim das erste `key_topic`; fehlt auch das, landet der Eintrag in `Inbox`. Einträge werden normalisiert, dedupliziert und begrenzt, damit ein Topic kompakt bleibt. Das Brain ist eine editierbare, thematische Verdichtung gespeicherter Session-Summaries. Es ist kein Embedding-Index und kein automatisch verifizierter Wissensgraph. ## Bestehende Sessions einlesen Sessions, die vor Einführung des Brains gespeichert wurden, erscheinen nicht zwingend automatisch. Nutze im Dashboard **Bestehende Sessions einlesen** oder bitte einen Agent um `palim_backfill_brain`. Der Backfill liest bis zu 1.000 vorhandene Sessions, verwendet nur Sessions mit Summary und dedupliziert bereits verarbeitete Inhalte. Er kann deshalb erneut ausgeführt werden, ohne identische Einträge absichtlich zu verdoppeln. ## Brain verwalten Im Dashboard kannst du: - Topics öffnen und durchsuchen - ein Topic manuell anlegen - Titel, Kurzbeschreibung und Markdown-Inhalt bearbeiten - zwei Topics zusammenführen - ein Topic dauerhaft löschen - das Brain als Obsidian-kompatibles Markdown-Vault exportieren Dieselben Kernaktionen stehen Agents über `palim_get_brain`, `palim_update_brain_topic`, `palim_backfill_brain` und `palim_export_brain` zur Verfügung. Beim Zusammenführen übernimmt das Ziel-Topic die deduplizierten Einträge; das Quell-Topic wird anschließend gelöscht. ## Dashboard-Bereiche | Bereich | Aktuelles Verhalten | | --- | --- | | Übersicht | Zeigt Bestandszahlen, aktuelle Aktivität und zuletzt gespeicherte Sessions. | | Brain | Topics lesen, anlegen, bearbeiten, zusammenführen, löschen, nachziehen und exportieren. | | Memories | Memories anlegen, filtern, bearbeiten und dauerhaft löschen. | | Timeline | Sessions lesen und dauerhaft löschen. Session-Inhalte sind dort nicht editierbar. | | Verbinden | Zeigt MCP-Adresse und API-Key-Konfiguration für weitere Clients. | Das Dashboard ruft beim Löschen einer Session immer die dauerhafte Löschung auf. Dabei werden Session, Messages und Summary entfernt. Das unterscheidet sich von `palim_delete_session` ohne `hard_delete`, das nur den Status `deleted` setzt. ## Automatische Konsolidierung großer Topics Topics haben feste Größen- und Eintragsgrenzen. Wenn ein Topic darüber hinaus wächst, kürzt Palim ältere Einträge und markiert es zur Konsolidierung. Ist auf dem Server ein Anthropic API-Key konfiguriert, kann Palim den entschlüsselten Topic-Inhalt an Claude Haiku senden, um Duplikate zusammenzuführen und erledigte offene Punkte zu entfernen. Ohne konfigurierten Anthropic API-Key findet dieser externe Konsolidierungsschritt nicht statt. ## Daten und Zugänge verwalten Source: https://www.usepalim.com/de/docs/workflows/data-management/ ## Sessions exportieren `palim_export_session` exportiert eine einzelne Session als Markdown, JSON oder Text. `palim_export_brain` gibt das gesamte Brain als Obsidian-kompatibles Markdown-Vault aus. Einen einzigen vollständigen Account-Export für alle Datenklassen gibt es derzeit nicht. ## Sessions löschen | Aktion | Ergebnis | | --- | --- | | `palim_delete_session` ohne `hard_delete` | Setzt den Status der Session auf `deleted`. Messages und Summary bleiben gespeichert. | | `palim_delete_session` mit `hard_delete: true` | Löscht Session, Messages und Summary dauerhaft. | | Löschen im Dashboard | Verwendet immer die dauerhafte Löschung. | Für Sessions mit Status `deleted` gibt es derzeit keine öffentliche Restore-Funktion. Prüfe vor einer dauerhaften Löschung immer Session-ID und Titel. Memories und Brain-Topics werden beim Löschen immer dauerhaft entfernt. Eine vollständige Account-Löschung ist derzeit nur über [privacy@usepalim.com](mailto:privacy@usepalim.com) verfügbar. ## API-Keys Registrierung und Anmeldung auf der [Setup-Seite](https://api.usepalim.com/setup) erzeugen einen neuen API-Key. Der rohe Key wird nur bei der Ausgabe angezeigt; serverseitig wird ein Hash zur Prüfung gespeichert. `palim_logout` löscht standardmäßig alle API-Keys des Accounts und versucht, alle OAuth-Sessions zu widerrufen. Der OAuth-Widerruf benötigt eine aktive OAuth-/JWT-Sitzung und kann bei einer reinen API-Key-Verbindung nicht durchgeführt werden. Um nur den aktuell verwendeten API-Key zu löschen, rufe `palim_logout` mit `delete_all_api_keys: false` und bei Bedarf `revoke_oauth_sessions: false` auf. Danach benötigt dieser Client einen neuen Key. Das Dashboard speichert den eingegebenen API-Key im Local Storage des Browsers und sendet ihn bei jedem Dashboard-API-Aufruf als `x-api-key`. Nutze das Dashboard nicht in einem gemeinsam verwendeten Browserprofil und melde dich danach über die Dashboard-Funktion ab, um den lokal gespeicherten Key zu entfernen. ## Connection URLs `palim_create_connection_url` erzeugt eine URL mit einem `ctxu_`-Token für Clients, die keine eigenen HTTP-Header senden können. Der rohe Token wird serverseitig nur gehasht gespeichert. Pro Account können höchstens fünf nicht widerrufene Connection Tokens existieren. Connection URLs haben aktuell keine öffentliche Verwaltungs- oder Widerrufsoberfläche. Erzeuge sie deshalb nur, wenn Header- oder OAuth-Authentifizierung nicht möglich ist, und behandle die gesamte URL wie ein Passwort. ## Prompts und Personalisierung Source: https://www.usepalim.com/de/docs/workflows/prompts-and-personalization/ Der Palim-MCP-Server liefert verbundenen Clients bereits Anweisungen für proaktive Suche und Context Checkpoints. Dauerhafte Client-Anweisungen verstärken dieses Verhalten und passen es an deinen Arbeitsalltag an. Sie ersetzen weder die Palim-Verbindung noch die Aktivierung des Connectors im aktuellen Chat. Anweisungen erhöhen die Zuverlässigkeit, erzwingen aber keinen Tool-Aufruf. Prüfe wichtige Abläufe mit dem [Zuverlässigkeitstest](#zuverlässigkeit-testen). Wenn Palim im aktuellen Client oder Chat nicht verfügbar ist, kann ein Prompt den Connector nicht selbst aktivieren. ## Grundanweisung zum Kopieren Verwende diesen Text als globale oder projektbezogene Anweisung. Kürze ihn nur, wenn dein Client ein Zeichenlimit hat. ```text Palim ist mein dauerhaftes, toolübergreifendes Gedächtnis. Nutze Palim vor deiner Antwort, wenn ich mich auf frühere Arbeit, Entscheidungen, ein benanntes Projekt, einen Zeitraum oder die Fortsetzung einer Aufgabe beziehe. Lade zu Beginn umfangreicher Projektarbeit den Brain-Überblick und stütze Aussagen über frühere Arbeit auf die gefundenen Palim-Daten. Verwende für Themen palim_search oder palim_get_context, für Zeiträume palim_search_by_date_range und für vollständige gefundene Chats erst bei Bedarf palim_get_session oder palim_get_sessions. Behaupte nicht, Palim verwendet zu haben, wenn kein Palim-Tool erfolgreich geantwortet hat. Lege nach substanziellen Ergebnissen, Entscheidungen, verlässlichen Erkenntnissen oder Richtungswechseln einen kompakten Context Checkpoint mit palim_save_context an. Verwende innerhalb desselben Chats dieselbe Session-ID weiter. Speichere den vollständigen Nachrichtenverlauf mit palim_save_session nur, wenn ich das ausdrücklich wünsche oder der vollständige Verlauf tatsächlich benötigt wird. Dauerhafte Fakten, Präferenzen oder projektübergreifende Entscheidungen gehören als einzelne Memory nach Palim. Speichere keine trivialen Gespräche, Secrets oder Inhalte, deren Speicherung ich untersage. Wenn Palim nichts findet oder nicht verfügbar ist, sage das klar und erfinde keinen früheren Kontext. ``` Diese Anweisung bildet das aktuelle MCP-Verhalten ab: kompakte Checkpoints sind der proaktive Standard, vollständige Chat-Archive nicht. ## Den richtigen Ort im Client wählen ### ChatGPT - Nutze **Custom Instructions** für eine kontoweite Grundregel. - Nutze **Project Instructions**, wenn Palim nur für ein bestimmtes Projekt oder mit projektspezifischen Tags eingesetzt werden soll. Project Instructions gelten innerhalb des Projekts und überschreiben dort globale Custom Instructions. - Wähle Palim im betreffenden Chat zusätzlich per `@Palim` oder über **+ → More** aus. Eine Custom Instruction aktiviert die App nicht automatisch. Siehe auch [ChatGPT Custom Instructions](https://help.openai.com/en/articles/8096356-custom-instructions), [Projects in ChatGPT](https://help.openai.com/en/articles/10169521-using-projects-in-chatgpt-496) und [Apps in ChatGPT](https://help.openai.com/en/articles/11487775-connectors-in-chatgpt). ### Claude und Claude Code - In Claude gelten **Profile Preferences** kontoweit; **Project Instructions** eignen sich für ein bestimmtes Projekt. - In Claude Code gehört die kurze, dauerhafte Grundregel in `CLAUDE.md`. Anthropic beschreibt diese Datei als Kontext, nicht als technische Durchsetzung. - Verwende einen Skill für einen längeren, wiederholbaren Ablauf wie Projektübernahme, Wochenrückblick oder Übergabe. Siehe auch [Claude-Personalisierung](https://support.anthropic.com/en/articles/10185728-understanding-claude-s-personalization-features), [Claude Projects](https://support.anthropic.com/en/articles/9519177-how-can-i-create-and-manage-projects), [CLAUDE.md](https://docs.anthropic.com/en/docs/claude-code/memory) und [Claude Code Skills](https://docs.anthropic.com/en/docs/claude-code/skills). ### Cursor - Hinterlege die Grundregel als persönliche oder projektbezogene Cursor Rule. - Wenn dein Repository bereits eine von Cursor gelesene `AGENTS.md` verwendet, kann die projektspezifische Palim-Regel dort gemeinsam mit den übrigen Agent-Anweisungen stehen. - Halte die Regel kurz. Einen mehrstufigen Palim-Ablauf lagerst du in einen Skill aus, sofern deine Cursor-Version Agent Skills unterstützt. Die aktuellen Oberflächen und Speicherorte stehen in den [Cursor Docs](https://cursor.com/docs). ### Codex - Nutze `~/.codex/AGENTS.md` für deine persönliche, repositoryübergreifende Palim-Regel. - Nutze `AGENTS.md` im Repository für Projektname, Tags und projektspezifische Übergaben. - Lege wiederholbare Palim-Abläufe als Skill unter `.agents/skills//SKILL.md` im Repository oder unter `~/.agents/skills//SKILL.md` für deinen Benutzer an. Siehe auch [Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md.md) und [Build skills](https://learn.chatgpt.com/docs/build-skills.md). ### Perplexity - Nutze die **Custom Instructions** in den Kontoeinstellungen für die allgemeine Palim-Regel. - Nutze die **Custom AI Instructions** eines Projects für projektspezifische Arbeitsweisen. - Stelle in der Mac App trotzdem sicher, dass der Palim-Connector für den Thread verfügbar ist. Wenn du kein Project verwendest, beginne einen wichtigen Thread mit der kurzen Startanweisung weiter unten. Siehe auch [Perplexity Account Settings](https://www.perplexity.ai/help-center/en/articles/10352993-account-settings) und [Perplexity Projects](https://www.perplexity.ai/help-center/en/articles/10352961-what-are-spaces). ### n8n und eigene Agents Füge die Grundregel in den System Prompt des Agent-Nodes beziehungsweise in den System Prompt deines eigenen MCP-Clients ein. Tool-Verfügbarkeit, MCP-Initialisierung und `mcp-session-id` müssen unabhängig davon technisch korrekt eingerichtet sein. ## Prompts für den Alltag ### Frühere Arbeit fortsetzen ```text Fahre mit dem Projekt Atlas fort. Prüfe vor deiner Antwort in Palim den bisherigen Stand, die letzten Entscheidungen und offene Punkte. Nenne kurz, auf welche gespeicherten Informationen du dich stützt. ``` ### Eine Entscheidung wiederfinden ```text Was haben wir zum Auth-Flow entschieden? Suche zuerst in Palim. Wenn mehrere Stände widersprüchlich sind, nenne die Daten und frage nach, welcher gilt. ``` ### Einen Zeitraum zusammenfassen ```text Fasse zusammen, was letzte Woche im Projekt Atlas passiert ist. Verwende die Palim-Datumssuche und trenne Entscheidungen, Ergebnisse und offene Punkte. ``` ### Einen Arbeitsstand übergeben ```text Halte den aktuellen Stand als kompakten Palim Context Checkpoint fest. Die Zusammenfassung muss Ziel, Entscheidungen, verlässliche Erkenntnisse, aktuellen Stand, offene Punkte und den nächsten sinnvollen Schritt enthalten. ``` ### Den vollständigen Chat archivieren ```text Speichere diesen vollständigen Chat in Palim als "Auth-Review Juli". Verwende die Tags auth und atlas und nimm eine vollständige Summary auf. ``` ### Eine dauerhafte Memory anlegen ```text Merke dir dauerhaft in Palim: Im Projekt Atlas verwenden wir PostgreSQL 15. Speichere das als einzelne projektbezogene Memory, nicht als vollständige Session. ``` ### Veraltete Information korrigieren ```text Suche die Palim Memory zur PostgreSQL-Version im Projekt Atlas. Ändere sie von 15 auf 16 und zeige mir anschließend den aktualisierten Inhalt. ``` ### Speicherung für einen Inhalt untersagen ```text Verwende diesen Inhalt nur für die aktuelle Antwort. Speichere ihn weder als Context Checkpoint noch als Session oder Memory in Palim. ``` ### Kurzer Startprompt Nutze diese Variante, wenn dein Client keine dauerhaften Anweisungen unterstützt: ```text Nutze Palim in diesem Thread als mein toolübergreifendes Gedächtnis: Suche bei Bezug auf frühere Arbeit vor der Antwort, speichere nach substanziellen Ergebnissen einen kompakten Context Checkpoint und speichere niemals Secrets, triviale Inhalte oder ausdrücklich ausgeschlossene Informationen. ``` ## Zuverlässigkeit testen Verwende ausschließlich synthetische Testdaten, zum Beispiel den Marker `palim-test-`. Prüfe Tool-Aufrufe im Client oder kontrolliere das Ergebnis im Dashboard. ### 1. Verbindung und Tools ```text Palim Help ``` **Erwartung:** Der Client ruft `palim_help` auf und zeigt verfügbare Palim-Tools. Eine allgemeine Erklärung ohne Tool-Aufruf reicht nicht. ### 2. Proaktiver Checkpoint Führe mit dem Agent eine kleine, aber substanzielle Planungsaufgabe aus und verwende dabei einen eindeutigen Testmarker. Bitte nicht ausdrücklich um Speicherung. **Erwartung:** Nach dem Ergebnis ruft der Agent `palim_save_context` auf. Der Checkpoint enthält eine eigenständige Summary, aber keinen vollständigen Nachrichtenverlauf. ### 3. Automatischer Abruf Öffne einen neuen Chat und frage ohne ausdrückliche Palim-Anweisung: ```text Welche Entscheidung haben wir bei palim-test- getroffen und was ist der nächste Schritt? ``` **Erwartung:** Der Agent sucht vor der Antwort in Palim und kennzeichnet klar, wenn nichts gefunden wurde. ### 4. Opt-out ```text Bearbeite diese synthetische Notiz, speichere diesen Chat und seinen Inhalt aber nicht in Palim: palim-nosave-. ``` **Erwartung:** Es entsteht kein neuer Checkpoint, keine Session und keine Memory mit diesem Marker. ### 5. Clientübergreifende Übergabe Erstelle in Client A einen Checkpoint und frage in Client B nach demselben Marker. **Erwartung:** Client B findet Ziel, Entscheidungen, aktuellen Stand und nächste Schritte, ohne dass du den ursprünglichen Chat kopierst. Prüfe zuerst, ob Palim im aktuellen Chat aktiviert ist und Tools sichtbar sind. Prüfe danach, ob die dauerhafte Anweisung im richtigen Scope liegt. Funktioniert ein ausdrücklicher Palim-Prompt, aber der automatische Aufruf nicht, hat der Client die Verhaltensanweisung nicht zuverlässig angewendet; formuliere die Regel kürzer und konkreter. ## Optionaler Palim-Skill Ein Skill ist sinnvoll, wenn dein Agent regelmäßig denselben mehrstufigen Palim-Ablauf ausführt. Für eine einzelne statische Regel sind Custom Instructions, Project Instructions, `CLAUDE.md` oder `AGENTS.md` einfacher und günstiger. Lege eine Datei `palim-workflow/SKILL.md` mit diesem Inhalt an: ```md --- name: palim-workflow description: Use when a task continues earlier work, needs prior project decisions, creates a substantial result, or requires a handoff through Palim. Do not use for trivial exchanges or content excluded from storage. --- # Palim workflow 1. Before answering continuity questions, retrieve Palim context. - Use `palim_get_brain` at the start of substantial project work. - Use `palim_search` or `palim_get_context` for a topic. - Use `palim_search_by_date_range` for a stated time period. - Load complete sessions only when the summary is insufficient. 2. Ground claims about earlier work in successful Palim results. If nothing is found, say so; never invent prior context. 3. After a substantial result, decision, reliable finding, or change of direction, call `palim_save_context` with a self-contained handoff. Reuse the session ID returned earlier in the same chat. 4. Use `palim_save_session` only when a complete transcript is explicitly useful or requested. 5. Store durable facts, preferences, and standing decisions with `palim_add_memory`. 6. Never store trivial exchanges, secrets, or content the user excluded from Palim. 7. Do not announce routine Palim calls unless the result affects the answer or the user asks for confirmation. ``` Installiere den Skill nur in Clients, die Agent Skills unterstützen. Prüfe danach mit einem Prompt wie **„Fahre mit Projekt Atlas dort fort, wo wir aufgehört haben“**, ob der Skill geladen und Palim vor der Antwort abgefragt wird. # Documentation (en) ## Understanding Palim Source: https://www.usepalim.com/en/docs/ Palim connects MCP-compatible AI tools to a shared knowledge base. Connected agents save a compact work state after substantial results by default. Complete chats are stored only when the agent uses `palim_save_session`. Another connected tool can retrieve the saved content later. ## The four building blocks | Building block | Best for | Content | | --- | --- | --- | | **Context snapshot** | Hand-offs between AI tools | A compact work state without the complete message history | | **Session** | Traceable chat history | A full conversation with messages, summary, and metadata | | **Memory** | Durable facts and decisions | A single piece of information that can be edited or deleted | | **Brain** | An overview of recurring topics | A topic view derived from saved content in the dashboard | The Palim MCP server instructs connected agents to call `palim_save_context` after important results, decisions, or changes of direction. This stores a compact, self-contained summary – not the complete message transcript. Trivial conversations, secrets, and content you asked not to persist should not be stored. ## A typical workflow 1. Connect at least one AI client to Palim. 2. Work on a substantial task. The connected agent will normally create a context checkpoint afterward. 3. Open another connected tool later. 4. Ask: **“What did we decide about the auth flow in Project Atlas?”** Palim searches the stored content and returns matching results to the client. The AI then decides how to use those results in its response. You can still request a checkpoint explicitly: **“Capture the current state for my other AI tools.”** To store the complete chat instead, say: **“Save this complete chat to Palim.”** ## What search supports today Palim uses PostgreSQL full-text search and text matching. You can also filter by date range, tags, project, and source. Semantic embedding search is not implemented yet. Create an account, connect a client, and save your first context. Learn when to use sessions, context snapshots, memories, search, and exports. ## Quickstart Source: https://www.usepalim.com/en/docs/getting-started/ ## 1. Create an account Open [api.usepalim.com/setup](https://api.usepalim.com/setup), register, and sign in. OAuth is the simplest option for most desktop clients. For clients without OAuth support, create an API key on the setup page. An API key grants access to your Palim data. Do not share it and only store it in your client's secure configuration. ## 2. Connect your first client Use the matching [integration guide](https://www.usepalim.com/en/docs/integrations/) for Cursor, Claude, ChatGPT, or Perplexity. The shared MCP endpoint is: ```text https://api.usepalim.com/mcp ``` For OAuth-compatible clients, this URL is usually all you need. Your browser opens the Palim sign-in flow on the first connection attempt. ## 3. Verify the connection Open a new chat in the connected client and say: ```text Palim Help ``` The client should call `palim_help` and show an overview of the available Palim tools. If the client cannot see the tool, first check whether Palim is enabled for the current chat. ## 4. Save your first work state After a substantial result, a connected agent should automatically create a compact context checkpoint. You can also request the checkpoint explicitly: ```text Capture the current state for my other AI tools. ``` The client uses `palim_save_context` for this. The checkpoint contains a self-contained summary but no complete message transcript. To archive the complete conversation instead, say: ```text Save this complete chat as "My first Palim chat". ``` ## 5. Retrieve the context Open another connected client and ask: ```text Search Palim for my first Palim chat and summarize the work state. ``` If Palim returns a result, the complete save-and-retrieve loop works. ## Next step Read [Using Palim](https://www.usepalim.com/en/docs/workflows/) to choose context snapshots, sessions, and memories intentionally. Then use [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) to tune your AI client for Palim and test the behavior. ## Connect AI clients Source: https://www.usepalim.com/en/docs/integrations/ Every client connects to the same hosted MCP endpoint: ```text https://api.usepalim.com/mcp ``` Authentication depends on the client. Use OAuth when the client supports OAuth for remote MCP servers. Otherwise, use an API key from the [Palim setup page](https://api.usepalim.com/setup). Remote MCP with OAuth or `mcp.json`. An in-app connector or one CLI command. Developer Mode, OAuth without OIDC, and `@Palim` in each chat. The supported flow for the Perplexity Mac app. OAuth, API keys, and generic remote MCP. ## After every connection Start a new chat and say `Palim Help`. The client must show `palim_help` in its tool list. In ChatGPT, you must also enable Palim for every conversation with `@Palim`. The technical connection alone does not guarantee automatic retrieval. [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) provides a copyable base instruction, the right location in each client, and a reliability test. ## Connection methods | Method | When to use it | Secret stored in client | | --- | --- | --- | | OAuth | Cursor, Claude, Claude Code, ChatGPT, Antigravity | No | | `x-api-key` | Perplexity Mac, n8n, raw HTTP/JSON-RPC clients | Yes | | Connection URL | Only when a client cannot send headers and you explicitly generate one in Palim | Token is part of the URL | ## Supported connection paths | Client | Documented path | Authentication | Special requirement | | --- | --- | --- | --- | | Cursor | Remote MCP in Settings or `mcp.json` | OAuth | No additional `config.json` is required. | | Claude Desktop | Custom connector | OAuth | No manual desktop config entry is required. | | Claude Code | `claude mcp add --transport http` | OAuth | Browser sign-in on first use. | | ChatGPT | Custom app in Developer Mode | OAuth | Disable OIDC and enable Palim in every chat with `@Palim`. | | Perplexity Mac | Advanced connector with `mcp-remote` | `x-api-key` | The web connector is not the currently supported path. | | Antigravity | Remote MCP URL | OAuth | The MCP endpoint is sufficient. | | n8n and custom clients | Streamable HTTP | `x-api-key` | Observe `initialize` and `mcp-session-id`. | Client product interfaces change independently of Palim. If a menu label differs, the MCP endpoint, authentication method, and requirements in the matching guide remain authoritative. ## ChatGPT Source: https://www.usepalim.com/en/docs/integrations/chatgpt/ ChatGPT requires a plan or workspace where Developer Mode and custom apps are available. ## Create the connector 1. Open **Settings → Apps → Advanced Settings**. 2. Enable **Developer Mode**. 3. Choose **Create app**. 4. URL: `https://api.usepalim.com/mcp`. 5. Authentication: **OAuth**. 6. Open the advanced OAuth settings and disable **OIDC enabled**. 7. Create the app and complete sign-in and authorization in your browser. With OIDC enabled, the connection can fail with “Authorization Request Expired” or “Token exchange failed.” ## Use Palim in a chat Connecting Palim in Settings is not enough. Type `@` in the chat composer, select **Palim**, and then enter your request. You must do this for every new conversation. ## Personalize the behavior Use global **Custom Instructions** for an account-wide Palim rule or **Project Instructions** for one project. The instruction makes proactive retrieval and checkpoints more likely but does not activate the Palim app itself. Copy the template from [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/). ## Test ```text @Palim Palim Help ``` If ChatGPT cannot see any tools, remove the app, recreate it with OIDC disabled, and add it to the chat again with `@Palim`. ## Claude Desktop and Claude Code Source: https://www.usepalim.com/en/docs/integrations/claude/ ## Claude Desktop Claude Desktop uses the connector dialog for hosted remote MCP servers: 1. Open **Settings → Connectors**. 2. Choose **Add custom connector**. 3. Name: `Palim`. 4. Remote MCP Server URL: `https://api.usepalim.com/mcp`. 5. Add the connector and complete OAuth. You do not need an API key or a manual `claude_desktop_config.json` for this flow. ## Claude Code Run this command in your terminal: ```bash claude mcp add --transport http palim https://api.usepalim.com/mcp ``` Claude Code opens the OAuth flow on first use. Then check the connection: ```bash claude mcp list ``` ## Personalize the behavior Use account-wide Profile Preferences or Project Instructions in Claude. In Claude Code, put the short base rule in `CLAUDE.md`; a longer repeatable workflow can become a skill. See [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) for templates and test steps. ## Test Ask Claude or Claude Code for `Palim Help`. If Palim is missing, remove the connection, add it again, and complete the browser sign-in flow. ## Cursor Source: https://www.usepalim.com/en/docs/integrations/cursor/ ## Through Settings 1. Open **Settings → Tools & MCP**. 2. Add a new MCP server. 3. Use `https://api.usepalim.com/mcp` as the URL. 4. Complete the Palim sign-in flow in your browser. ## Through `mcp.json` Add the server to `~/.cursor/mcp.json` or the project-level `.cursor/mcp.json`: ```json { "mcpServers": { "palim": { "url": "https://api.usepalim.com/mcp" } } } ``` Cursor starts the OAuth flow on the first connection attempt. This flow does not require an API key. ## Personalize the behavior Store the short Palim base rule as a personal or project-scoped Cursor Rule. If your repository already uses `AGENTS.md`, the project-specific rule can also live there. See [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) for the complete text, reliability test, and optional skill. ## Test Open a new Agent chat and say `Palim Help`. If Cursor shows “No tools,” disconnect the server in **Tools & MCP**, reconnect it, and complete the OAuth flow. No additional local `config.json` file is required. ## Antigravity and other MCP clients Source: https://www.usepalim.com/en/docs/integrations/other-clients/ ## Antigravity Add `https://api.usepalim.com/mcp` as a remote MCP server. Antigravity starts the OAuth flow on first use; this flow does not require an API key. ## Generic clients with an API key Clients without OAuth can send the key created on the setup page as a header: ```http x-api-key: palim_... ``` This applies to clients such as n8n MCP Client and custom JSON-RPC integrations. Send `initialize` first and carry the `mcp-session-id` header returned by the server on subsequent stateful HTTP calls. ## n8n Use an MCP Client node or the MCP Client credentials available in your n8n version: 1. Transport: **Streamable HTTP**. 2. Server URL: `https://api.usepalim.com/mcp`. 3. Authentication: custom header. 4. Header name: `x-api-key`. 5. Header value: your `palim_...` API key. Store the key in n8n credentials, not directly in a workflow field or prompt. The client must perform MCP initialization and carry the returned `mcp-session-id` on subsequent stateful requests. ## Raw JSON-RPC The first request is an `initialize` call to `/mcp` with `Content-Type: application/json`, `Accept: application/json, text/event-stream`, and the `x-api-key` header. Carry the `mcp-session-id` from the response into later requests, then send `notifications/initialized` before calling a method such as `tools/list`. One POST to `tools/call` without a preceding `initialize` request and the session ID is not a complete MCP handshake. ## Tune agent behavior Add the Palim base instruction to the system prompt of your n8n agent node, Antigravity project, or custom client. See [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) for the instruction and technical reliability test. The prompt does not replace `initialize`, authentication, or session headers. ## Clients without header support An already connected agent can use `palim_create_connection_url` to create a connection URL. Each account can have at most five active connection tokens. There is currently no public management or revocation interface. Treat the URL like a password and prefer OAuth or `x-api-key` whenever possible. ## Compatibility check A client is generally compatible if it supports remote MCP over Streamable HTTP and allows either OAuth or custom HTTP headers. Visible tool names and the way a connector is enabled for a chat vary by product. ## Perplexity Mac app Source: https://www.usepalim.com/en/docs/integrations/perplexity/ The currently supported Perplexity flow uses the **Mac app**, its advanced connector configuration, and an API key. Create the key at [api.usepalim.com/setup](https://api.usepalim.com/setup). ## Configuration In Perplexity, open **Settings → Connectors → Add Connector → Advanced** and add: ```json { "args": [ "mcp-remote", "https://api.usepalim.com/mcp", "--header", "x-api-key:${PALIM_API_KEY}" ], "command": "npx", "env": { "PALIM_API_KEY": "YOUR_PALIM_API_KEY" }, "useBuiltInNode": true } ``` Save the connector and restart Perplexity. Do not share this configuration because it contains your API key. The custom connector flow in Perplexity's web interface is currently unreliable. Use the Mac app for Palim. ## Personalize the behavior Use your account Custom Instructions or a Perplexity Project's Custom AI Instructions. Independently, make sure the Palim connector is available to the thread. See [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) for a short starter instruction and the reliability test. ## Test Open a new thread with the Palim connector enabled and ask for `Palim Help`. ## MCP tool reference Source: https://www.usepalim.com/en/docs/reference/ The server provides the tools below. Which tools a client actually displays also depends on server configuration, authentication method, and, where applicable, staff access. ## Checkpoints and sessions - `palim_save_context` — Default proactive checkpoint: updates a compact summary without a message transcript. - `palim_save_session` — Stores or extends a complete chat with messages, summary, and metadata. - `palim_list_sessions` — Lists sessions with filters for source, tags, status, and date range. - `palim_browse_sessions` — Returns a machine-readable session list for UI and browser clients. - `palim_get_session` — Loads one complete session. - `palim_get_sessions` — Loads up to 15 sessions in one call. - `palim_show_session` — Renders a session as a readable message view. - `palim_get_summary` — Loads only a session summary. - `palim_list_summaries` — Lists session summaries without complete messages. - `palim_create_summary` — Adds a summary to a session that does not have one yet. - `palim_update_session_metadata` — Changes title, tags, project, status, or creation date. - `palim_update_session_references` — Adds or replaces source URLs. - `palim_export_session` — Exports a session as Markdown, JSON, or text. - `palim_delete_session` — Sets status `deleted` by default; `hard_delete: true` deletes permanently. - `palim_find_similar` — Finds similar sessions using keyword and content matching. - `palim_get_stats` — Returns inventory and activity statistics. ## Search and retrieval - `palim_search` — Full-text and text search with optional metadata filters. - `palim_search_by_date_range` — Filters sessions by date and optional tags, project, and tool source. It does not additionally search message content. - `palim_get_context` — Finds relevant sessions and formats them into a compact context block. Search is not currently embedding- or vector-based. For encrypted content, Palim performs decrypted text matching inside the server process. Exact title phrases can work less reliably in full-text search than several characteristic terms, tags, or a project filter. ## Memories - `palim_add_memory` — Stores one fact, decision, preference, insight, or note. - `palim_search_memories` — Searches memories by text, type, and tags. - `palim_update_memory` — Changes a memory's content, type, tags, or metadata. - `palim_delete_memory` — Permanently deletes a memory. ## Brain - `palim_get_brain` — Loads the topic index without arguments, or a complete topic with `topic`. - `palim_export_brain` — Exports every topic as an Obsidian-compatible Markdown vault. - `palim_update_brain_topic` — Creates, edits, renames, or deletes a topic. - `palim_backfill_brain` — Catches up as many as 1,000 existing sessions that have a summary. ## User context, rules, and profile - `palim_set_user_context` — Sets a user-owned context block when user modeling is enabled in the environment. - `palim_get_user_context` — Reads that context block. - `palim_add_user_rule` — Creates a durable workflow or behavior rule. - `palim_list_user_rules` — Lists the user's rules. - `palim_update_user_rule` — Changes a rule's content, activation, tags, or order. - `palim_delete_user_rule` — Deletes a rule. - `palim_get_user_profile` — Reads the inferred user profile. Currently limited to approved staff accounts in production. - `palim_update_user_profile` — Changes consent, refinement, and profile fields. Currently limited to approved staff accounts in production. ## Account, connection, and maintenance - `palim_register` — Registers an account and returns a new API key. Normal hosted usage should use the setup page. - `palim_login` — Signs in to an existing account and creates a new API key. - `palim_logout` — Deletes all API keys by default and attempts to revoke OAuth sessions. - `palim_create_connection_url` — Creates a URL containing a connection token in HTTP mode. Maximum five active tokens per account. - `palim_help` — Shows a categorized overview of Palim tools. - `palim_migrate_encryption` — Migrates legacy plaintext content. Defaults to preview with `dry_run: true`; not a normal end-user workflow. ## Beta and limits Palim is currently a free beta; paid plans are not active yet. There is no published per-plan storage quota today. Individual tools do have technical per-call limits, including: - `palim_get_sessions`: at most 15 session IDs per call - `palim_list_sessions`: at most 100 results - `palim_list_summaries`: at most 200 results - `palim_backfill_brain`: at most 1,000 scanned sessions - connection URLs: at most five active tokens per account Future pricing, storage quotas, or plan limits will be published before paid plans are activated. ## Security and privacy Source: https://www.usepalim.com/en/docs/security/ ## Encryption at rest Supported content fields are encrypted on the server with AES-256-GCM before they are stored in the database. Palim uses scrypt to derive a separate key for each user from a server-managed master key. | Data class | Encrypted content | Readable operational metadata | | --- | --- | --- | | Sessions | Messages, summary text, and structured summary fields | Session ID, title, status, tool source, timestamps, project, tags, source URLs, and a `summary_preview` of up to 280 characters for context checkpoints | | Memories | Content; encrypted copies of tags and additional memory metadata also exist | ID, type, user association, timestamps, and the tags and additional metadata in fields that are currently readable as well | | Brain | Markdown content of a topic | Slug, title, hook, entry count, source-session IDs, and timestamps. The hook can contain a short summary excerpt. | | User modeling | Encrypted copies are created for user context, rules, and profiles | The corresponding content or profile fields are currently also stored in readable form. These features depend on deployment configuration; profiles are staff-only in production. | This metadata remains readable for association, filtering, navigation, and operation. “Encrypted” therefore does not mean that every database value is encrypted. The Palim server can decrypt content to provide search, retrieval, and export. The server runtime and master key are therefore part of the trust boundary. ## Account isolation Authentication and database policies associate stored data with one user. OAuth clients do not receive shared credentials. API keys are user-specific and should be rotated immediately if exposed. ## Your controls - Connected agents create proactive context checkpoints after substantial results by default. These contain a compact summary, not the complete message transcript automatically. - You can prohibit storage of individual content; secrets and trivial conversations should not be stored. - Sessions can be inspected, changed through MCP metadata tools, and deleted. Their messages and summary are not generally editable. - Memories can be inspected, edited, and permanently deleted. - Individual sessions can be exported in open formats. - The Brain view can be exported as a Markdown vault. - Palim does not use your stored conversations to train models. A single complete export covering every data class is not currently available. Contact [privacy@usepalim.com](mailto:privacy@usepalim.com) for account deletion or privacy requests. ## Processing by connected AI tools Palim returns decrypted search results and stored content to the AI client that calls the tool. From that point, the data-processing terms of the connected AI provider also apply. Normal Brain distillation runs deterministically on the Palim server and uses stored session summaries. If a Brain topic exceeds its size limit and an Anthropic API key is configured on the server, Palim may send the decrypted topic content to Claude Haiku for consolidation. Without a configured Anthropic API key, this external consolidation step does not run. ## Work securely 1. Prefer OAuth over API keys when your client supports it. 2. Store API keys only in secret or connector configuration. 3. Do not share connection URLs; their token is an access credential. 4. Review exported files before sharing them. 5. Delete or rotate credentials after a possible leak. See [Manage data and credentials](https://www.usepalim.com/en/docs/workflows/data-management/) for the exact differences between status deletion, permanent dashboard deletion, API keys, and connection URLs. ## Troubleshooting Source: https://www.usepalim.com/en/docs/troubleshooting/ ## Palim or its tools are missing 1. Verify that `https://api.usepalim.com/mcp` is entered exactly. 2. Disconnect the connector and connect it again. 3. Complete the browser sign-in flow. 4. Start a new chat and ask for `Palim Help`. 5. In ChatGPT, add Palim to the current conversation with `@Palim`. Cursor and other SSE/Streamable HTTP clients do not require an extra `config.json` beyond their normal MCP configuration. ## ChatGPT: Authorization Request Expired Remove the Palim app and create it again. Select OAuth and disable **OIDC enabled** in the advanced settings. Complete sign-in without a long interruption, then enable `@Palim` in the chat. ## Authentication failed or invalid API key - Remove whitespace before or after the key. - Use the `x-api-key` header. - Create a new key on the setup page and replace the old one. - Never paste API keys into chat messages or screenshots. ## Perplexity cannot connect Use the Perplexity Mac app and its [advanced configuration](https://www.usepalim.com/en/docs/integrations/perplexity/). The custom connector in the web interface is currently unreliable. ## Search cannot find a known chat - Use several terms from the content instead of an exact title phrase only. - Add tags, a project, or tool source to your search. - For time-based questions, use `palim_search_by_date_range`. - `palim_search_by_date_range` filters by date and metadata but does not additionally search message content. - Encrypted content uses text matching; semantic embeddings are not available yet. ## Palim should not store specific content Tell the connected agent explicitly: `Do not save this chat or this content to Palim.` The server instruction for proactive checkpoints excludes content you asked not to persist. There is currently no global opt-out setting covering every connected client. If a context checkpoint was already created, find and delete the session. Note the difference between the `deleted` status and permanent deletion in [Manage data and credentials](https://www.usepalim.com/en/docs/workflows/data-management/). ## The Brain is empty despite saved sessions The Brain uses session summaries. Ask an agent to call `palim_backfill_brain` or use **Catch up existing sessions** in the dashboard. Sessions without a summary cannot be distilled during catch-up. ## Get help Send a short description, client name, timestamp, and visible error message to [hello@usepalim.com](mailto:hello@usepalim.com). Never include API keys, connection URLs, or private chat content. ## Using Palim day to day Source: https://www.usepalim.com/en/docs/workflows/ ## Work state or complete chat? ### Context snapshot `palim_save_context` is the default checkpoint for handing work to another AI tool. The MCP server instructs connected agents to call it proactively after substantial results, decisions, or changes of direction. The client creates a self-contained, compact work state with the goal, decisions, current status, and next steps – without storing the complete message transcript. ```text Capture the current state for my other AI tools. ``` ### Session Use `palim_save_session` when the full conversation should remain traceable. ```text Save this complete chat as "July auth review" and tag it with auth and atlas. ``` Use a context snapshot for the default hand-off and a session for an explicitly requested full archive. Trivial conversations, secrets, and content you asked not to persist should not be included in a checkpoint. If your AI client does not use Palim reliably on its own, copy the base instruction from [Prompts and personalization](https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/) into its durable instructions. That guide also includes everyday prompts, a cross-client reliability test, and an optional agent skill. ## Find saved content | Intent | Example | Matching tool | | --- | --- | --- | | Find keywords | “Search for database migration” | `palim_search` | | Date range and project | “What happened in Atlas last week?” | `palim_search_by_date_range` | | Retrieve an overview | “Give me context about the auth flow” | `palim_get_context` | | Read a complete chat | “Show session abc-123” | `palim_show_session` | Search currently uses full-text and text matching. Try several characteristic terms, tags, or a project when an exact title phrase is not found. ## Manage memories Memories are best for single, durable facts and decisions: ```text Remember: Project Atlas uses PostgreSQL 15. ``` Use `palim_search_memories` to find saved facts. `palim_update_memory` corrects outdated content, and `palim_delete_memory` permanently removes a memory. ## Brain and dashboard The [Palim dashboard](https://api.usepalim.com/dashboard) shows sessions, memories, and the Brain view built from saved session summaries. It lets you search, inspect, and manage your data. Read [Brain and dashboard](https://www.usepalim.com/en/docs/workflows/brain-and-dashboard/) for topic creation, catch-up, editing, and exact deletion behavior. Automated user profiles are currently limited to approved staff accounts in production and are not part of the general Palim offering. ## Metadata, exports, and deletion - `palim_update_session_metadata` changes a title, tags, project, or date. - `palim_update_session_references` adds source URLs. - `palim_export_session` exports a session as Markdown, JSON, or text. - `palim_export_brain` creates a Markdown/Obsidian export of the Brain view. - `palim_delete_session` sets a session to the `deleted` status by default. With `hard_delete: true`, the session, messages, and summary are permanently removed. Deleting a session in the dashboard always uses the permanent variant. There is currently no public restore operation for sessions with the `deleted` status. See [Manage data and credentials](https://www.usepalim.com/en/docs/workflows/data-management/) for exports, deletion, and credential behavior. ## Brain and dashboard Source: https://www.usepalim.com/en/docs/workflows/brain-and-dashboard/ ## What the Brain stores When Brain distillation is enabled on the server, Palim processes the already stored summary of a new or updated session. The complete message transcript is not evaluated again for this step. A topic contains: - dated decisions - open items - a dated session log with the title and a short summary excerpt The session project is preferred as the topic. If no project is present, Palim uses the first `key_topic`; if that is missing as well, the entry goes to `Inbox`. Entries are normalized, deduplicated, and capped to keep each topic compact. The Brain is an editable, thematic distillation of stored session summaries. It is not an embedding index or an automatically verified knowledge graph. ## Catch up existing sessions Sessions saved before the Brain was introduced may not appear automatically. Use **Catch up existing sessions** in the dashboard or ask an agent to call `palim_backfill_brain`. The catch-up scans up to 1,000 existing sessions, uses only sessions with a summary, and deduplicates content that was already processed. It can therefore be run again without intentionally duplicating identical entries. ## Manage the Brain In the dashboard, you can: - open and search topics - create a topic manually - edit its title, hook, and Markdown content - merge two topics - permanently delete a topic - export the Brain as an Obsidian-compatible Markdown vault Agents can perform the same core operations through `palim_get_brain`, `palim_update_brain_topic`, `palim_backfill_brain`, and `palim_export_brain`. During a merge, the target topic receives the deduplicated entries and the source topic is then deleted. ## Dashboard areas | Area | Current behavior | | --- | --- | | Overview | Shows totals, recent activity, and recently saved sessions. | | Brain | Read, create, edit, merge, delete, catch up, and export topics. | | Memories | Create, filter, edit, and permanently delete memories. | | Timeline | Read and permanently delete sessions. Session content is not editable there. | | Connect | Shows the MCP endpoint and API-key configuration for additional clients. | The dashboard always uses permanent deletion for sessions. It removes the session, messages, and summary. This differs from `palim_delete_session` without `hard_delete`, which only sets the status to `deleted`. ## Automatic consolidation of large topics Topics have fixed size and entry limits. When a topic grows beyond them, Palim trims older entries and marks it for consolidation. If an Anthropic API key is configured on the server, Palim may send the decrypted topic content to Claude Haiku to merge duplicates and remove resolved open items. Without a configured Anthropic API key, this external consolidation step does not run. ## Manage data and credentials Source: https://www.usepalim.com/en/docs/workflows/data-management/ ## Export sessions `palim_export_session` exports one session as Markdown, JSON, or text. `palim_export_brain` returns the complete Brain as an Obsidian-compatible Markdown vault. A single complete account export covering every data class is not currently available. ## Delete sessions | Action | Result | | --- | --- | | `palim_delete_session` without `hard_delete` | Sets the session status to `deleted`. Messages and summary remain stored. | | `palim_delete_session` with `hard_delete: true` | Permanently removes the session, messages, and summary. | | Delete in the dashboard | Always uses permanent deletion. | There is currently no public restore operation for sessions with the `deleted` status. Always verify the session ID and title before permanent deletion. Memories and Brain topics are always removed permanently when deleted. Complete account deletion is currently available only through [privacy@usepalim.com](mailto:privacy@usepalim.com). ## API keys Registration and sign-in on the [setup page](https://api.usepalim.com/setup) create a new API key. The raw key is shown only when it is issued; the server stores a hash for validation. `palim_logout` deletes all API keys for the account by default and attempts to revoke all OAuth sessions. OAuth revocation requires an active OAuth/JWT session and cannot be completed from a pure API-key connection. To delete only the API key used by the current connection, call `palim_logout` with `delete_all_api_keys: false` and, if appropriate, `revoke_oauth_sessions: false`. That client will then need a new key. The dashboard stores the entered API key in browser Local Storage and sends it as `x-api-key` with every dashboard API request. Do not use the dashboard in a shared browser profile, and use the dashboard sign-out action afterward to remove the locally stored key. ## Connection URLs `palim_create_connection_url` creates a URL containing a `ctxu_` token for clients that cannot send custom HTTP headers. The server stores only a hash of the raw token. Each account can have at most five non-revoked connection tokens. Connection URLs currently have no public management or revocation interface. Create one only when header-based authentication or OAuth is not possible, and treat the complete URL like a password. ## Prompts and personalization Source: https://www.usepalim.com/en/docs/workflows/prompts-and-personalization/ The Palim MCP server already provides connected clients with instructions for proactive retrieval and context checkpoints. Durable client instructions reinforce that behavior and adapt it to your daily workflow. They do not replace the Palim connection or activation of the connector in the current chat. Instructions improve reliability but cannot force a tool call. Verify important workflows with the [reliability test](#test-reliability). If Palim is not available in the current client or chat, a prompt cannot activate the connector by itself. ## Copy the base instruction Use this text as a global or project-specific instruction. Shorten it only when your client has a character limit. ```text Palim is my persistent, cross-tool memory. Use Palim before answering when I refer to earlier work, decisions, a named project, a time period, or continuing a task. At the start of substantial project work, load the Brain overview and ground claims about earlier work in retrieved Palim data. Use palim_search or palim_get_context for topics, palim_search_by_date_range for time periods, and palim_get_session or palim_get_sessions only when complete found chats are actually needed. Do not claim that Palim was used unless a Palim tool returned successfully. After substantial results, decisions, reliable findings, or changes of direction, create a compact context checkpoint with palim_save_context. Reuse the same session ID within the current chat. Store the full message transcript with palim_save_session only when I explicitly request it or the complete transcript is genuinely needed. Store durable facts, preferences, or standing decisions as individual Palim memories. Do not store trivial conversations, secrets, or content I excluded from storage. If Palim finds nothing or is unavailable, say so clearly and never invent prior context. ``` This instruction reflects the current MCP behavior: compact checkpoints are the proactive default; complete chat archives are not. ## Choose the right place in each client ### ChatGPT - Use **Custom Instructions** for an account-wide base rule. - Use **Project Instructions** when Palim should apply only to one project or needs project-specific tags. Project Instructions apply inside that project and override global Custom Instructions there. - Also select Palim in the relevant chat with `@Palim` or through **+ → More**. A Custom Instruction does not activate the app automatically. See [ChatGPT Custom Instructions](https://help.openai.com/en/articles/8096356-custom-instructions), [Projects in ChatGPT](https://help.openai.com/en/articles/10169521-using-projects-in-chatgpt-496), and [Apps in ChatGPT](https://help.openai.com/en/articles/11487775-connectors-in-chatgpt). ### Claude and Claude Code - In Claude, **Profile Preferences** apply account-wide; **Project Instructions** fit one specific project. - In Claude Code, put the short durable rule in `CLAUDE.md`. Anthropic describes this file as context, not technical enforcement. - Use a skill for a longer repeatable workflow such as project takeover, weekly review, or handoff. See [Claude personalization](https://support.anthropic.com/en/articles/10185728-understanding-claude-s-personalization-features), [Claude Projects](https://support.anthropic.com/en/articles/9519177-how-can-i-create-and-manage-projects), [CLAUDE.md](https://docs.anthropic.com/en/docs/claude-code/memory), and [Claude Code Skills](https://docs.anthropic.com/en/docs/claude-code/skills). ### Cursor - Store the base rule as a personal or project-scoped Cursor Rule. - If your repository already uses an `AGENTS.md` that Cursor reads, the project-specific Palim rule can live there with the other agent instructions. - Keep the rule short. Move a multi-step Palim workflow into a skill when your Cursor version supports Agent Skills. See the current surfaces and storage locations in the [Cursor Docs](https://cursor.com/docs). ### Codex - Use `~/.codex/AGENTS.md` for your personal Palim rule across repositories. - Use a repository `AGENTS.md` for the project name, tags, and project-specific handoffs. - Store repeatable Palim workflows as a skill under `.agents/skills//SKILL.md` in a repository or `~/.agents/skills//SKILL.md` for your user. See [Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md.md) and [Build skills](https://learn.chatgpt.com/docs/build-skills.md). ### Perplexity - Use account **Custom Instructions** for the general Palim rule. - Use a Project's **Custom AI Instructions** for project-specific behavior. - In the Mac app, still make sure the Palim connector is available to the thread. If you do not use a Project, begin an important thread with the short starter instruction below. See [Perplexity Account Settings](https://www.perplexity.ai/help-center/en/articles/10352993-account-settings) and [Perplexity Projects](https://www.perplexity.ai/help-center/en/articles/10352961-what-are-spaces). ### n8n and custom agents Put the base rule in the agent node's system prompt or in your custom MCP client's system prompt. Tool availability, MCP initialization, and the `mcp-session-id` must still be configured correctly outside the prompt. ## Everyday prompts ### Continue earlier work ```text Continue Project Atlas. Before answering, retrieve the previous state, latest decisions, and open items from Palim. Briefly identify which stored information you are relying on. ``` ### Retrieve a decision ```text What did we decide about the auth flow? Search Palim first. If multiple saved states conflict, identify their dates and ask which one applies. ``` ### Summarize a time period ```text Summarize what happened in Project Atlas last week. Use Palim's date search and separate decisions, results, and open items. ``` ### Hand off the work state ```text Capture the current state as a compact Palim context checkpoint. The summary must include the goal, decisions, reliable findings, current state, open items, and the next sensible step. ``` ### Archive the complete chat ```text Save this complete chat to Palim as "Auth review July". Use the tags auth and atlas and include a complete summary. ``` ### Store a durable memory ```text Remember this in Palim: Project Atlas uses PostgreSQL 15. Store it as one project-specific memory, not as a complete session. ``` ### Correct outdated information ```text Find the Palim memory about the PostgreSQL version in Project Atlas. Change it from 15 to 16, then show me the updated content. ``` ### Exclude content from storage ```text Use this content only for the current answer. Do not store it as a Palim context checkpoint, session, or memory. ``` ### Short starter prompt Use this version when your client does not support durable instructions: ```text Use Palim in this thread as my cross-tool memory: retrieve earlier work before answering, create a compact context checkpoint after substantial results, and never store secrets, trivial content, or information I explicitly exclude. ``` ## Test reliability Use synthetic test data only, such as the marker `palim-test-`. Inspect tool calls in the client or verify the result in the dashboard. ### 1. Connection and tools ```text Palim Help ``` **Expected:** The client calls `palim_help` and shows available Palim tools. A generic explanation without a tool call does not pass. ### 2. Proactive checkpoint Complete a small but substantial planning task with the agent and include a unique test marker. Do not explicitly request storage. **Expected:** After producing the result, the agent calls `palim_save_context`. The checkpoint has a self-contained summary but no complete message transcript. ### 3. Automatic retrieval Open a new chat and ask without explicitly mentioning Palim: ```text What decision did we make for palim-test-, and what is the next step? ``` **Expected:** The agent searches Palim before answering and clearly states when nothing was found. ### 4. Opt out ```text Process this synthetic note, but do not store this chat or its content in Palim: palim-nosave-. ``` **Expected:** No new checkpoint, session, or memory containing that marker appears. ### 5. Cross-client handoff Create a checkpoint in client A and ask for the same marker in client B. **Expected:** Client B retrieves the goal, decisions, current state, and next steps without you copying the original chat. First verify that Palim is active in the current chat and that its tools are visible. Then check whether the durable instruction is stored at the right scope. If an explicit Palim prompt works but the automatic call does not, the client did not apply the behavioral instruction reliably; make the rule shorter and more specific. ## Optional Palim skill A skill is useful when your agent repeatedly performs the same multi-step Palim workflow. For one static rule, Custom Instructions, Project Instructions, `CLAUDE.md`, or `AGENTS.md` are simpler and cheaper. Create `palim-workflow/SKILL.md` with this content: ```md --- name: palim-workflow description: Use when a task continues earlier work, needs prior project decisions, creates a substantial result, or requires a handoff through Palim. Do not use for trivial exchanges or content excluded from storage. --- # Palim workflow 1. Before answering continuity questions, retrieve Palim context. - Use `palim_get_brain` at the start of substantial project work. - Use `palim_search` or `palim_get_context` for a topic. - Use `palim_search_by_date_range` for a stated time period. - Load complete sessions only when the summary is insufficient. 2. Ground claims about earlier work in successful Palim results. If nothing is found, say so; never invent prior context. 3. After a substantial result, decision, reliable finding, or change of direction, call `palim_save_context` with a self-contained handoff. Reuse the session ID returned earlier in the same chat. 4. Use `palim_save_session` only when a complete transcript is explicitly useful or requested. 5. Store durable facts, preferences, and standing decisions with `palim_add_memory`. 6. Never store trivial exchanges, secrets, or content the user excluded from Palim. 7. Do not announce routine Palim calls unless the result affects the answer or the user asks for confirmation. ``` Install the skill only in clients that support Agent Skills. Then use a prompt such as **“Continue Project Atlas from where we left off”** to verify that the skill loads and retrieves Palim context before answering. # Published updates ## Your new dashboard – your Palim memory Source: https://www.usepalim.com/en/releases/dashboard-vault/ ## Why we built it Until now, your saved data was visible almost only inside your chats. There was no calm, central place to review, organize, and correct your knowledge profile. The dashboard lets you see and control what Palim knows about your work outside your chats. Transparency and control come first: read, edit, merge, export, and delete. ## What’s new The dashboard has been rebuilt from the ground up. Instead of pasting an API key, you now simply sign in with your Palim account — the key remains available as a fallback. Brain, memories, history, and connections live in clearly separated areas: | Area | What you do here | | --- | --- | | Overview | Inventory counts, recent activity, and your latest saved sessions at a glance. | | Brain | Open topics in a rendered reading view, edit them, create new topics, and merge duplicates. | | Memories | Create, filter, edit, and delete your saved facts. | | History | Load more sessions, open details, and remove individual sessions. | | Connect | Manage your API key and setup examples for your AI tools. | A persistent trust line keeps it visible that your content is stored encrypted. Removing a session from your history deletes it permanently — including its messages and summary. This action cannot be undone. ## How to use it Open the [Palim dashboard](https://api.usepalim.com/dashboard) and sign in with your account. The navigation gives you access to Overview, Brain, Memories, History, and Connect. Edit a topic directly, create another one with “+ New topic,” or merge related topics. ## Availability The new dashboard is available to all Palim users in German and English. How Palim builds topics from your sessions and how you manage them in the dashboard. Everyday flows: save context, find it again, and keep your memory tidy. ## A weekly email summary Source: https://www.usepalim.com/en/releases/weekly-email-summary/ ## Why we built it When you use Palim across several AI tools, it is easy to lose track of newly learned topics and when saved context actually helped. The weekly summary makes that impact visible without requiring you to open the dashboard every time. ## What’s new - The subject and primary sections show your most-used topics instead of technical tool statistics. - The email summarizes context retrievals by topic and up to three recently updated Brain topics from the last seven days. - The digest is sent in German or English according to your saved email language. - Every email links back to your Palim dashboard for the full detail. - Summaries are sent only when there is relevant activity during the period. - Links in every email let you change the language, manage delivery, or unsubscribe at any time. ## Availability The weekly summary is available to Palim accounts with a verified email address. ## How to use it There is nothing to configure: use Palim as usual to save and retrieve context. When there is relevant activity, you will receive a summary on Mondays and can follow the link to the details in your dashboard. Language and delivery can be managed from the footer of every email.