MDC: seus dados externos dentro do Hub

O MDC (Marvee Data Connector) é a porta de entrada dos dados que vivem fora do Hub. Sua empresa já tem informação valiosa em outros lugares: um banco de dados próprio, um sistema antigo, a API de um serviço contratado. Conecte essa fonte ao MDC e o dado passa a abastecer o Marvin e os Dashboards, sem migrar nada e sem digitar de novo.

O que é e quando usar

O MDC conecta fontes de dados externas (bancos PostgreSQL e APIs HTTP/REST) e publica endpoints sobre elas: consultas prontas, com nome, rota e parâmetros, que outras ferramentas consomem. É a camada de dados; quem mostra o gráfico é o Dashboards, quem responde a pergunta é o Marvin.

O que o MDC entrega hoje:

• Fontes de dados: bancos PostgreSQL e APIs (HTTP/REST), com teste de conexão antes de salvar e suporte a SSL e túnel SSH quando o banco exige.
• Catálogo Marvee de provedores de API e servidores MCP, com credenciais e capacidades já descritas. Há opções prontas como Fireflies e Questor ZEN, além de outros provedores exibidos na tela.
• Schema do banco, no workbench: tabelas, colunas e uma amostra das primeiras linhas, sem escrever nada.
• Workbench SQL: consultas de leitura direto na fonte, com sugestão de SQL gerada por IA pelo Marvin.
• Endpoints: consultas publicadas com rota, método e parâmetros tipados, testáveis num playground antes de entrar em uso.
• Chaves de API e gateway: endpoints consumíveis por sistemas de fora, com escopo por endpoint e data de expiração.
• Credenciais reutilizáveis, guardadas de forma cifrada.
• Controle de acesso fonte a fonte, logs de cada execução e um painel com a saúde dos endpoints.

Conceitos e acesso

Seis termos organizam o app:

Acesso. O administrador da sua organização libera o app. Além disso, o acesso é controlado fonte a fonte: cada fonte tem sua lista de membros com acesso, e quem gerencia a fonte concede ou revoga esse acesso.

Para responder a pergunta contrária, quem enxerga este dado, a tela de cada endpoint tem o cartão Quem acessa. Ele lista as pessoas que alcançam aquele endpoint e por qual caminho: acesso total ao app, administração da fonte, acesso a todos os endpoints, acesso direto àquele endpoint, ou apenas aos metadados. O cartão é de leitura, e conceder ou tirar acesso continua sendo feito no acesso da fonte.

Primeiro uso: passo a passo

O primeiro uso começa fora do Hub e segue em cinco etapas dentro do MDC, uma por seção abaixo.

Separe os dados de conexão. Para um banco PostgreSQL: endereço, porta, nome do banco, usuário e senha (e SSL ou túnel SSH, se o banco exigir). Se você não tem esses dados, peça ao responsável técnico pelo sistema. Prefira um usuário só com permissão de leitura.

Checklist do primeiro uso: conectar uma fonte real, testar a conexão antes de salvar, publicar um endpoint validado no playground e ver o dado aparecer num dashboard ou numa resposta do Marvin.

Cadastre um banco de dados

No menu do MDC, o grupo Conectar separa o tipo de fonte: Bancos de dados (Postgres), APIs (HTTP) e Servidores MCP. A escolha do tipo acontece aí, no menu.

1. Abra Bancos de dados e clique em Novo banco. Abre a janela Nova fonte Postgres.
2. Dê um nome à fonte. O nome aparece na lista, no detalhe da fonte e no Marvin.
3. Preencha a configuração: Host, Porta, Database, Usuário e Senha. SSL e túnel SSH ficam na mesma janela, em Rede e segurança.
4. Clique em Testar para testar a conexão antes de salvar. Com Conexão OK, clique em Criar fonte: a fonte abre na tela dela.

Conecte uma API do catálogo

