Vai al contenuto
Space Context Sviluppatori

Il livello di contesto per il mondo fisico

I tuoi agenti conoscono il tuo codice, i tuoi documenti e il tuo calendario, ma nulla dei luoghi in cui vivi e lavori.
Filma uno spazio una volta: Space Context trasforma il video in contesto strutturato e con le fonti, che ogni agente può leggere, cercare e interrogare.

  • Chiavi di test gratis
  • Prima scansione reale gratis
  • 1,00 $ a scansione
  • Nessun abbonamento

ConsoleSpaziBrisbane apartment

Test

Brisbane apartment spc_demo

appartamento · scansionato via API · 2 scansioni

  • Contesto profondo
  • 3 aree
  • 38 oggetti
  • 4 problemi

Aree3

  • Open-plan Living, Dining and Kitchen 18 oggetti buono
  • Bedroom 6 oggetti discreto
  • Bathroom 14 oggetti discreto

Punti chiave2

  • Fuse box electrical panel In the hallway cupboard behind the coats · dalla narrazione
  • Main water shutoff valve water shutoff Under the bathroom sink · dalla narrazione

Inventario38

  • Capsule coffee machine Open-plan Living, Dining and Kitchen buono
  • Portable fan heater Bathroom danneggiato
  • Double bed with wooden headboard Bedroom buono
  • Hairdryer Bathroom non valutato

Domanda POST /v1/spaces/spc_demo/ask

Where is the fuse box?

The fuse box is in the Open-plan Living, Dining and Kitchen, in the hallway cupboard behind the coats.

Fuse box (Open-plan Living, Dining and Kitchen) · dalla narrazione

What is broken in the bathroom?

The portable heater has a loose cable and must not be used until repaired.

"documented": true

Fonte

Bathroom: Loose heater cable (frame-30, 0:30) Loose heater cable alta Bathroom · issue iss_2 frame-30 · 0:30
Output reale dell’API: lo spazio dimostrativo, un bilocale a Brisbane scansionato due volte (foto al check-in, video narrato al check-out). I record sono in inglese, come li restituisce l’API. Foto di Chris Olszewski (Kgbo), CC BY-SA 4.0; la narrazione è inventata per la demo (ATTRIBUTION.txt). Esplora tutto lo spazio demo, senza registrarti (in inglese) →

Funziona con

  • Claude
  • Claude Code
  • ChatGPT
  • Codex
  • Cursor
  • VS Code
  • Node.js / TypeScript
  • Qualsiasi client HTTP
  • Qualsiasi client MCP con server remoti

Quickstart

Quattro modi di entrare. Un solo Space Document.

Collega un assistente senza scrivere codice, scansiona dal terminale o chiama l’API dal tuo prodotto.
Una chiave di test gratuita fa girare tutto sullo spazio dimostrativo.

Claude Code · Codex · Claude · ChatGPT · Cursor · VS Code
# Claude Code
claude mcp add --transport http --scope user spacecontext https://mcp.spacecontext.app/mcp

# Codex
codex mcp add spacecontext --url https://mcp.spacecontext.app/mcp
codex mcp login spacecontext

# Claude, ChatGPT, Cursor, VS Code: add a custom connector with this URL
# https://mcp.spacecontext.app/mcp

Nessuna chiave da incollare: accedi tu, scegli cosa l’assistente può vedere, e riceve una propria chiave che puoi revocare quando vuoi. Collega un assistente

Pronto in 2 minuti

Fallo configurare al tuo agente

Dai un solo prompt al tuo agente di programmazione, oppure segui tu cinque passi. Le chiavi di test sono gratuite.

Incollalo in Claude Code, Cursor, Codex o ChatGPT: configura tutto e ti chiede solo di approvare l’accesso.

