Pular para o conteúdo principal

Conectar o ChatGPT

O ChatGPT se conecta ao seu site como um cliente MCP por meio de um conector personalizado. O procedimento é o mesmo do Claude: uma URL, uma autorização OAuth e as ferramentas do seu site aparecem na conversa.


Pré-requisitos

Os conectores personalizados (servidores MCP) usam o modo de desenvolvedor do ChatGPT, disponível nos planos Plus, Pro, Team, Enterprise e Edu; o plano gratuito não oferece suporte a eles. Em um espaço de trabalho Team, Enterprise ou Edu, o administrador precisa primeiro autorizar a criação de conectores personalizados (Configurações do espaço de trabalho → Permissões e funções).

No site, é necessário usar o Senso MCP 1.2.12 ou mais recente. As versões 1.2.0 a 1.2.11 aceitam a conexão do ChatGPT, mas não disponibilizam nenhuma ferramenta para ele (consulte Solução de problemas).

Criar o conector

No ChatGPT para web, abra Configurações → Aplicativos → Configurações avançadas e ative o modo de desenvolvedor. Em seguida, crie um conector informando:

  • um nome, por exemplo, o nome do seu site;
  • a URL do servidor MCP: https://seu-site.tld/api/index.php/v1/mcp (consulte Endpoints do servidor). Use o domínio canônico do site, com ou sem www, conforme a configuração do Joomla: é o endereço que o painel do Senso MCP exibe como endereço do servidor;
  • a autenticação: OAuth. Não é necessário informar as credenciais do cliente: o ChatGPT as obtém automaticamente por meio dos documentos de descoberta publicados pelo seu site.

Autorizar o site

Uma página de autorização será aberta no seu site. Entre com uma conta do Joomla que tenha as permissões desejadas, escolha os escopos concedidos a essa conexão e confirme. Nenhuma senha é enviada ao ChatGPT: somente um token de acesso é emitido, podendo ser revogado a qualquer momento pelo seu site.

Depois que a autorização for concluída, a ficha do conector no ChatGPT listará as ferramentas disponibilizadas pelo seu site. Se essa lista estiver vazia, consulte Solução de problemas.

Usar o conector

Os conectores ficam desativados por padrão em cada nova conversa. Abra o menu + do campo de entrada e ative o conector do seu site: as ferramentas dele serão disponibilizadas ao modelo. Você já poderá executar seu primeiro comando, por exemplo: “liste os artigos publicados mais recentemente”. Assim como em qualquer cliente, os interruptores do site, a ACL da conta e os escopos concedidos determinam o que o ChatGPT pode fazer.

Solução de problemas

A autorização é concluída, mas o ChatGPT não vê nenhuma ferramenta. O modelo informa que o conector não existe ou menciona “plugins” não encontrados. Esse comportamento ocorre nas versões 1.2.0 a 1.2.11 do Senso MCP: o ChatGPT envia primeiro uma sondagem de descoberta (server/discover, protocolo MCP 2026-07-28), e essas versões respondiam de uma forma que o impedia de prosseguir com a negociação tradicional (initialize), de modo que ele nunca solicitava a lista de ferramentas. Atualize o site para a versão 1.2.12 ou mais recente e, no ChatGPT, abra o conector e reinicie a autorização: não é necessário excluí-lo. As ferramentas aparecerão imediatamente.

As ferramentas aparecem na ficha do conector, mas o modelo não as utiliza. Verifique se o conector está ativado na conversa atual (menu +) e se o modo de desenvolvedor continua ativo nas configurações. Se necessário, abra uma nova conversa.

Verificação no site. O painel do Senso MCP registra cada solicitação MCP. Uma conexão saudável do ChatGPT deixará nele a sequência initialize, notifications/initialized e tools/list. Se o registro mostrar apenas entradas de autenticação e nada mais, o site não está atualizado.

Documentação oficial