> For the complete documentation index, see [llms.txt](https://developers.bluefleet.com.br/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.bluefleet.com.br/home/blue-link-conexao-com-ia-mcp/chatgpt.md). # Integração com o ChatGPT Conecte o ChatGPT ao Blue Link para consultar os dados da sua locadora com seu usuário Blue Fleet. O Blue Link permite consultar dados da sua locadora em uma conversa com o ChatGPT. O acesso usa seu usuário Blue Fleet e respeita suas permissões. As ferramentas disponibilizadas pelo MCP são de consulta, incluindo a geração de relatórios para análise. ## Antes de começar Confirme que você tem: * Um usuário Blue Fleet ativo, vinculado à locadora que deseja consultar. * Blue Link licenciado para a locadora, ou um período de avaliação válido. * Permissão de uso do Blue Link, concedida pelo administrador da locadora, além das permissões dos dados que pretende consultar. * Uma conta ChatGPT com a opção de adicionar servidores MCP personalizados disponível. Em um workspace empresarial, a organização também precisa permitir essa conexão. {% hint style="info" %} A licença Blue Link e o acesso do ChatGPT a conexões personalizadas são requisitos separados. Não presuma que a conta gratuita possui essa opção, nem que uma assinatura paga garante a liberação no workspace. Confira a disponibilidade na sua conta antes de contratar ou trocar de plano. Se a opção não aparecer, consulte o administrador do workspace ou o suporte da OpenAI. {% endhint %} ## 1. Abra a área de conexões do ChatGPT Pelo navegador, entre no ChatGPT com a conta e o workspace em que pretende usar o Blue Link. Abra [Plugins](https://chatgpt.com/plugins), clique no botão **+** e escolha **Add custom MCP server** (adicionar servidor MCP personalizado). Os nomes da interface podem variar conforme idioma e versão. Se a sua conta ainda apresenta **Apps/Conectores**, procure nessa área a opção de conexão personalizada. Se houver exigência de modo de desenvolvedor, habilite-o nas configurações da conta; em ambientes corporativos, solicite a liberação ao administrador. ## 2. Preencha a conexão | Campo | Valor | | -------------------------------------- | ------------------------------------------------------------- | | Nome | Blue Fleet — Blue Link | | Descrição | Consultar dados e relatórios da minha locadora na Blue Fleet. | | URL do servidor MCP | `https://mcp.bluefleet.com.br/mcp` | | Conexão, quando solicitado | URL HTTPS pública / remota | | Autenticação | OAuth | | Cadastro do cliente, se houver escolha | CIMD / descoberta automática | | Client ID manual | Deixar vazio | | Client secret manual | Deixar vazio | | Escopo, se houver campo manual | `ai:read` | {% hint style="warning" %} Copie a URL completa: ****. O final é `/mcp`. O endereço `/mpc` não existe. {% endhint %} Não use uma chave da API REST, a senha Blue Fleet ou uma chave da OpenAI como client secret. A identificação do aplicativo é automática. Se a tela obrigar o preenchimento manual, confira se selecionou OAuth com descoberta automática; envie ao suporte o nome da opção apresentada, sem credenciais. Para o ChatGPT, utilize CIMD; o cadastro dinâmico de cliente (DCR) é destinado aos conectores do Microsoft Power Platform. Leia o aviso de conexão a um serviço externo, confirme se estiver de acordo e selecione **Create as a plugin** ou o botão equivalente de criação. ## 3. Entre na sua conta Blue Fleet Quando o ChatGPT solicitar a conexão da conta, prossiga para o login Blue Fleet. Confira que a página de autenticação está em **login.bluefleet.com.br**. Use seu login habitual e conclua a verificação em duas etapas, caso seja solicitada. Se a sessão já estiver ativa, a autenticação pode avançar sem pedir a senha novamente. Aguarde o retorno automático ao ChatGPT e finalize a instalação ou ativação do Blue Link, se solicitado. Não copie nem compartilhe o endereço completo da página de retorno OAuth: ele pode conter informações temporárias da autenticação. ## 4. Confirme que a conexão funciona Abra uma nova conversa. Digite **@** e selecione **Blue Fleet — Blue Link**, ou selecione a conexão no menu de ferramentas disponível na sua interface. Envie: > Consulte meu contexto no Blue Fleet e informe a locadora conectada e quais ferramentas estão disponíveis para meu usuário. A resposta deve vir da ferramenta `consultar_contexto`. Confira se a locadora está correta. Uma resposta genérica do ChatGPT sem chamada ao Blue Link não confirma a conexão. Depois experimente: > Quais relatórios de manutenção estão disponíveis para mim no Blue Fleet? > Consulte as filas atuais de manutenção da minha locadora. Os resultados dependem das suas permissões e dos dados existentes. A ausência de um relatório ou de dados não significa necessariamente falha de conexão. ## Se não conseguir conectar | Situação | O que fazer | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Não aparece a opção de adicionar MCP personalizado | Confira a conta, o workspace e as políticas da organização. A liberação dessa opção depende do ChatGPT. | | Erro de URL ou 404 | Confira o domínio e o final `/mcp`. | | Ao abrir a URL no navegador aparece 405 | Esse endereço é usado pelo protocolo MCP. Faça a conexão pelo ChatGPT; abrir como uma página comum não é um teste de funcionamento. | | `invalid_client`, `invalid_request` ou `ID2052` | Informe ao suporte a etapa e o código do erro. Após a orientação de correção, atualize ou recrie a conexão para iniciar uma autenticação nova. | | O login funciona, mas o ChatGPT falha ao concluir | Atualize a conexão e tente novamente. Se persistir, informe ao suporte que a falha acontece no retorno ao ChatGPT. | | “Sua locadora não possui o Blue Link licenciado” | Solicite à Blue Fleet a verificação da licença ou do período de avaliação. | | “Seu usuário não possui permissão para utilizar o Blue Link” | Solicite a permissão ao administrador da locadora. | | Uma consulta específica é negada | Solicite as permissões da área correspondente. Conectar o Blue Link não amplia os acessos do usuário. | | A conexão passou a pedir login novamente | Reconecte a conta. A sessão do Blue Link dura no máximo 30 dias e pode exigir nova autenticação antes disso se o acesso mudar. | | A locadora retornada está incorreta | Desconecte a conta, encerre a sessão Blue Fleet no navegador e refaça a conexão com o usuário correto. | ## Reconectar ou remover Abra a conexão do Blue Link na área de Plugins/Apps do ChatGPT. Use a opção disponível para atualizar ou reconectar. Quando houver uma orientação de recriação, remova a conexão antiga e refaça os passos desta página. Depois, teste em uma conversa nova. Para deixar de usar o Blue Link no ChatGPT, desconecte ou remova a conexão nessa mesma área. ## Uso no aplicativo instalado com o criador de plugins Se você utiliza o aplicativo instalado com acesso ao criador de plugins, mantenha a conexão Blue Link cadastrada em Plugins e siga o fluxo abaixo. A disponibilidade depende da conta e do ambiente. ### Criar o plugin No aplicativo instalado, abra uma conversa com acesso ao criador de plugins e use este pedido no ambiente Codex: ``` $plugin-creator "Blue Link" servidor: "https://mcp.bluefleet.com.br/mcp" ``` No modo **Work do ChatGPT**, selecione `@plugin-creator` e faça o mesmo pedido. Se o criador solicitar a conexão cadastrada, informe o identificador da conexão cadastrada em Plugins (iniciado por `plugin_asdk_app`). Essa distinção entre `@plugin-creator` no ChatGPT e `$plugin-creator` no Codex segue o [guia oficial da OpenAI para criação de plugins](https://developers.openai.com/plugins/build/plugins). ### Instalar e autenticar Siga as orientações do criador para instalar o **Blue Link** no diretório de plugins. Atualize ou reinicie o aplicativo se necessário e abra uma nova conversa. Se for solicitada a conexão à Blue Fleet, entre na tela de login com seu usuário e senha e autorize o acesso. O cadastro do plugin não libera dados por si só: a licença, a autenticação e as permissões da Blue Fleet precisam estar válidas. ## Solicitar ajuda Entre em contato com , informando: * Etapa em que ocorreu a falha e mensagem exata de erro. * Data, horário e fuso da tentativa. * Plano ChatGPT e se a conta está em um workspace pessoal ou empresarial. * Se a tela de login Blue Fleet abriu e se o erro ocorreu antes ou depois de entrar. Não envie senhas, códigos de segundo fator, tokens, client secrets ou links completos de autorização/retorno. Fluxo de interface revisado em 15/10/2026 com base no [guia oficial de conexão da OpenAI](https://developers.openai.com/plugins/deploy/connect-chatgpt). Os nomes dos controles e a disponibilidade podem variar por conta e workspace. Consulte também [Segurança](/home/blue-link-conexao-com-ia-mcp/seguranca.md) e [Ferramentas disponíveis](/home/blue-link-conexao-com-ia-mcp/ferramentas.md).