Prompt di configurazione
Configura Space Context per me.
1. Aggiungi il server MCP di Space Context a questo strumento. Claude Code: `claude mcp add --transport http --scope user spacecontext https://mcp.spacecontext.app/mcp`. Codex: `codex mcp add spacecontext --url https://mcp.spacecontext.app/mcp` e poi `codex mcp login spacecontext`. Cursor: aggiungi {"mcpServers":{"spacecontext":{"url":"https://mcp.spacecontext.app/mcp"}}} a ~/.cursor/mcp.json. Qualsiasi altro client (GitHub Copilot, Gemini CLI, Windsurf…): aggiungi il server MCP remoto https://mcp.spacecontext.app/mcp (Streamable HTTP, OAuth). L’accesso nel browser lo faccio io.
2. Installa la skill di Space Context: salva https://spacecontext.app/.well-known/agent-skills/spacecontext/SKILL.md come ~/.claude/skills/spacecontext/SKILL.md (Claude Code), oppure tienila come istruzioni del progetto.
3. Per il codice: `npm install @spacecontext/sdk`, poi esegui `npx spacecontext login` e aspetta che io approvi il codice nel browser (la chiave viene salvata in locale; non stamparla mai e non metterla in un commit).
4. Leggi https://spacecontext.app/developers/docs/llms.txt, poi elenca i miei spazi. Le scansioni reali richiedono una carta salvata nella console (aggiungerla non addebita nulla; la prima scansione reale di un nuovo account è gratuita, una per carta).
Dove incollarlo
  • Claude Code
  • Cursor
  • Codex
  • GitHub Copilot
  • Gemini CLI
  • Windsurf

Che cosa ottieni

Tutto ciò che un agente deve sapere di un luogo

Space Context trasforma il video di uno spazio fisico in contesto strutturato e ricercabile per gli agenti AI: stanze, oggetti e dove si trovano, condizioni, problemi, punti chiave come la chiusura dell'acqua, e come funzionano le cose, con i fotogrammi originali come prova.

Qualche esempio d’uso: confrontare check-in e check-out, o ingresso e uscita da una casa; inventari di affitti e immobili; prove per i sinistri assicurativi; e ciò che un agente deve sapere di un ufficio o di una struttura. Qualsiasi spazio che puoi filmare funziona allo stesso modo. La guida a check-in e check-out (in inglese)

  • Lo Space Document

    Aree con tipo e condizioni; oggetti con posizione, quantità, marca e i nomi con cui le persone li cercano; problemi con gravità e prossimo passo; punti chiave; istruzioni d’uso; fatti; e ciò che il video non ha mostrato.

    JSON · versionato
    Un oggetto dello spazio dimostrativo, come lo restituisce l’API
    {
      "id": "itm_32",
      "name": "Portable fan heater",
      "category": "climate",
      "location": "On the floor below the left side of the vanity",
      "condition": {
        "code": "damaged",
        "notes": "The power cable is visibly loose."
      },
      "issue_ids": ["iss_2"],
      "evidence": [
        { "frame_id": "frame-28", "timestamp_ms": 28087 },
        { "frame_id": "frame-30", "timestamp_ms": 30058 }
      ]
    }
  • Fotogrammi di prova

    Ogni record cita i fotogrammi del video originale in cui è stato visto, con link firmati a breve scadenza. Ogni oggetto, problema e punto chiave è poi ricontrollato da un secondo modello su fino a quattro di quei fotogrammi: in foto, non confermato, o dalla narrazione quando non ne cita nessuno.

    URL firmati
    • frame-0: Cream upholstered sofa with dark cushions 0:00
    • frame-15: Capsule coffee machine 0:15
    • frame-24: Loose bedroom electrical cable 0:24
    • frame-30: Loose heater cable 0:30
    Fotogrammi del video di check-out della demo, ognuno con un record che documenta
  • Risposte con le fonti

    Una risposta breve dai soli record dello spazio, con fonti e foto, oppure «non documentato». Mai un’ipotesi da una casa tipica.

    POST /ask
  • Ricerca tra gli spazi

    «Dove ho visto una scala?» trova il record in qualsiasi tuo spazio, in qualsiasi lingua: ricerca semantica con riordino.

    GET /search
  • Confronto tra scansioni

    Check-in contro check-out: oggetti aggiunti, spostati, ricontati; spariti solo se un fotogramma mostra il posto vuoto; problemi nuovi o risolti.

    GET /diff
  • Agent Skill e Markdown

    Esporta uno spazio come cartella skill che ogni agente carica quando serve, o come una pagina Markdown da incollare in un ticket o in un prompt.

    SKILL.md
  • Eventi in diretta e webhook

    Segui una scansione come flusso di eventi; ricevi scan.completed e scan.failed firmati sul tuo server, con tentativi ripetuti.

    SSE · HMAC
  • Ripresa guidata

    Cosa riprendere per ogni tipo di spazio, da appartamenti e uffici ad auto, barche, camper ed elettrodomestici; ogni fotogramma controllato in circa mezzo secondo: usabile o no, quali punti chiave mostra.

    POST /frames/check

