Conecte o Firmix ao seu assistente de IA
Com o serviço extra Conexão com IA, o seu assistente (Claude, ChatGPT e outros que aceitem conectores MCP) passa a consultar a sua conta do Firmix quando você pergunta em linguagem natural: documentos aguardando assinatura, saldo de créditos, modelos e contatos.
O que a conexão faz hoje: consulta a sua conta (documentos, saldo, modelos, contatos, lembretes e pendências de assinatura) e, conforme o que você permitir ao conectar e em Perfil, cria e edita rascunhos e modelos, salva contatos, cuida de lembretes e envia contratos (com a sua aprovação ou, se você preferir, direto). Cada envio gasta 1 crédito e não tem volta. Cancelar e excluir só funcionam se você ligar essa permissão em Perfil, aceitando o risco. Você pode revogar a conexão quando quiser.
O que você precisa
- Plano Master e Parceiro com a assinatura ativa.
- O serviço extra Conexão com IA, R$ 29,90 por mês, em assinatura própria no cartão. Você cancela só o serviço, sem mexer no plano; ele vale até o fim do período já pago, e a desistência em até 10 dias tem reembolso integral.
- Um assistente de IA que aceite conectores personalizados (MCP). A disponibilidade depende do assistente e do plano que você tem nele.
Passo 1: contrate o serviço
Entre no Firmix, abra Créditos, role até Serviços extras e contrate a Conexão com IA. Leia as condições do item 6 dos Termos de Uso, que o próprio checkout pede para você confirmar.
Passo 2: escolha como conectar
Há dois jeitos, conforme o assistente:
- Autorização direta (OAuth), recomendada para Claude e ChatGPT: você não cria nada antes. No assistente, adicione o conector com o endereço
https://firmix.com.br/mcp (sem token). O assistente abre o Firmix, você entra, confirma com a senha (e o código de verificação, se tiver) e marca o que permite. A conexão aparece em Perfil, Conexão com IA, e você revoga quando quiser.
- Link ou Cabeçalho (token), criados no Perfil: em Perfil, Conexão com IA, dê um nome (por exemplo, “Meu assistente no escritório”) e escolha o tipo: Link (assistentes em que você cola um endereço) ou Cabeçalho (ferramentas de desenvolvedor e sistemas que permitem enviar um cabeçalho de autorização: Claude Code, Cursor, VS Code, Gemini CLI e semelhantes).
O link e o token são a sua senha. Eles aparecem uma única vez: copie e guarde com cuidado. Quem os tiver consulta a sua conta. Não compartilhe e não tire print do endereço do conector (nem das telas do assistente que o mostram). Se vazar ou se perder, revogue a conexão no Perfil e crie outra. Na autorização direta (OAuth) não há segredo para guardar: você revoga no Perfil e o assistente perde o acesso na hora.
Passo 3: conecte no seu assistente
Os passos abaixo seguem a documentação de cada fabricante. Os nomes de menus e os planos que liberam o recurso mudam de versão para versão: se a sua tela for diferente, siga a documentação do assistente.
Claude (aplicativo e site)OAuth · conforme a documentação do fabricante
- Abra as Configurações e vá em Conectores.
- Escolha Adicionar conector personalizado, dê o nome Firmix e informe o endereço
https://firmix.com.br/mcp (sem token). Deixe as opções detectadas como estão (login pelo servidor e identidade publicada do Claude).
- Clique em Conectar. O Claude abre o Firmix: entre, confirme os dois avisos, digite a sua senha (e o código, se tiver verificação em duas etapas), marque o que permite (Ler e, se quiser, Criar e alterar) e clique em Permitir.
- O Claude lista as ferramentas do Firmix. Em permissões de ferramentas você escolhe se ele pede aprovação a cada uso: deixar em “Requer aprovação” é o mais seguro. Se faltar alguma ferramenta, use Atualizar lista de ferramentas no conector.
Prefere o link? Crie um Link no Perfil e, no passo 2, cole-o no lugar do endereço (nesse caso não há o botão Conectar). Em contas Team e Enterprise, quem administra o espaço pode precisar adicionar o conector.
ChatGPTOAuth · conforme a documentação do fabricante
- No ChatGPT, ative o modo desenvolvedor (ou o recurso de plugins/apps personalizados, conforme a sua versão). Em contas de empresa, um administrador precisa liberar.
- Crie um conector (ou plugin) personalizado: Add custom MCP server.
- No endereço do servidor, informe
https://firmix.com.br/mcp. Em autenticação, escolha OAuth: o ChatGPT descobre sozinho como se conectar ao Firmix.
- Clique em conectar. O ChatGPT abre o Firmix: entre, confirme os dois avisos, digite a sua senha (e o código, se tiver) e clique em Permitir. Aceite o aviso de risco da OpenAI para conectores personalizados, crie e instale. Depois, escolha o conector na conversa.
Conectores personalizados dependem do plano. A conexão com o ChatGPT é recente e ainda está em validação: se não completar, use a alternativa por link (crie um Link no Perfil, cole no endereço e escolha autenticação nenhuma). Documentação da OpenAI: modo desenvolvedor e conectar e testar.
Claude Code (terminal)Cabeçalho · conforme a documentação do fabricante
Crie a conexão do tipo Cabeçalho e rode, trocando SEU_TOKEN pelo token:
claude mcp add --transport http firmix https://firmix.com.br/mcp --header "Authorization: Bearer SEU_TOKEN"
Confira com claude mcp list ou, dentro do Claude Code, com /mcp. Para usar em todos os projetos, acrescente --scope user.
Codex (OpenAI)Cabeçalho · conforme a documentação do fabricante
Crie a conexão do tipo Cabeçalho e adicione ao Codex um servidor MCP remoto (HTTP) com o endereço https://firmix.com.br/mcp e o cabeçalho Authorization: Bearer SEU_TOKEN, como descreve a documentação do Codex (comando codex mcp ou arquivo de configuração).
CursorCabeçalho · conforme a documentação do fabricante
No arquivo de configuração de MCP do Cursor (~/.cursor/mcp.json ou .cursor/mcp.json no projeto), acrescente, com a conexão do tipo Cabeçalho:
{
"mcpServers": {
"firmix": {
"url": "https://firmix.com.br/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}
VS Code (GitHub Copilot)Cabeçalho · conforme a documentação do fabricante
No arquivo .vscode/mcp.json do projeto (ou na configuração de MCP do usuário), acrescente, com a conexão do tipo Cabeçalho:
{
"servers": {
"firmix": {
"type": "http",
"url": "https://firmix.com.br/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}
Gemini CLICabeçalho · conforme a documentação do fabricante
No arquivo ~/.gemini/settings.json (global) ou .gemini/settings.json (do projeto), acrescente, com a conexão do tipo Cabeçalho:
{
"mcpServers": {
"firmix": {
"httpUrl": "https://firmix.com.br/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}
Reinicie o Gemini CLI e use /mcp para conferir. Documentação: MCP no Gemini CLI.
Outros assistentes e sistemasQualquer cliente MCP remoto
Qualquer assistente ou sistema que aceite servidor MCP remoto (HTTP) funciona. Se a tela pede só um endereço, use a conexão do tipo Link. Se permite informar um cabeçalho, use o tipo Cabeçalho: endereço https://firmix.com.br/mcp e cabeçalho Authorization: Bearer SEU_TOKEN.
Alguns assistentes do dia a dia ainda não permitem conectores personalizados, ou exigem um login do tipo OAuth, que esta conexão não oferece. Confira na documentação do seu assistente antes de contratar.
Passo 4: experimente
Peça ao assistente, por exemplo:
- “Quais documentos do Firmix estão aguardando assinatura?”
- “Quantos créditos eu tenho no Firmix?”
- “Quais modelos de contrato eu tenho?”
- “Procure o contato Maria Souza no Firmix.”
- “Crie um lembrete para o documento 123, daqui a 30 dias: cobrar a assinatura.” (precisa de “Criar e alterar”)
- “Crie um rascunho de contrato com o modelo X para a Maria Souza.” (o rascunho exige o CPF do contratante; quem revisa e envia é você, pelo painel)
- “Troque o modelo do rascunho da Maria Souza para o modelo Y e renomeie para Contrato 2026.”
- “Anexei o meu contrato de locação em Word: transforme em um modelo do Firmix, com variáveis para os dados que mudam de cliente para cliente.”
O que a conexão faz hoje
- Ler: consultar a conta (plano e saldo), listar e ler modelos, buscar contatos, listar e consultar documentos, listar lembretes, ver quem ainda não assinou e há quanto tempo, e conferir se falta algo em um rascunho antes de enviar.
- Criar e alterar (se você permitir ao conectar): criar e editar rascunhos de contrato (renomear, trocar o modelo ou o texto, corrigir o contratante e ajustar por onde cada signatário recebe, WhatsApp ou e-mail; nada é enviado e nenhum crédito é gasto nessas etapas), criar e atualizar modelos (por exemplo, a partir de um contrato seu em Word, trocando os dados que mudam por variáveis), salvar contatos e criar, editar e concluir lembretes.
- Corrigir contato e lembrar quem não assinou (só com o envio direto ligado em Perfil): corrigir o e-mail ou o celular de um signatário que ainda não assinou, igual à função do painel (nome e CPF não mudam), e pedir o lembrete de assinatura. A correção é em dois passos: o assistente mostra o antes e o depois, você confirma na conversa e ele confirma com um código de uso único; você recebe um e-mail a cada correção.
- Cancelar e excluir (só se você ligar essa permissão em Perfil, Conexão com IA, aceitando o risco): cancelar documentos sem assinatura, excluir documentos já cancelados e sem assinatura, excluir contatos, excluir modelos e cancelar lembretes. Cada ação exige a sua confirmação na conversa, tem limite por dia e fica registrada. Excluir não tem volta.
- Planos, pagamentos, créditos e a conta nunca são alterados pelo assistente. O envio para assinatura por assistente é opcional e vem desligado: o titular liga em Perfil, Conexão com IA, e depois o assistente só consegue pedir o envio de um rascunho. Quem aprova é você, numa tela do Firmix (recebe e-mail e notificação), vendo o contrato, quem assina e a prévia; o assistente não consegue aprovar. Cada envio gasta 1 crédito e não tem volta. Há também o modo direto (mais risco), em que o assistente envia depois que você confirma na conversa, sem a tela de aprovação, por padrão só para signatários que já são contatos que você mesmo salvou ou confirmou. Ao ligar, revogue a conexão atual e conecte de novo, marcando “Pedir o envio para assinatura”.
Perguntas e cuidados
Quanto custa e como cancelo?
R$ 29,90 por mês, em assinatura própria no cartão. Para cancelar, abra Perfil → Serviços extras: ele vale até o fim do período já pago. Se o plano acabar ou descer para um que não inclui o serviço, as conexões são revogadas.
Posso conectar mais de um assistente?
Sim: crie uma conexão para cada assistente (até 5 por conta), cada uma com o seu nome. Assim você revoga só a que quiser.
Como desligo ou troco a conexão?
Em Perfil → Conexão com IA, revogue a conexão: ela para de funcionar na hora (no OAuth, o assistente pede para você conectar de novo). As revogadas e vencidas ficam no botão “Histórico de conexões”. Link e token valem por 90 dias e você renova criando outro; a conexão por OAuth se renova sozinha enquanto o assistente a usa e vence se ficar 30 dias sem uso.
O que o assistente enxerga? Meus dados saem do Firmix?
Ao perguntar, o assistente recebe o que a consulta devolve (por exemplo, nomes e e-mails de contatos e dados de documentos). Essas informações passam a ser tratadas pelo fornecedor do assistente, que pode estar no exterior e segue as regras dele. O conteúdo criado por IA pode ter erros: confira antes de agir. Veja o item 6 dos Termos de Uso e a Política de Privacidade.
Conecte só o assistente em que você confia. Deixe ligada a aprovação por uso, quando o assistente oferecer, e desconfie de pedidos estranhos dentro de documentos ou contatos cadastrados por outras pessoas: o assistente pode confundi-los com instruções.
Estes passos seguem a documentação dos fabricantes e podem mudar com as versões e os planos de cada assistente. Se algo não bater, escreva para contato@firmix.com.br.