Conector Linvix para assistentes de IA

Consulte os dados do Linvix Gestão da sua empresa conversando com o Claude e com outros assistentes compatíveis com MCP.

O que é

O conector da Linvix liga o Claude e outros assistentes compatíveis com MCP (Model Context Protocol) ao ERP Linvix Gestão da sua empresa. Você pergunta em português, e o assistente consulta dados de financeiro, comercial, compras, estoque e serviços.

  • Para usar, é preciso ser cliente do Linvix Gestão e ter usuário e senha do ERP.
  • O conector usa as permissões do seu usuário no ERP: o assistente só vê o que você já pode ver no sistema.
  • Hoje o conector só consulta dados: nenhuma ferramenta altera informações no ERP.

Como conectar

Endereço do servidor: https://mcp-lia.linvix.com/mcp

Claude (web, desktop e celular)

Pelo diretório:

  1. Abra a página da Linvix no diretório de conectores do Claude (ou, em Configurações → Conectores, procure Linvix) e clique em Conectar.
  2. Na tela da Linvix, entre com seus dados do ERP (veja O login).

Manualmente, como conector personalizado:

  1. Em Configurações → Conectores, clique em Adicionar conector personalizado.
  2. Informe o endereço https://mcp-lia.linvix.com/mcp, sem preencher Client ID nem Client Secret, e clique em Adicionar.
  3. Clique em Conectar e entre com seus dados do ERP.

Claude Code

Se o Claude Code está logado com a mesma conta do Claude em que você conectou a Linvix, o conector já aparece sozinho: confira com /mcp.

Manualmente:

claude mcp add --transport http linvix https://mcp-lia.linvix.com/mcp

Depois, na sessão do Claude Code, rode /mcp, escolha linvix e depois Authenticate.

Outros assistentes

ChatGPT, Cursor e outros clientes MCP conectam pelo mesmo endereço, https://mcp-lia.linvix.com/mcp, com autenticação OAuth.

O login

A tela da Linvix pede o CPF ou CNPJ do emitente, o usuário e a senha do ERP. Se a sua empresa tem servidor dedicado, abra Servidor dedicado e informe o endereço da API (https://<servidor>.linvix.com).

Exemplos de uso

Depois de conectar, é só perguntar:

  • “Qual o saldo das contas bancárias?”
  • “Quanto faturamos este mês e quem foram os vendedores que mais venderam?”
  • “Quais contas a receber estão vencidas?”
  • “Quais produtos estão abaixo do estoque ideal?”
  • “Qual o MRR atual dos contratos?”

Ferramentas

O assistente escolhe sozinho a ferramenta de cada pergunta. Estas são as disponíveis hoje:

FerramentaNome técnicoTipo
Compras no período get_compras_no_periodo Consulta
Compras por fornecedor get_compras_por_fornecedor Consulta
Contas a pagar get_financeiro_pagar Consulta
Contas a receber get_financeiro_receber Consulta
MRR dos contratos get_contratos_mrr Consulta
Contratos no período get_contratos_no_periodo Consulta
Contratos por cliente get_contratos_por_cliente Consulta
Contratos por vendedor get_contratos_por_vendedor Consulta
Estoque abaixo do ideal get_estoque_abaixo_do_ideal Consulta
Estoque baixo get_estoque_baixo Consulta
Ordens de serviço no período get_ordem_servico_no_periodo Consulta
Ordens de serviço por cliente get_ordem_servico_por_cliente Consulta
Pedidos e orçamentos no período get_pedidos_orcamentos_no_periodo Consulta
Pedidos e orçamentos por cliente get_pedidos_orcamentos_por_cliente Consulta
Data atual e períodos de referência get_periodos_referencia Consulta
Produtos mais vendidos get_produtos_mais_vendidos Consulta
Consulta de produtos get_produtos Consulta
Saldo das contas bancárias get_saldo_contas_bancarias Consulta
Produtos mais comprados get_top_produtos_comprados Consulta
Produtos mais pedidos e orçados get_top_produtos_pedidos_orcamentos Consulta
Vendedores com mais pedidos e orçamentos get_top_vendedores_pedidos_orcamentos Consulta
Vendas no período get_vendas_no_periodo Consulta
Vendas por cliente get_vendas_por_cliente_no_periodo Consulta
Vendas por vendedor get_vendas_por_vendedor_no_periodo Consulta
Ranking de vendedores get_vendedores_no_periodo Consulta

Dados e privacidade

  • A senha só é usada para entrar no ERP: ela não fica guardada.
  • Enquanto a conexão vale, a sessão do ERP fica cifrada no servidor da Linvix. Ela dura até o vencimento da sessão do ERP (ou 30 dias, quando ela não tem vencimento).
  • O assistente recebe só tokens próprios deste servidor, que não servem para entrar no ERP.
  • O servidor não guarda as conversas nem o resultado das consultas: o resultado vai direto para o assistente que você conectou, que o trata conforme a política de privacidade dele.
  • Os registros técnicos (logs) não guardam senhas nem tokens.

Política de privacidade da Linvix

Problemas comuns

O assistente diz que falta permissão
Seu usuário do ERP não tem acesso àquele módulo. O assistente mostra quais permissões faltam; peça ao administrador do ERP para liberá-las.
O conector pede login de novo
A sessão venceu: ela dura até o vencimento da sessão do ERP (ou 30 dias, quando ela não tem vencimento). Conecte de novo.
O login não entra
Confira o CPF ou CNPJ do emitente, o usuário e a senha. Em Servidor dedicado, só vale um endereço no formato https://<servidor>.linvix.com.
O período da resposta parece errado
As datas seguem o horário de Brasília. Diga o período por extenso, por exemplo “de 1º a 15 de setembro”.
Como desconectar
Remova o conector nas configurações do assistente: a partir daí ele não usa mais a conexão. A sessão cifrada no servidor da Linvix não é apagada na hora; ela expira sozinha no prazo descrito em Dados e privacidade.

Suporte