Come funziona

Da un video del sopralluogo a un agente che conosce il posto

Nessuna pipeline da costruire: invii il video, segui la scansione, leggi il risultato.

  1. Filma

    Percorri lo spazio con il telefono: un video fino a 10 minuti e 4 GB, o fino a 120 foto. Di’ ciò che la camera non vede: il Wi-Fi, i bidoni, dov’è il quadro elettrico.

  2. Scansiona

    Una chiamata da SDK, CLI, un assistente o la console. L’analisi gira da noi, senza ffmpeg da parte tua, e comunica ogni fase mentre avviene.

  3. Il tuo agente lo conosce

    Leggi lo Space Document, cercalo, interrogalo con le fonti, confrontalo con la scansione successiva, o dallo a Claude come skill.

Ogni scansione, in diretta

GET /scans/{id}/events invia subito la scansione e poi a ogni cambiamento, come Server-Sent Events, fino allo stato finale. Webhook per i server che non possono tenere una connessione aperta.

  1. Reading the video
  2. Checking the frames
  3. Looking at the frames
  4. Writing the report
  5. Extracting the context
  6. Saving
  7. Verifying the evidence
  8. Complete

Prezzi

Gratis per sviluppare. 1,00 $ a scansione reale.

Nessun piano da scegliere e nessun abbonamento: un saldo prepagato in dollari, usato solo per le scansioni reali.
Leggere, cercare e chiedere è incluso.
Prezzi al netto delle imposte applicabili.

  • Test

    Gratis

    Costruisci tutta l’integrazione prima di pagare qualcosa.

    • Lo spazio dimostrativo: due scansioni reali di un bilocale
    • Chiavi di test gratuite, senza carta
    • Ogni endpoint, l’SDK e la CLI
    • Le scansioni finiscono all’istante e niente viene addebitato
    Crea una chiave di test gratis
  • Volumi più alti

    Parliamone

    Molti spazi, molte scansioni, o limiti oltre quelli standard.

    • Limiti più alti su scansioni, ricerche e domande
    • Un contatto diretto con chi sviluppa l’API
    Contattaci

Paghi a consumo, senza abbonamento, e il saldo non scade mai.

Tutti i prezzi e le domande

Sicurezza

Fatto per essere dato in mano a un agente

