Conectores MCP
Um conector MCP é a ligação segura entre a ADRI e outro programa seu, como o seu ERP ou a sua base de dados. Serve para que a ADRI consulte dados em tempo real, apenas em leitura se preferir, e para que as suas aplicações lhe peçam trabalho por API.
O que é o MCP
O MCP (Model Context Protocol) é um padrão aberto para que um assistente de IA se ligue a outros programas de forma controlada. Pense numa tomada universal: a ADRI é o aparelho e o seu ERP, a sua base de dados ou o seu servidor são as tomadas.
Não precisas de conhecer o protocolo. Na prática, colas um endereço (um URL) e, se for preciso, uma chave (um token). A partir daí falas com ADRI como sempre e, quando é preciso, ele consulta esse sistema por ti.
O que conecta
BionicAdri traz um catálogo de 21 integrações. Onze podem ser conectadas hoje; as outras dez aparecem como pré-visualização, com a etiqueta «Brevemente», e não têm botão de conectar.
| Família | Conectores | Estado |
|---|---|---|
| ERP externos | Odoo e Xmart ERP | Podem ser conectados |
| ERP externos | Tryton y Holded | Pré-visualização |
| Bases de dados | PostgreSQL e MySQL / MariaDB | Podem ser conectados |
| Design 3D | FreeCAD | Pode ser conectado |
| Design 3D e CAD | Blender, SketchUp, AutoCAD, Autodesk Inventor e Figma | Pré-visualização |
| Infraestrutura | Proxmox VE, Cloudflare e Cloudflare Docs (documentação oficial, apenas leitura) | Podem ser conectados |
| Alojamento e web | Plesk, Hestia CP e o adaptador oficial do WordPress | Pré-visualização |
| Desktop e móvel | Desktop Windows, Desktop Linux e Android | Podem ser conectados |
O catálogo pode crescer ou passar de pré-visualização a conectável sem que instales nada manualmente. A tua empresa também pode ocultar cartões por função.
Permissões e segurança
Ao arrancar o conector escolhes o nível. Num ERP ou numa base de dados, o guia recomenda um utilizador que só consulta: ADRI analisa vendas, stock ou faturas sem criar nem modificar nada. Se configurares apenas leitura e ADRI tentar escrever, a operação deve falhar: é a proteção a funcionar.
Dar permissão de escrita é uma decisão tua, sob a tua responsabilidade. Nunca é o comportamento por defeito do produto.
O utilizador e a palavra-passe do sistema de destino vão no comando de arranque do conector, no teu equipamento. ADRI e BionicAdri só veem a URL e, se existir, a chave que colares no cartão.
É gerido a partir do botão Integrações do chat. A tua URL e a tua chave não são partilhadas com os teus colegas, e tu não vês as deles. O token é mostrado mascarado e podes ativar, desativar, editar ou remover a ligação quando quiseres.
Da primeira vez aceitas um aviso: os dados saem para o servidor que conectas, és responsável pelo que conectas e não deves enviar dados pessoais sem autorização. A aceitação fica guardada com data e hora.
Como ADRI o usa
Escolhes o conector, segues o guia de instalação se tiver e colas a URL (e a chave). O cartão passa a «Ativa».
Não há um modo especial. Escreves o que precisas e ADRI usa a integração ativa do teu utilizador.
ADRI consulta o sistema nesse momento e responde-te. Não copia o teu ERP para as tabelas da BionicAdri.
| Conector | O que podes pedir |
|---|---|
| Odoo ou outro ERP em leitura | «Top 10 clientes por faturação neste trimestre», «Stock do produto X», «Faturas pendentes de cobrança» |
| Xmart ERP | «Como vai a linha 3?», «Ordens atrasadas», «OEE da semana» |
| PostgreSQL e MySQL | «Quantas linhas tem encomendas?», «Há consultas lentas ou índices óbvios?» |
Importante: o conector tem de continuar a funcionar no teu equipamento ou servidor. Se o fechares, o cartão pode continuar em «Ativa», mas ADRI não poderá usá-lo até que o voltes a arrancar. Para documentos que subes tu, existe a base de conhecimento da ADRI; MCP é consulta em tempo real.
A API do ADRI
O MCP vai numa direção: o ADRI chega aos teus sistemas. A API do ADRI vai na contrária: a tua web, o teu script ou o teu CRM externo lançam tarefas ao ADRI sem abrir a aplicação. Por exemplo: «resume este PDF», «redige esta resposta» ou «analisa este Excel».
O contrato de API de um cliente. Sem uma subscrição ativa, a API rejeita os pedidos.
A chave do sistema externo, com a forma tok_… Podes criar vários (produção, testes), definir-lhes uma data de validade e limitar quais agentes a podem usar.
Cada pedido fica registado. Perguntas pelo estado até terminar e recolhes o texto, um resultado para máquinas ou os ficheiros que tenha gerado.
Envia-se com um POST para /api/v2/ollama-tasks, com o teu token no cabeçalho Authorization, e consulta-se com um GET. Aceita um ficheiro anexo até 50 MB e tem um limite de 300 pedidos por minuto por token. Se suspeitares que uma chave foi exposta, revogas e corta-se imediatamente. A IA está incluída: não há saldo para recarregar e o gasto real é medido no Painel de Consumos.
Outros canais
Ligas o teu número ao digitalizar um QR, como no WhatsApp Web. Se te escreveres a ti próprio, falas com o ADRI. Também há resposta automática para clientes, que tu ativas.
Entras com o teu telefone e um código. Em «Mensagens guardadas» falas com o ADRI, e podes usar o canal em campanhas.
São geridos a partir do botão Canais, com as suas próprias permissões. Não dependem do catálogo de conectores.
Preço
Pagas por posto: um posto é uma tarefa de IA a trabalhar em paralelo, não uma pessoa, pelo que os utilizadores não têm limite. O servidor onde vivem os teus dados escolhe-se à parte, desde 100 €/mês. Preços sem IVA.
Perguntas frequentes
É um padrão aberto para que um assistente de IA se ligue a outros programas de forma controlada. Precisas dele se quiseres que o ADRI consulte dados de um ERP, uma base de dados ou um servidor teu sem que os coles no chat.
Só se tu o permitires. A opção recomendada é um utilizador de apenas leitura, com o qual o ADRI consulta e analisa mas não altera nada. A escrita é uma decisão tua e nunca é o comportamento predefinido.
O Odoo e o Xmart ERP podem ser ligados agora. Tryton e Holded aparecem como pré-visualização e ainda não têm botão de conectar. O ERP próprio da BionicAdri não é substituído por MCP.
Não. O ADRI consulta o ERP no momento, através do conector que tu controlas. O teu ERP ou a tua base de dados continuam onde estão.
Não. Cada pessoa configura a sua, mesmo que aponte para o mesmo sistema da empresa. O token é guardado de forma mascarada.
Sim. Crias uma subscrição e um token, envias a tarefa por API e consultas o resultado quando termina. Há um limite de 300 pedidos por minuto por token e os ficheiros anexos podem chegar a 50 MB.
Demo sem compromisso
Conta-nos como trabalhas hoje e mostramos-te como o ADRI o faria com os teus dados. Sem compromisso.
