Escolha como conectar
Use o AJUR no ambiente que faz parte da sua rotina. Em todos os casos, sua conta AJUR AI Connect deve estar habilitada pelo administrador do escritório.
No ChatGPT, o acesso depende dos recursos da sua conta, das permissões do seu espaço de trabalho e da compatibilidade do aplicativo. A configuração personalizada é separada da publicação no catálogo público da OpenAI.
1. Codex no computador
Este é o caminho recomendado pelo AJUR. Depois de validar sua senha e seu autenticador, instale a integração diretamente no Codex.
- Baixe o aplicativo com Codex para Mac ou Windows e entre com sua conta da OpenAI. Na versão atual, o Codex faz parte do novo aplicativo ChatGPT; selecione Codex ao abrir. Se já estiver instalado, siga para o próximo passo.
- Abra o Terminal no Mac ou o Git Bash no Windows. Copie o comando abaixo, cole no terminal e pressione Enter.
curl -fsSL https://www.ajur.com.br/codex/instalar.sh | bash
O comando instala o Codex CLI pelo instalador oficial da OpenAI, caso ele esteja ausente, ou o atualiza se a versão instalada for incompatível. Em seguida, baixa e instala o plugin diretamente do AJUR. Abra o link de autenticação exibido no terminal e entre com sua conta AJUR AI Connect. Informe a senha e o código de autenticação somente no navegador. Depois, reabra o Codex e inicie uma nova conversa.
Em Plugins, confira se o AJUR AI Connect está instalado e ativo. Na nova conversa, peça, por exemplo: “Use o AJUR AI Connect para mostrar meus compromissos de hoje.” Você também pode pedir consultas de processos, andamentos, documentos, honorários e despesas.
A instalação foi validada no macOS e em um ambiente Linux isolado. No Windows, utilize Git Bash; a validação em um computador Windows ainda está pendente. Para atualizar o plugin, execute novamente o mesmo comando.
Você pode ler o instalador antes de executá-lo. O Codex CLI é a versão para terminal; o aplicativo gráfico é instalado separadamente. Esse comando prepara a integração local do Codex e não cria uma conexão na sua conta do ChatGPT pelo navegador.
2. Aplicativo ChatGPT
Esta opção se refere ao aplicativo ChatGPT para computador, no Mac ou no Windows. A conexão precisa estar disponível para sua conta e para a versão do aplicativo utilizada.
- Entre no aplicativo com a mesma conta e o mesmo espaço de trabalho que serão usados para conectar o AJUR.
- Abra Plugins ou Apps, conforme aparecer na sua versão. Se o AJUR AI Connect já estiver disponível para sua conta, abra-o e conclua a conexão com sua conta AJUR.
- Se ele ainda não aparecer, siga a configuração assistida pelo navegador. Depois, reabra o aplicativo e confira se a conexão ficou disponível nessa mesma conta.
- Quando disponível, selecione o AJUR AI Connect nas ferramentas de uma nova conversa e faça sua consulta.
Não existe um instalador AJUR que habilite a conexão em qualquer versão do ChatGPT. Se o aplicativo não oferecer essa integração, utilize o navegador. A disponibilidade no aplicativo ainda precisa ser validada na conta do cliente.
3. ChatGPT no navegador
Acesse o ChatGPT com uma conta que permita criar conexões personalizadas. Em contas de escritório, o administrador pode precisar autorizar esse recurso. Esta opção não exige instalar o Codex nem executar comandos no terminal.
- Abra Plugins no ChatGPT. Se sua conta mostrar Apps, use essa seção. Procure Criar app ou o botão +. O recurso pode exigir o modo desenvolvedor autorizado nas configurações.
- Informe o nome AJUR AI Connect, escolha URL do servidor e copie o endereço abaixo. Mantenha a autenticação OAuth.
https://mcp.ajur.com.br/mcp
- Abra Configurações avançadas de OAuth, copie a URL de retorno exibida pelo ChatGPT e informe-a ao suporte AJUR, junto com a identificação do escritório. O AJUR precisa cadastrar essa URL antes de concluir a conexão.
- O suporte fornecerá a configuração OAuth apropriada para essa conexão. Preencha os campos indicados, revise as permissões apresentadas e conclua a criação. A URL do servidor, sozinha, não conclui a configuração.
- Entre com sua conta AJUR AI Connect na tela de autenticação e informe o código do autenticador, se solicitado. Depois, selecione a integração em uma nova conversa e faça uma consulta.
O cadastro manual precisa ser preparado e validado para cada nova conexão. Se sua conta não apresentar a opção de criar apps ou plugins, fale com o administrador ou com o suporte AJUR. Não é possível habilitar essa opção com o instalador do Codex.
Solicitar configuração para o navegador
O suporte pode receber a URL de retorno e a identificação do escritório. Sua senha, códigos do autenticador e tokens devem ser informados somente nas telas próprias de autenticação, nunca enviados ao suporte.
Documentação da OpenAI
Consulte as orientações oficiais sobre conexões personalizadas e plugins e ambientes compatíveis. Os nomes das opções podem variar conforme a versão e a conta.
Como funciona
O AJUR AI Connect é a integração oficial do AJUR com o ChatGPT e o Codex. Cada cliente conecta sua própria conta por OAuth. A integração identifica o escritório e o usuário autenticado e aplica as mesmas permissões configuradas no AJUR.
As ferramentas publicadas são somente de leitura: elas consultam informações, mas não criam, alteram ou excluem registros no AJUR.
Consultas disponíveis
- processos por número, parte, cliente ou responsável;
- andamentos, agenda, prazos e documentos autorizados;
- contatos conforme as permissões funcionais do usuário;
- honorários por período, situação, responsável, processo, cliente e centro de custos;
- valores lançados, recebidos e ainda a receber;
- despesas por período, situação, responsável, favorecido, processo e centro de custos;
- grupos e subgrupos de centros de custos, inclusive resolução de nomes aproximados para confirmação do usuário.
Segurança e permissões
O acesso exige autenticação OAuth. O AJUR não considera identificadores de escritório ou usuário enviados na pergunta como autoridade de acesso. O escopo é sempre determinado pela identidade autenticada e pelas permissões existentes no sistema.
As respostas não devem conter senhas, tokens, dados bancários ou outros segredos. Para desconectar a integração, o usuário pode revogar o acesso nas configurações de aplicativos conectados e, quando aplicável, nas configurações da sua conta AJUR.
Suporte
Para dúvidas de instalação, autenticação, permissões ou resultados de consultas, escreva para suporte@ajur.com.br.
Ao solicitar suporte, informe o nome do escritório, a ferramenta utilizada e uma descrição do problema. Não envie senhas, tokens ou documentos confidenciais por e-mail.
