MCP

Margince: um CRM onde agentes de IA trabalham sob as mesmas regras que os usuários (acesso MCP/REST)

Para equipes que querem agentes de IA trabalhando em um CRM sob as mesmas regras dos usuários e registros preenchidos automaticamente a partir de e-mails, reuniões e calendários, Margince é um CRM auto-hospedado; mas o servidor precisa de um license token da Gradion para iniciar (mesmo com um único assento): confirme antes de começar que conseguirá obtê-lo.

Official source · Margince

Install

make install

Para quem é

Margince é um CRM que preenche os próprios dados: segundo a página oficial, ele completa automaticamente os próprios registros a partir de e-mails, reuniões e calendários, e agentes de IA trabalham nele sob as mesmas regras dos usuários. Ele serve a dois perfis: equipes e pessoas cujas informações de clientes estão espalhadas entre caixas de e-mail, convites de calendário e conversas de reuniões, e que querem reduzir ao mínimo a digitação manual; e quem quer delegar a agentes de IA ações do dia a dia, como consultas e follow-ups, diretamente no CRM, sem que os agentes contornem o sistema de permissões humano.

Casos que não servem, ou que pedem reflexão antes de começar: se você não quer operar um serviço por conta própria — a página oficial diz apenas que o núcleo é um módulo Go em backend/ e um app React em frontend/, que você mesmo compila e executa a partir do código-fonte, sem detalhar dependências nem versões; e se você espera um produto utilizável de imediato antes de conseguir um license token — a página oficial é clara: o servidor precisa de um license token emitido pela Gradion para iniciar, mesmo com um único assento.

Primeira tentativa em 3 minutos

O único caminho principal que a página oficial sustenta é este: obtenha o código-fonte do margince no repositório oficial, entre na raiz do repositório e execute:

make install

A redação oficial é “Install the tools and the git hooks once: make install.” — a instalação única das ferramentas necessárias e dos git hooks. Sinais de sucesso observáveis: as ferramentas ficam instaladas e os git hooks do repositório são ativados. Esse é todo o alcance das etapas de instalação que a página oficial sustenta.

Antes de começar, você precisa saber: iniciar o servidor exige um license token emitido pela Gradion, mesmo com um único assento; a página oficial não menciona isenção de desenvolvimento nem cota gratuita, então não presuma que o serviço local roda sem token. Até ter o token, a instalação é o ponto final.

Mais adiante, a página oficial indica acesso por MCP ou REST, mas o comando de inicialização, os endpoints do serviço e os nomes e parâmetros das ferramentas de agente não aparecem lá: verifique você mesmo no repositório. Depois de conectar, limite a primeira chamada a ações de leitura ou descoberta, veja o que os agentes conseguem fazer e só então considere qualquer operação que altere registros.

Casos de uso

Caso 1: fazer um agente consultar registros de clientes dentro das regras de permissão. Cenário: verificar que agentes de IA realmente conseguem trabalhar no CRM. Como: após concluir a instalação e resolver o license token, conecte um cliente MCP ao serviço e envie uma requisição de consulta. Resultado esperado: segundo o posicionamento oficial, os agentes seguem as mesmas regras dos usuários, e o que um agente pode ver é decidido pela permissão dele. Limite das evidências: a página oficial não traz nomes de ferramentas nem endpoints; o confirmável é o “acesso por MCP ou REST” — confira a lista de ferramentas no repositório antes de enviar requisições.

Caso 2: fazer o CRM preencher os registros de clientes a partir de e-mails, reuniões e calendários. Cenário: reduzir a digitação manual transformando em registros as interações com clientes espalhadas pela caixa de entrada e pelo calendário. Como: com o serviço disponível, conecte essas fontes de dados. Resultado esperado: os registros são preenchidos automaticamente pelo sistema; é o comportamento central descrito na página oficial. Aviso de efeito colateral: o preenchimento automático escreve nos registros do CRM informações vindas de e-mails, reuniões e calendários; a página oficial não explica como as fontes de dados são autorizadas a conectar — decida antes de conectar quais caixas de e-mail e calendários ligar e quais não.

Limites de uso

Natureza de leitura/escrita: Margince escreve automaticamente nos registros do CRM informações de e-mails, reuniões e calendários; assim que entram, viram conteúdo do registro. Os agentes seguem as mesmas regras dos usuários e têm tetos comparáveis — na primeira tentativa, fique na leitura e na descoberta.

Licença e credenciais: o servidor precisa de um license token da Gradion para iniciar, mesmo com um único assento; isenção de desenvolvimento, cota gratuita ou cobrança, a página oficial não diz nada — não presuma que o desenvolvimento local dispensa licença.

Pontos-chave não confirmados: dependências e versões, comando de inicialização, endpoints MCP/REST, lista de ferramentas de agente, processo de solicitação de licença e existência de versão hospedada: a página oficial não explica nada disso. As informações oficiais são muito limitadas e este artigo cobre apenas o que elas sustentam; para qualquer configuração precisa, valem os arquivos reais do repositório — confira item por item antes de começar.