# Benvenuto in Vibedasher

**Crei le dashboard nel tuo agent harness — Claude Code, Codex, Gemini — e Vibedasher gestisce la piattaforma dati su cui girano.** Questa è la divisione. La dashboard è codice: React e SQL che il tuo agente scrive in locale, parlando con Vibedasher tramite **SDK + MCP**. Tutto ciò che sta sotto la dashboard è lavoro stateful e cumulativo che non appartiene a una sessione isolata dell'agente — connessioni, dataset, pipeline, aggiornamenti, governance, motore di query, hosting — e quella metà vive in Vibedasher, mantenuta e governata.

Il ciclo è: il tuo agente **crea** sulla piattaforma, **pubblica** su di essa, e Vibedasher **ospita, governa e serve** il risultato — un URL stabile, protetto da login e per riga, che continua a rispondere anche dopo la fine della sessione dell'agente.

## Avvio rapido — punta il tuo agente su Vibedasher[​](#avvio-rapido--punta-il-tuo-agente-su-vibedasher "Link diretto a Avvio rapido — punta il tuo agente su Vibedasher")

Il modo principale per accedere è il **server MCP**. Installalo, accedi dal browser e registralo con il tuo agente:

```
pip install 'vibedasher-mcp>=0.6.0'

vibedasher login

claude mcp add vibedasher --env VIBEDASHER_REGION=eu-central-1 -- vibedasher-mcp
```

`vibedasher login` apre il browser, tu approvi la sessione e il token di aggiornamento viene salvato nel keyring del tuo sistema operativo (un file `0600` se la macchina non ha un keyring). Niente da generare, copiare, incollare o ruotare. `vibedasher whoami` mostra chi ha eseguito l'accesso; `vibedasher logout` termina la sessione.

Oppure in qualsiasi configurazione client MCP (Claude Code, Cursor, …) — nessuna chiave nel blocco `env`:

```
{

  "mcpServers": {

    "vibedasher": {

      "command": "vibedasher-mcp",

      "env": { "VIBEDASHER_REGION": "eu-central-1" }

    }

  }

}
```

Da lì il tuo agente può caricare dati, eseguire SQL, creare e costruire dashboard, pubblicarle e gestire chi vede cosa — vedi **[Crea con il tuo agente](/it/guides/build-with-your-agent.md)** per la guida completa. Lo esegui su CI o su una macchina headless dove non può aprirsi alcun browser? Quella modalità usa invece una chiave API — vedi [Headless e CI](/it/guides/build-with-your-agent.md#headless-and-ci--use-an-api-key).

## La piattaforma che Vibedasher gestisce[​](#la-piattaforma-che-vibedasher-gestisce "Link diretto a La piattaforma che Vibedasher gestisce")

Il tuo agente scrive la dashboard; Vibedasher gestisce tutto ciò da cui la dashboard dipende:

* **Connessioni** — **19 tipi di connettori** disponibili oggi nell'app (PostgreSQL, MySQL, Snowflake, BigQuery, Redshift, Salesforce e altri) più il caricamento di CSV ed Excel, configurati una volta e interrogati da ogni superficie — strumenti MCP, SDK, l'app. L'[elenco completo, incluso ciò che non è ancora disponibile](/it/guides/connect-a-data-source.md), si trova nella pagina delle connessioni.
* **Dataset e pipeline** — dataset ingeriti, con schema introspezionato e un alias SQL stabile; **progetti dbt** per la trasformazione; **aggiornamenti** eseguiti dal nostro cron, o attivati da te o dal tuo agente — ogni pianificazione valutata in UTC.
* **Il motore di query** — SQL tipizzato sui tuoi dataset, con caching dei risultati, esposto in modo identico ad agenti (MCP), codice (SDK) e dashboard pubblicate.
* **Governance** — account reali, ruoli, gruppi e diritti di accesso allow/deny sulle cartelle, ereditati dalle dashboard e dai dataset al loro interno — più filtri per riga per singolo visualizzatore sulle dashboard incorporate, applicati lato server da un token firmato. Non una password condivisa. Vedi [Chi può vedere cosa](/it/guides/who-can-see-what.md) per ciò che il modello copre e ciò che non copre.
* **Hosting e distribuzione** — una dashboard pubblicata ottiene un URL stabile che continua a rispondere anche dopo la fine della sessione dell'agente; pubblica, dietro il tuo login, oppure incorporata nel tuo stesso prodotto. **Quello che ospitiamo è un bundle renderizzato lato client**: React che gira nel browser del visitatore su dati serviti via SQL, senza nulla del tuo codice server nel percorso della richiesta — quindi un framework con rendering lato server (Next.js, Remix, SvelteKit, Astro, Nuxt) non può essere ospitato così com'è. Quello stack viene instradato invece che rifiutato: tieni il tuo server e portaci i dati di questo account con l'SDK, oppure [espelli la dashboard](/it/guides/eject-your-dashboard.md) e ospitala tu. Meglio saperlo prima di costruire che dopo.

E il codice della dashboard resta tuo — è semplice React e SQL che puoi [espellere](/it/guides/eject-your-dashboard.md) e ospitare altrove, in qualsiasi momento. Una dashboard pubblica e pubblicata viene espulsa su una [corsia dati senza credenziali](/it/guides/the-wasm-query-lane.md): nessuna chiave, nessun token, nessun backend tuo.

## Dove andare ora[​](#dove-andare-ora "Link diretto a Dove andare ora")

<!-- -->

## [📄️Guide](/it/guides/build-with-your-agent.md)

[Crea da Claude Code tramite MCP, collega i dati, pubblica e condividi — e cosa la piattaforma non farà.](/it/guides/build-with-your-agent.md)

## [📄️API & SDKs](/it/api/overview.md)

[La superficie programmatica sotto le tue dashboard: SDK, autenticazione, incorporazione.](/it/api/overview.md)

## [📄️Riferimento API](/it/reference/vibedasher-sdk-api.md)

[Ogni endpoint, raggruppato per risorsa, con esempi curl / Python / Node.js.](/it/reference/vibedasher-sdk-api.md)

## Vibedasher Cloud o Vibedasher Server[​](#vibedasher-cloud-or-vibedasher-server "Link diretto a Vibedasher Cloud o Vibedasher Server")

Stessa architettura, due modi per eseguirla:

* **Vibedasher Cloud** — completamente gestito su [cloud.vibedasher.com](https://cloud.vibedasher.com), a consumo, non per postazione. Crea un account, esegui `vibedasher login`, punta il tuo agente su di esso.
* **Vibedasher Server** — self-hosted nella tua VPC, con il tuo LLM se usi l'assistente integrato nell'app. I tuoi dati non lasciano mai il tuo ambiente.

note

Vibedasher è in sviluppo attivo e questa documentazione cresce insieme ad essa — se qualcosa manca o non è chiaro, contattaci tramite la [pagina di contatto](https://vibedasher.com/contact).