Cambio ospite negli affitti brevi: la checklist completa
Cosa controllare a ogni cambio ospite stanza per stanza, gli obblighi su CIN, rilevatori di gas e monossido ed estintori, e come documentare tutto con un video.
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.
Brisbane apartment spc_demo
Aree3
Punti chiave2
Inventario38
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 narrazioneWhat is broken in the bathroom?
The portable heater has a loose cable and must not be used until repaired.
"documented": true Fonte
Loose heater cable alta Bathroom · issue iss_2 frame-30 · 0:30 Quickstart
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
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
npx spacecontext login --test # a free test key, approved in the console
npx spacecontext ask spc_demo "where is the fuse box?"
npx spacecontext skill spc_demo --out ./brisbane-apartment-skill
npx spacecontext scan ./flat.mp4 --name "Seaside flat" --format markdown login --test mostra un codice da approvare nella console, e torna una chiave di test gratuita; senza --test ottieni una chiave reale. Ogni comando accetta --json. Comandi della CLI
import { SpaceContext } from '@spacecontext/sdk';
const sc = new SpaceContext({ apiKey: process.env.SPACECONTEXT_API_KEY });
const { spaceId, document } = await sc.scan('./flat.mp4', {
name: 'Seaside flat',
onProgress: (p) => console.log(p.type === 'scan' ? p.label : p.type),
});
const answer = await sc.spaces.ask(spaceId, 'Where is the water shut-off?');
console.log(answer.answer, answer.citations); Una chiamata da un video al documento, con l’avanzamento in diretta. Tipizzato dal contratto OpenAPI, nessuna dipendenza a runtime. SDK TypeScript
API=https://api.spacecontext.app/v1
AUTH="Authorization: Bearer $SPACECONTEXT_API_KEY"
# Ask the demo space (free with a test key)
curl -X POST $API/spaces/spc_demo/ask -H "$AUTH" \
-H "Content-Type: application/json" \
-d '{"question": "Where is the water shut-off?"}'
# Follow a scan live, as Server-Sent Events
curl -N $API/scans/$SCAN_ID/events -H "$AUTH" JSON su HTTPS, un contratto OpenAPI 3.1, un solo formato d’errore con codici stabili. Panoramica dell’API
Pronto in 2 minuti
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.
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). Accedi alla console e crea una chiave. Le chiavi di test sono gratuite e funzionano sullo spazio dimostrativo.
Crea una chiave di test gratisUn solo URL del server; l’assistente apre il browser e accedi tu.
claude mcp add --transport http --scope user spacecontext https://mcp.spacecontext.app/mcp codex mcp add spacecontext --url https://mcp.spacecontext.app/mcp
codex mcp login spacecontext {
"mcpServers": {
"spacecontext": { "url": "https://mcp.spacecontext.app/mcp" }
}
} Aggiungilo a ~/.cursor/mcp.json (o .cursor/mcp.json in un progetto); Cursor mostra poi un pulsante Login.
code --add-mcp '{"name":"spacecontext","type":"http","url":"https://mcp.spacecontext.app/mcp"}' Oppure aggiungi lo stesso server a .vscode/mcp.json.
https://mcp.spacecontext.app/mcp
Claude: Impostazioni → Connettori → Aggiungi connettore personalizzato, e incolla l’URL. ChatGPT: Impostazioni → App e connettori → Avanzate → Modalità sviluppatore, poi crea un connettore con l’URL e OAuth.
In Claude Code il plugin aggiunge il server MCP e una skill che spiega a Claude come usarlo. Gli altri agenti leggono la stessa skill dal suo URL.
/plugin marketplace add finikoslab/spacecontext /plugin install spacecontext@spacecontext
https://spacecontext.app/.well-known/agent-skills/spacecontext/SKILL.md
Con una chiave di test, entrambi rispondono dallo spazio dimostrativo.
import { SpaceContext } from '@spacecontext/sdk';
const sc = new SpaceContext({ apiKey: process.env.SPACECONTEXT_API_KEY });
const answer = await sc.spaces.ask('spc_demo', 'Where is the fuse box?');
console.log(answer.answer); # A test key (sc_test_…) answers from the demo space, for free
curl -X POST https://api.spacecontext.app/v1/spaces/spc_demo/ask \
-H "Authorization: Bearer $SPACECONTEXT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question": "Where is the fuse box?"}' Aggiungi una carta nella console: non viene addebitato nulla, e la prima scansione reale di un nuovo account è gratuita (una per carta).
Aggiungi una cartaChe cosa ottieni
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)
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{
"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 }
]
} 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
0:00
0:15
0:24
0:30 Una risposta breve dai soli record dello spazio, con fonti e foto, oppure «non documentato». Mai un’ipotesi da una casa tipica.
POST /ask«Dove ho visto una scala?» trova il record in qualsiasi tuo spazio, in qualsiasi lingua: ricerca semantica con riordino.
GET /searchCheck-in contro check-out: oggetti aggiunti, spostati, ricontati; spariti solo se un fotogramma mostra il posto vuoto; problemi nuovi o risolti.
GET /diffEsporta 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.mdSegui una scansione come flusso di eventi; ricevi scan.completed e scan.failed firmati sul tuo server, con tentativi ripetuti.
SSE · HMACCosa 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/checkCome funziona
Nessuna pipeline da costruire: invii il video, segui la scansione, leggi il risultato.
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.
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.
Leggi lo Space Document, cercalo, interrogalo con le fonti, confrontalo con la scansione successiva, o dallo a Claude come skill.
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.
Prezzi
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.
Gratis
Costruisci tutta l’integrazione prima di pagare qualcosa.
1,00 $a scansione
I tuoi spazi, dai tuoi video.
Parliamone
Molti spazi, molte scansioni, o limiti oltre quelli standard.
Paghi a consumo, senza abbonamento, e il saldo non scade mai.
Sicurezza
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.
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.
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.
Video e fotogrammi sono conservati su Cloudflare R2 nella giurisdizione UE, e il video sorgente viene cancellato appena estratti i fotogrammi.
HMAC-SHA256 su marca temporale e corpo, inviati solo a host HTTPS pubblici, mai rediretti, ritentati con backoff.
Ogni record rimanda ai fotogrammi in cui è stato visto, serviti con link firmati a breve scadenza.
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.
Per gli agenti
Un server MCP remoto con OAuth, e i file che gli agenti cercano, agli indirizzi dove li cercano.
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.
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.
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
https://mcp.spacecontext.app/mcp https://spacecontext.app/developers/docs/llms.txt https://api.spacecontext.app/v1/openapi.json https://spacecontext.app/.well-known/mcp/server-card.json https://spacecontext.app/.well-known/agent-skills/spacecontext/SKILL.md https://spacecontext.app/auth.md Altro? Scrivi a support@finikos.it
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
SDK, CLI, server MCP, contratto OpenAPI e documentazione sono MIT su GitHub. La pipeline di analisi gira nell’API.
Blog
Cosa controllare a ogni cambio ospite stanza per stanza, gli obblighi su CIN, rilevatori di gas e monossido ed estintori, e come documentare tutto con un video.
Cosa chiede Airbnb per un rimborso danni, entro quando, e come documentare la casa prima e dopo ogni soggiorno con un video datato, stanza per stanza.
Deposito cauzionale e danni alla riconsegna: cosa dicono il codice civile (artt. 1588, 1590, 1609) e la legge 392/1978, e come documentare lo stato.