# Bem-vindo à Vibedasher

**Você constrói painéis no seu próprio agente de IA — Claude Code, Codex, Gemini — e a Vibedasher mantém a plataforma de dados sobre a qual eles rodam.** Essa é a divisão. O painel é código: React e SQL que seu agente escreve localmente, se comunicando com a Vibedasher através do **SDK + MCP**. Tudo o que está por baixo do painel é trabalho stateful (com estado) e cumulativo, que não pertence a uma sessão avulsa de agente — conexões, conjuntos de dados, pipelines, atualizações, governança, o mecanismo de consultas, hospedagem — e essa metade vive na Vibedasher, mantida e governada.

O ciclo é: seu agente **constrói** contra a plataforma, **publica** nela, e a Vibedasher **hospeda, governa e serve** o resultado — uma URL estável, protegida por login e por linha, que continua respondendo depois que a sessão do agente termina.

## Início rápido — aponte seu agente para a Vibedasher[​](#início-rápido--aponte-seu-agente-para-a-vibedasher "Link direto para Início rápido — aponte seu agente para a Vibedasher")

A principal forma de entrada é o **servidor MCP**. Instale-o, faça login pelo seu navegador e registre-o no seu agente:

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

vibedasher login

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

`vibedasher login` abre seu navegador, você aprova a sessão, e o token de atualização é armazenado no keyring do seu sistema operacional (um arquivo `0600` caso a máquina não tenha keyring). Nada para gerar, copiar, colar ou rotacionar. `vibedasher whoami` mostra quem está conectado; `vibedasher logout` encerra a sessão.

Ou em qualquer configuração de cliente MCP (Claude Code, Cursor, …) — sem chave no bloco `env`:

```
{

  "mcpServers": {

    "vibedasher": {

      "command": "vibedasher-mcp",

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

    }

  }

}
```

A partir daí, seu agente pode enviar dados, executar SQL, criar e construir painéis, publicá-los e gerenciar quem vê o quê — veja **[Construa com seu agente](/pt-BR/guides/build-with-your-agent.md)** para o passo a passo completo. Rodando em CI ou em uma máquina headless onde nenhum navegador pode abrir? Esse caminho usa uma chave de API em vez disso — veja [Headless e CI](/pt-BR/guides/build-with-your-agent.md#headless-and-ci--use-an-api-key).

## A plataforma que a Vibedasher mantém[​](#a-plataforma-que-a-vibedasher-mantém "Link direto para A plataforma que a Vibedasher mantém")

Seu agente escreve o painel; a Vibedasher mantém tudo aquilo de que o painel depende:

* **Conexões** — **19 tipos de conector** disponíveis no app hoje (PostgreSQL, MySQL, Snowflake, BigQuery, Redshift, Salesforce e outros) além do upload de CSV e Excel, configurados uma vez e consultados por todas as superfícies — ferramentas MCP, SDKs, o app. A [lista completa, incluindo o que ainda não está disponível](/pt-BR/guides/connect-a-data-source.md), está na página de conexões.
* **Conjuntos de dados e pipelines** — conjuntos de dados ingeridos, com esquema introspectado e um alias SQL estável; **projetos dbt** para transformação; **atualizações** executadas pelo nosso cron, ou disparadas por você ou seu agente — cada agendamento avaliado em UTC.
* **O mecanismo de consultas** — SQL tipado sobre seus conjuntos de dados, com cache de resultados, exposto de forma idêntica a agentes (MCP), código (SDKs) e painéis publicados.
* **Governança** — contas reais, papéis, grupos e direitos de acesso de permitir/negar em pastas, herdados pelos painéis e conjuntos de dados dentro delas — além de filtros por linha específicos para cada visualizador em painéis incorporados, aplicados no servidor a partir de um token assinado. Não uma senha compartilhada. Veja [Quem pode ver o quê](/pt-BR/guides/who-can-see-what.md) para o que o modelo cobre e o que não cobre.
* **Hospedagem e entrega** — um painel publicado ganha uma URL estável que continua respondendo depois que a sessão do agente termina; público, atrás do seu login, ou incorporado no seu próprio produto. **O que hospedamos é um bundle renderizado no cliente**: React rodando no navegador do visitante sobre dados servidos por SQL, sem nada do seu código de servidor no caminho da requisição — então um framework com renderização no servidor (Next.js, Remix, SvelteKit, Astro, Nuxt) não pode ser hospedado como está. Essa pilha é redirecionada em vez de recusada: mantenha seu próprio servidor e traga para ele os dados desta conta com o SDK, ou [ejete o painel](/pt-BR/guides/eject-your-dashboard.md) e hospede você mesmo. Vale saber antes de construir, não depois.

E o código do painel em si continua sendo seu — é React e SQL puros que você pode [ejetar](/pt-BR/guides/eject-your-dashboard.md) e hospedar em outro lugar, a qualquer momento. Um painel público e publicado é ejetado sobre uma [via de dados sem credenciais](/pt-BR/guides/the-wasm-query-lane.md): sem chave, sem token, sem backend seu.

## Para onde ir[​](#para-onde-ir "Link direto para Para onde ir")

<!-- -->

## [📄️Guides](/pt-BR/guides/build-with-your-agent.md)

[Construa a partir do Claude Code via MCP, conecte dados, publique e compartilhe — e o que a plataforma não fará.](/pt-BR/guides/build-with-your-agent.md)

## [📄️API & SDKs](/pt-BR/api/overview.md)

[A superfície programática por baixo dos seus painéis: SDKs, autenticação, incorporação.](/pt-BR/api/overview.md)

## [📄️API Reference](/pt-BR/reference/vibedasher-sdk-api.md)

[Todos os endpoints, agrupados por recurso, com exemplos em curl / Python / Node.js.](/pt-BR/reference/vibedasher-sdk-api.md)

## Vibedasher Cloud ou Vibedasher Server[​](#vibedasher-cloud-or-vibedasher-server "Link direto para Vibedasher Cloud ou Vibedasher Server")

Mesma arquitetura, duas formas de executá-la:

* **Vibedasher Cloud** — totalmente gerenciada em [cloud.vibedasher.com](https://cloud.vibedasher.com), com preço por uso, não por assento. Crie uma conta, execute `vibedasher login` e aponte seu agente para ela.
* **Vibedasher Server** — auto-hospedada na sua própria VPC, com seu próprio LLM caso use o assistente integrado ao app. Seus dados nunca saem do seu ambiente.

observação

A Vibedasher está em desenvolvimento ativo e esta documentação cresce junto com ela — se algo estiver faltando ou não estiver claro, entre em contato pela [página de contato](https://vibedasher.com/contact).