Documentazione

Come si usa fractal

fractal è la memoria a lungo termine dei tuoi agenti: tiene i fatti in ordine per argomento, aggiorna quelli che cambiano e restituisce solo quello che serve. Qui trovi come collegarlo, cosa fa e come lo chiami.

Perché non un database vettoriale

Un database vettoriale conserva pezzi di testo e li ritrova per somiglianza. fractal ci costruisce sopra un albero che si organizza da solo, con due orologi: quando un agente impara un fatto che contraddice uno vecchio, il vecchio scade (non viene cancellato) e il nuovo diventa quello attuale. Così la domanda «cosa sapevamo in quella data» ha ancora una risposta.

Ogni agente ha la sua memoria: nessuno legge quella di un altro senza un permesso esplicito.

Avvio rapido

1. Apri il pannello (14 giorni di prova gratuita).
2. In Chiavi crea una chiave: la chiave è l'identità dell'agente, non serve nessun altro id.
3. Collega il tuo agente con uno dei metodi qui sotto.

claude mcp add --transport http fractal https://getfractal.it/mcp

Vuoi tenere i dati in casa? Sta arrivando un'applicazione da installare sul tuo computer o server: le memorie restano da te.

Collega un agente (MCP)

Claude Desktop, Claude Code, Cursor e qualunque client che parli il Model Context Protocol collegano fractal come server remoto, sul trasporto StreamableHTTP di MCP.

L'indirizzo è https://getfractal.it/mcp, con la chiave come token Bearer. Per un client che si configura con un file JSON:

{
  "mcpServers": {
    "fractal": {
      "url": "https://getfractal.it/mcp",
      "headers": { "Authorization": "Bearer fr_..." }
    }
  }
}

Una volta collegato, l'agente trova strumenti come memory_add, memory_recall e memory_maintain. L'elenco preciso dipende dalle capacità che hai dato a quella chiave.

API HTTP

Ogni strumento MCP è anche una rotta REST, sotto /api/v1/<strumento>: stessi permessi, stesso comportamento, generati dalla stessa fonte così che i due non possano divergere. L'elenco completo è in /api/openapi.json.

curl -X POST https://getfractal.it/api/v1/memory_add \
  -H "Authorization: Bearer fr_..." \
  -H "Content-Type: application/json" \
  -d '{ "text": "Preferisce le interfacce scure." }'

Il resto della documentazione

• Integrazioni (in inglese): LangGraph, LangChain, Pydantic AI e la libreria in-process.