Ligar o Fracttal One com o ChatGPT permite-te interagir com os teus dados de manutenção diretamente a partir da interface do ChatGPT, usando linguagem natural para consultar ordens de trabalho, ativos, métricas e mais, sem necessidade de sair do assistente.
A integração utiliza o protocolo MCP (Model Context Protocol) com autenticação OAuth 2.0, garantindo que o ChatGPT acede ao Fracttal com as mesmas permissões do utilizador autenticado.
Requisitos
- Conta ativa no Fracttal One com permissões de administrador ou acesso a 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 à secção Conexões API dentro do Fracttal One.
- Modo Developer ativado no ChatGPT (ver Passo 5).
Passo a passo
Acede à configuração do Fracttal One
Inicia sessão na tua conta do Fracttal One. No canto superior direito, clica no menu de utilizador e seleciona Configuração.
Menu de utilizador › Configuração
Vai a Conexões API
No menu lateral da configuração, localiza e seleciona Conexões API. Depois clica na aba Consumidores OAuth.
Configuração › Conexões API › Consumidores OAuth
Criar um novo consumidor OAuth
Clica no botão (+) para adicionar um novo consumidor.
Preenche o formulário com os seguintes dados:
Campo | Valor |
|---|---|
Tipo de autorização | Código de autorização |
Nome | Nome da ligação que preferires (ex: ChatGPT MCP) |
URL | URL de Callback gerada pelo ChatGPT (deve ser feita paralelamente ao passo 6) |
Grupo de permissões | Seleciona o grupo de permissões que desejares. No entanto, o sistema usará as permissões do utilizador autenticado. |
Depois de preencher o formulário, clica no ícone Guardar (parte superior direita).
Copia a chave e o segredo gerados
Ao guardar, o Fracttal One gera automaticamente uma Chave e um Segredo para o consumidor. Copia e guarda ambos os valores em segurança — vais precisar deles no passo seguinte.
Ativa o Modo Developer no ChatGPT
Para poderes adicionar conectores MCP personalizados, primeiro tens de ativar o Modo Developer:
- Abre o ChatGPT em chatgpt.com e inicia sessão.
- No canto inferior esquerdo, clica no teu nome de utilizador e depois em Configuração (Settings).
- Vai à secção Apps & Connectors.
- Clica em Advanced e ativa o Modo Developer.
Nota: Ao ativar o Modo Developer, a função Memory do ChatGPT será desativada automaticamente. Esta é uma limitação da OpenAI.
Adiciona o conector MCP no ChatGPT
Com o Modo Developer ativo, agora podes adicionar o conector do Fracttal One:
- Em Configuração › Apps & Connectors, clica em Create (ou Add MCP server, conforme o teu plano).
- Preenche o formulário com os seguintes dados:
Campo | Valor |
|---|---|
Nome do conector | Fracttal One (ou o nome que preferires) |
Descrição (opcional) | Conector MCP para gestão de manutenção com Fracttal |
MCP Server URL | https://one.fracttal.com/mcp/oauth/fracttal-one |
Authentication | OAuth |
Client ID | Cola a Chave gerada no Passo 4 |
Client Secret | Cola o Segredo gerado no Passo 4 |
- Marca a caixa de confirmação de riscos ("I trust this application").
- Clica em Create.
Importante: Ao realizar a configuração avançada de OAuth no ChatGPT, é gerada automaticamente a URL de Callback necessária para estabelecer a ligação OAuth no Fracttal One (deve ser feita paralelamente ao passo 4).
Autoriza a ligação
O ChatGPT mostrará um botão para ligar ao Fracttal One. Ao clicares, abrir-se-á uma janela de autorização do Fracttal onde deverás:
- Iniciar sessão com a tua conta do Fracttal One.
- Confirmar as permissões de acesso solicitadas.
Uma vez aprovado, o conector ficará ativo. Verás o seu estado como Ligado na secção Apps & Connectors.
Pronto! Já tens o Fracttal One ligado ao ChatGPT. Podes iniciar uma conversa e perguntar pelas tuas ordens de trabalho, ativos, métricas e mais.
Considerações importantes:
- O uso desta integração pode implicar consumo, limites ou custos associados aos planos do ChatGPT (OpenAI). Esses custos e condições são determinados exclusivamente pela OpenAI.
- O ChatGPT pode pedir confirmação antes de executar ações de escrita (criar, modificar, eliminar registos). Revisa sempre as ações propostas antes de as confirmares.
- O utilizador é responsável por validar e supervisionar as ações e resultados gerados através desta integração.
- A função Memory do ChatGPT é desativada automaticamente ao usar o Modo Developer.