Gli spazi contengono password, codici delle porte e frasi dette in video.
Space Context decide che cosa un agente può leggere prima che lo legga.

  • Oscuramento per scope

    Password del Wi-Fi, codici di porte e allarmi restano nascosti a ogni chiave senza lo scope spaces:sensitive: nei documenti, nei risultati di ricerca, nelle risposte e negli export.

  • Le istruzioni nei video sono dati

    Un cartello o una frase in video che prova a dare ordini a un’AI viene trattenuto prima che un agente lo legga e prima dei modelli che scrivono il documento, e segnalato nel documento.

  • File conservati nell’UE

    Video e fotogrammi sono conservati su Cloudflare R2 nella giurisdizione UE, e il video sorgente viene cancellato appena estratti i fotogrammi.

  • Webhook firmati

    HMAC-SHA256 su marca temporale e corpo, inviati solo a host HTTPS pubblici, mai rediretti, ritentati con backoff.

  • Prove dal video originale

    Ogni record rimanda ai fotogrammi in cui è stato visto, serviti con link firmati a breve scadenza.

  • Chiavi sotto il tuo controllo

    Salvate come hash, mostrate una volta, con scope e un tetto mensile di spesa facoltativo. Ogni collegamento MCP ha la propria chiave; il registro di audit conserva chi ha fatto cosa per 400 giorni.

Sicurezza e privacy

Per gli agenti

Fatto per essere letto dalle macchine

Un server MCP remoto con OAuth, e i file che gli agenti cercano, agli indirizzi dove li cercano.

  • Leggere, cercare, chiedere, confrontare

    list_spaces, search_spaces, get_space per sezione o get_space_markdown in una pagina, ask_space con le fonti, compare_scans, get_evidence_photo.

  • Scansionare, con il tuo consenso

    Consenti la scansione quando colleghi e l’assistente può creare una scansione, caricare i fotogrammi, avviarla e seguirla in diretta; prima ti dice il prezzo.

  • Il testo è un dato, mai un’istruzione

    Etichette, biglietti e frasi che provano a dare ordini a un’AI vengono trattenuti prima che un agente li legga e prima dei modelli che scrivono il documento; il documento lo segnala.

16 strumenti · risorse · prompt · OAuth 2.1 · Streamable HTTP

File di scoperta

  • MCP server Da incollare in Claude, ChatGPT, Cursor o qualsiasi client MCP con OAuth https://mcp.spacecontext.app/mcp
  • llms.txt Ogni pagina della documentazione, una riga ciascuna, per un agente https://spacecontext.app/developers/docs/llms.txt
  • OpenAPI 3.1 Il contratto dell’API, per generare codice e validare https://api.spacecontext.app/v1/openapi.json
  • MCP Server Card Il server MCP, i suoi strumenti e come autorizza https://spacecontext.app/.well-known/mcp/server-card.json
  • Agent Skill Come un agente dovrebbe usare Space Context https://spacecontext.app/.well-known/agent-skills/spacecontext/SKILL.md
  • auth.md Come un agente ottiene e usa le credenziali https://spacecontext.app/auth.md

Domande

Altro? Scrivi a support@finikos.it

Che cos’è Space Context?

Space Context è il livello di contesto per il mondo fisico: filmi uno spazio una volta (app per iPhone, API, CLI o SDK) e diventa uno Space Document strutturato e con le fonti — stanze, oggetti e dove si trovano, condizioni, problemi, punti chiave, come funzionano le cose, con i fotogrammi originali come prova — che gli agenti AI leggono tramite un’API REST, un SDK TypeScript, una CLI e un server MCP remoto.

Quali assistenti AI funzionano con il server MCP di Space Context?

Claude (claude.ai e Claude Desktop), Claude Code, ChatGPT, Codex, Cursor e VS Code, ognuno con i suoi passi nella documentazione, e qualsiasi client che supporta i server MCP remoti con OAuth: aggiungi l’URL del server, accedi nel browser e scegli che cosa l’assistente può vedere.

Che cos’è lo Space Document?

Il JSON versionato in cui si trasforma uno spazio, lo stesso per gli spazi scansionati con l’app e via API: aree con tipo e condizioni; oggetti con posizione, quantità, marca e i nomi con cui le persone li chiamano; problemi con gravità e prossimo passo; punti chiave come la chiusura dell’acqua o il quadro elettrico; istruzioni d’uso; fatti; domande e risposte; e ciò che il video non ha mostrato. Ogni record cita i fotogrammi del video originale in cui è stato visto.

