F
firmix

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

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:

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
  1. Abra as Configurações e vá em Conectores.
  2. 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).
  3. 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.
  4. 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
  1. 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.
  2. Crie um conector (ou plugin) personalizado: Add custom MCP server.
  3. 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.
  4. 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:

O que a conexão faz hoje

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.

Voltar para o Firmix