oleander
A pilha de dados completa para Agentes e Construtores
Documentação
Início Rápido
Conecte um agente ao oleander, envie ou conecte seus dados e faça sua primeira pergunta em minutos.
Vamos conectar seu agente, autenticar e fazer sua primeira pergunta.
Nota
Precisa de uma conta? Cadastre-se em oleander.dev.
Etapa 1: Conecte Seu Agente
Use o plugin oleander no Claude para consultar seus dados, enviar arquivos ou agendar relatórios diários.
Abra **Cowork** → **Personalizar** → **+** → **Adicionar marketplace do GitHub**. Cole `https://github.com/OleanderHQ/claude-plugin` (ou `OleanderHQ/claude-plugin`) e instale o plugin oleander.
<Frame>
<video controls className="block dark:hidden w-full rounded-xl" src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-light-add-marketplace.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=3e4816b8dbb01e193f9a5afc2b7b9d20" data-path="images/quickstart/claude-coworker-light-add-marketplace.mp4" />
<video controls className="hidden dark:block w-full rounded-xl" src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-dark-add-marketplace.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=1a3bced30d0d0f77eeb19012838e182b" data-path="images/quickstart/claude-coworker-dark-add-marketplace.mp4" />
<figcaption>Adicione e instale o marketplace oleander no Cowork</figcaption>
</Frame>
</Step>
<Step title="Add connector">
Abra **Cowork** → **Personalizar** → **Plugins** → **Oleander** → **Conectores** → **Conectar**.
<Frame>
<video controls className="block dark:hidden w-full rounded-xl" src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-light-add-connector.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=1a81be6ac11758449d694ffcc9a7254c" data-path="images/quickstart/claude-coworker-light-add-connector.mp4" />
<video controls className="hidden dark:block w-full rounded-xl" src="https://mintcdn.com/oleander/Ndoc5oxlqQKDkaAS/images/quickstart/claude-coworker-dark-add-connector.mp4?fit=max&auto=format&n=Ndoc5oxlqQKDkaAS&q=85&s=8316c2e3684d909a21ca0213d403114f" data-path="images/quickstart/claude-coworker-dark-add-connector.mp4" />
<figcaption>Adicione o conector oleander no Cowork</figcaption>
</Frame>
</Step>
<Step title="Verify the connection">
Peça ao seu agente uma verificação rápida de conexão:
> "Você está conectado ao oleander?"
O agente deve chamar `identity_get` e retornar o contexto da sua organização.
O [Plugin oleander para Claude Code](https://github.com/OleanderHQ/claude-plugin) instala o servidor MCP no Claude Code.Dica
Consulte Configuração do Claude Cowork para tarefas agendadas e implantação em toda a organização.
<Steps>
<Step title="Add plugin marketplace">
No Claude Code, adicione o marketplace oleander e instale o plugin:
```bash theme={null}
/plugin marketplace add OleanderHQ/claude-plugin
/plugin install oleander@oleander
```
Talvez seja necessário reiniciar a sessão do Claude Code antes que o servidor MCP esteja disponível.
</Step>
<Step title="Authentication">
Entre com sua conta oleander:
```bash theme={null}
claude mcp login oleander
```
Ou execute `/mcp`, selecione **oleander** e escolha **Autenticar**. Seu navegador abrirá para concluir o fluxo OAuth.
</Step>
<Step title="Verify the connection">
Confirme que o oleander está conectado:
```bash theme={null}
claude mcp list
```
Você deve ver `✓ Connected` para oleander.
Dica
Consulte Configuração do Claude para habilidades e configuração manual do MCP.
Usando um agente diferente? Consulte a configuração do Cursor, Codex e OpenCode.
Etapa 2: Conecte Seus Dados
Conecte ou envie pelo menos uma fonte de dados para começar uma conversa sobre ela com seu agente:
- Enviar um arquivo: Envie um arquivo parquet ou CSV para começar a consultar instantaneamente. Sem necessidade de configuração
- Conecte seu warehouse: Para acesso ao vivo a BigQuery, Snowflake, Postgres e catálogos Iceberg, vá para Configurações → Lake
Para testar rapidamente, baixe o conjunto de dados Iris de exemplo e envie-o em oleander.dev/app/upload.
Etapa 3: Faça Sua Pergunta
Pergunte ao seu agente em inglês simples. Por meio do servidor MCP do oleander, ele pode listar catálogos, executar SQL, enviar arquivos e agendar relatórios.
- Análises: "Qual é o comprimento médio da pétala em
default.iris, dividido por espécie?" - Exploratório: "Explore o conjunto de dados iris. O que parece incomum entre as espécies?"
Quando estiver confortável fazendo perguntas, tente ir além:
- Agende um relatório diário com uma tarefa agendada do Cowork todas as manhãs às 8h (
cron: 0 8 * * *). - Peça contexto semanal sobre o que há de novo ou mudou em seus dados, como tabelas renomeadas, atualizadas ou recém-enviadas.
- Execute um resumo semanal da organização sobre a trajetória de custos e se você está no caminho certo para os KPIs do mês.
Dica
Pergunte em inglês simples. O oleander cuida do plano de consulta e da execução nos bastidores para que seu agente possa focar na resposta.