Posso usarlo per inventari e check-in/check-out?

Sì, come due esempi tra tanti. Scansioni uno spazio al check-in o all’ingresso e di nuovo al check-out o all’uscita, e il confronto elenca gli oggetti aggiunti, spostati o ricontati, quelli spariti solo se un fotogramma mostra il posto vuoto, e i problemi nuovi o risolti, con le foto di entrambe le scansioni. Lo stesso documento serve come inventario di un affitto o di un immobile, come prova per un sinistro assicurativo, o come ciò che un agente sa di un ufficio.

Che cosa serve per iniziare?

Un account (lo stesso dell’app per iPhone; accedendo lo crei) e una chiave di test dalla console. Niente carta e nessun costo: il quickstart richiede circa cinque minuti sullo spazio dimostrativo.

Serve una carta?

Non per sviluppare: le chiavi di test sono gratuite e non richiedono una carta. Le scansioni reali richiedono una carta salvata; salvarla nella console non addebita nulla, e la prima scansione reale di un nuovo account è gratuita (una scansione gratuita per carta).

Che cosa posso inviare?

Un video (MP4, MOV, M4V, 3GP, WebM o Matroska, fino a 4 GB e 10 minuti) o fino a 120 foto. L’analisi gira da noi: niente ffmpeg, nessuna estrazione di fotogrammi da parte tua.

Quanto dura una scansione, e quanto costa?

Qualche minuto, seguita in diretta. La prima scansione reale è gratuita; poi 1,00 $ l’una, da un saldo prepagato ricaricabile da 10 $. Una scansione fallita viene rimborsata sul saldo.

Il mio agente può scansionare da solo?

Sì. Tramite SDK o API con una chiave che ha scans:write, oppure via MCP se consenti la scansione al momento del collegamento. Gli agenti possono anche controllare un fotogramma prima di scansionare.

Come so che un record è giusto?

Ogni oggetto, problema e punto chiave cita i fotogrammi del video originale in cui è stato visto, e un secondo modello, che risponde a domande chiuse con probabilità e non scrive mai testo, lo ricontrolla su fino a quattro di quei fotogrammi: in foto (0,7 o più su uno di essi) o non confermato. Un record che non cita fotogrammi viene dalla narrazione, e un guasto o un’assenza non si vedono in una foto: nessuno dei due è controllato su una foto. Fatti, istruzioni e domande e risposte non sono controllati su una foto. Misurato il 2026-10-13 sul check-out della demo: 38 oggetti su 38 confermati su uno dei loro fotogrammi, e nessuna conferma sbagliata in 227 controlli degli oggetti di una stanza su fotogrammi di altre stanze. Mentre filmi, ogni fotogramma è controllato per i punti chiave del tipo di spazio; lo stesso giorno, su 191 foto etichettate a mano, i punti chiave misurati hanno avuto una precisione di 1,00 a 0,7, tranne le dotazioni di sicurezza (0,89); gli allacciamenti degli elettrodomestici non sono ancora misurati.

Dove sono conservati i dati, e chi li vede?

Video e fotogrammi sono conservati su Cloudflare R2 nella giurisdizione UE, e il video sorgente viene cancellato appena estratti i fotogrammi. I fornitori AI che li analizzano sono indicati nell’informativa privacy. I valori sensibili restano nascosti alle chiavi senza lo scope sensibile.

Posso usare gli spazi scansionati con l’app per iPhone?

Sì. Li leggi via API, console e MCP con lo stesso account, senza costi. Le scansioni via API si pagano dal saldo, mai con i crediti dell’app.

È open source?

SDK, CLI, server MCP, contratto OpenAPI e documentazione sono MIT su GitHub. La pipeline di analisi gira nell’API.

Filma uno spazio una volta.
I tuoi agenti lo conoscono dalla chiamata successiva.

Blog

Dal blog

Tutti gli articoli