Para HTTP e MCP, procure primeiro o provedor no catálogo Marvee e preencha somente os dados pedidos.

1. Abra APIs (HTTP) e clique em Nova API. Em Servidores MCP, o caminho é o mesmo, pelo botão Novo servidor.
2. No catálogo, filtre pela categoria ou busque o provedor pelo nome e escolha o seu. Se o sistema que você usa não estiver lá, o atalho Não achou a ferramenta que você usa? pede a integração.
3. Dê um nome à fonte e informe só a credencial que o provedor pede. Quando o provedor permite o teste, o MDC pede que você teste a conexão antes de criar a fonte.
4. Clique em Criar fonte. A fonte já chega com os endpoints prontos do catálogo.

Explore os dados

1. Com a fonte salva, abra o banco e clique em Abrir workbench. O schema fica à esquerda e o Editor SQL, à direita.
2. Em Schema do Banco, abra o schema e navegue pelas tabelas e colunas.
3. Clique no nome de uma tabela para ver uma amostra das primeiras linhas.
4. Para ir além, escreva a consulta no Editor SQL e clique em Executar. O workbench executa consultas de leitura, e o Marvin, no topo da tela, sugere o SQL por IA.

O MDC também pode aprender com IA um resumo da estrutura da fonte (Treinar IA com o schema), o que melhora as consultas geradas a partir de linguagem natural (isso consome créditos de IA).

Publique um endpoint

Transforme a consulta que interessa num endpoint: nome, rota, método e parâmetros (com tipo, obrigatoriedade e valor padrão).

1. Na tela do banco, clique em Novo endpoint SQL.
2. Em Identidade, escolha o método e preencha a Rota e o Nome.
3. Em Query SQL, escreva a consulta e use :nome para cada valor que muda a cada chamada, como :cliente.
4. O MDC avisa do placeholder ainda não declarado. Clique em Adicionar e, em Parâmetros SQL, ajuste o tipo, o valor padrão e se o parâmetro é obrigatório.
5. Clique em Criar endpoint. Na tela do endpoint, o cartão Quem acessa mostra quem alcança aquele dado.
6. Clique em Testar para abrir o playground, informe os parâmetros e clique em Executar para conferir o resultado antes de usar.

Dá para duplicar, ativar e desativar endpoints conforme o uso evolui.

Use o dado e acompanhe

Use o dado onde ele importa. Aponte um gráfico do Dashboards para o endpoint: em Relatórios, clique em Criar relatório, escolha Marvee Data Connection e o endpoint (eles aparecem agrupados por fonte); Criar relatório leva ao gráfico. Você também pode perguntar ao Marvin no chat, ou criar uma chave de API para um sistema de fora consumir o endpoint pelo gateway.

Acompanhe. Os Logs registram cada execução, com status, fonte, origem e duração. A Visão geral resume o tráfego, a saúde dos endpoints e avisa das chaves de API perto de expirar.

Limites e erros comuns

Erros comuns de quem começa: salvar a fonte sem testar a conexão (o teste existe justamente para errar barato), publicar endpoint sem rodar no playground, criar chave de API com acesso a todos os endpoints quando um só resolveria (prefira escopo específico e defina expiração) e deixar uma chave expirar sem perceber (o painel lista as chaves perto de vencer; olhe de tempos em tempos).

Próximo passo

Com a fonte conectada e os primeiros endpoints no ar, o MDC vira o alicerce de dados do resto do Hub:

• Dashboards: use os endpoints como fonte dos seus gráficos e acompanhe os números do sistema externo lado a lado com os dados do próprio Hub.
• Marvin: pelo chat, ele lista fontes, explora tabelas, executa consultas de leitura, cria e edita endpoints e gerencia chaves de API, sempre pedindo sua confirmação antes de qualquer alteração.
• Gateway: quando outro sistema da empresa precisar do dado curado, crie uma chave de API com escopo restrito e entregue o endpoint pronto, com logs e saúde acompanhados no painel.