Conectar o Fracttal One ao ChatGPT permite que você interaja com seus dados de manutenção diretamente pela interface do ChatGPT, usando linguagem natural para consultar ordens de serviço, ativos, métricas e mais, sem precisar sair do assistente.
A integração utiliza o protocolo MCP (Model Context Protocol) com autenticação OAuth 2.0, garantindo que o ChatGPT acesse o Fracttal com as mesmas permissões do usuário autenticado.
Requisitos
- Conta ativa no Fracttal One com permissões de administrador ou acesso à Configuração.
- Conta no ChatGPT com plano Pro, Team, Enterprise ou Edu (a funcionalidade de conectores MCP não está disponível no plano gratuito do ChatGPT).
- Acesso à seção Conexões API dentro do Fracttal One.
- Modo Desenvolvedor ativado no ChatGPT (veja o Passo 5).
Passo a passo
Acesse a configuração do Fracttal One
Faça login na sua conta do Fracttal One. No canto superior direito, clique no menu do usuário e selecione Configuração.
Menu do usuário › Configuração
Vá para Conexões API
No menu lateral de configuração, localize e selecione Conexões API. Depois clique na aba Consumidores OAuth.
Configuração › Conexões API › Consumidores OAuth
Crie um novo consumidor OAuth
Clique no botão (+) para adicionar um novo consumidor.
Preencha o formulário com os seguintes dados:
Campo | Valor |
|---|---|
Tipo de autorização | Código de autorização |
Nome | Nome da conexão que preferir (ex: ChatGPT MCP) |
URL | URL de Callback gerada pelo ChatGPT (deve ser feita paralelamente ao passo 6) |
Grupo de permissões | Selecione o grupo de permissões desejado. No entanto, o sistema usará as permissões do usuário autenticado. |
Depois de preencher o formulário, clique no ícone de Salvar (parte superior direita).
Copie a chave e o segredo gerados
Ao salvar, o Fracttal One gerará automaticamente uma Chave e um Segredo para o consumidor. Copie e guarde ambos os valores com segurança — você precisará deles no próximo passo.
Ative o Modo Desenvolvedor no ChatGPT
Para poder adicionar conectores MCP personalizados, primeiro você deve habilitar o Modo Desenvolvedor:
- Abra o ChatGPT em chatgpt.com e faça login.
- No canto inferior esquerdo, clique no seu nome de usuário e depois em Configurações (Settings).
- Vá para a seção Apps & Connectors.
- Clique em Avançado (Advanced) e ative o Modo Desenvolvedor (Developer Mode).
Nota: Ao ativar o Modo Desenvolvedor, a função Memory do ChatGPT será desativada automaticamente. Esta é uma limitação da OpenAI.
Adicione o conector MCP no ChatGPT
Com o Modo Desenvolvedor ativo, agora você pode adicionar o conector do Fracttal One:
- Em Configurações › Apps & Connectors, clique em Criar (Create) ou Adicionar servidor MCP (Add MCP server), conforme seu plano.
- Preencha o formulário com os seguintes dados:
Campo | Valor |
|---|---|
Nome do conector | Fracttal One (ou o nome que preferir) |
Descrição (opcional) | Conector MCP para gestão de manutenção com Fracttal |
MCP Server URL | https://one.fracttal.com/mcp/oauth/fracttal-one |
Autenticação | OAuth |
Client ID | Cole a Chave gerada no Passo 4 |
Client Secret | Cole o Segredo gerado no Passo 4 |
- Marque a caixa de confirmação de riscos ("I trust this application").
- Clique em Criar (Create).
Importante: Ao realizar a configuração avançada de OAuth no ChatGPT, a URL de Callback necessária para estabelecer a conexão OAuth no Fracttal One é gerada automaticamente (deve ser feita paralelamente ao passo 4).
Autorize a conexão
O ChatGPT mostrará um botão para conectar ao Fracttal One. Ao clicar, abrirá uma janela de autorização do Fracttal onde você deverá:
- Fazer login com sua conta do Fracttal One.
- Confirmar as permissões de acesso solicitadas.
Uma vez aprovado, o conector ficará ativo. Você verá seu status como Conectado na seção Apps & Connectors.
Pronto! Agora você tem o Fracttal One conectado ao ChatGPT. Pode iniciar uma conversa e perguntar sobre suas ordens de serviço, ativos, métricas e mais.
Considerações importantes:
- O uso desta integração pode implicar consumo, limites ou cobranças associadas aos planos do ChatGPT (OpenAI). Esses custos e condições são determinados exclusivamente pela OpenAI.
- O ChatGPT pode solicitar confirmação antes de executar ações de escrita (criar, modificar, excluir registros). Sempre revise as ações propostas antes de confirmá-las.
- O usuário é responsável por validar e supervisionar as ações e resultados gerados por meio desta integração.
- A função Memory do ChatGPT é desativada automaticamente ao usar o Modo Desenvolvedor.