Este guia mostra como conectar o ChatGPT ao PUCA por um conector MCP privado, sem publicar o PUCA no diretório público de plugins da OpenAI.
Há dois jeitos:
- Individual — cada pessoa cadastra o conector na própria conta ChatGPT (Plus/Pro).
- Team / workspace (Business, Enterprise ou Education) — um admin cria o app MCP e, se quiser, publica só para o workspace. Os colegas passam a ver o conector interno; isso não coloca o PUCA na loja pública.
A interface da OpenAI muda com alguma frequência (Apps, Plugins, Connectors). O que não muda é a URL do servidor MCP e o login no PUCA. Se um menu estiver em outro lugar, use os links oficiais no final deste artigo.
O que você precisa
- Conta ChatGPT Plus, Pro, Business, Enterprise ou Education (Developer Mode não está no plano Free). Use o ChatGPT na web.
- Usuário e senha do PUCA, no domínio da sua empresa.
- URL do servidor MCP do PUCA:
https://mcp.puca.app/mcp
Nome sugerido no ChatGPT: PUCA. Descrição sugerida: Consultar dados autorizados do ERP PUCA (CRM, tarefas, fluxo, financeiro) com o usuário logado.
Como funciona (resumo)
- O ChatGPT fala com
https://mcp.puca.app/mcp(MCP em HTTPS / streamable HTTP). - Abre o login do PUCA (OAuth). Você escolhe o domínio e entra com usuário/senha. Opcionalmente libera escrita (
mcp:write). - Nas conversas, o ChatGPT chama as tools do PUCA com as permissões daquele usuário.
O conector privado não passa pela revisão do diretório da OpenAI. Os dados da conversa e o retorno das tools ainda passam pelo ChatGPT; o ganho é usar o assistente sem listar o PUCA na loja.
Opção A — conta individual (Plus / Pro)
Passos oficiais da OpenAI para Developer Mode + servidor MCP remoto:
1. Ativar o Developer Mode
Fonte: Connect and test your plugin e ChatGPT Developer mode.
- Abra o ChatGPT no navegador.
- Abra Settings (Configurações).
- Selecione Security and login (Segurança e login).
- Ligue Developer mode.
Em alguns planos o interruptor aparece em Settings → Apps → Advanced Settings. A disponibilidade depende da conta e da política do workspace, se você estiver em um.
2. Cadastrar o servidor MCP do PUCA
Fonte: Add the MCP server.
- Vá em ChatGPT Plugins (diretório / área de plugins do ChatGPT).
- Clique no botão + (plus). O plus só cria app em Developer Mode depois de o modo estar ligado.
- Informe um nome visível (ex.: PUCA) e uma descrição.
- Em Connection, escolha endpoint público e cole:
https://mcp.puca.app/mcp
(a OpenAI pede a URL completa, incluindo o caminho /mcp.)
5. Crie a conexão.
6. Revise as tools e os metadados que o ChatGPT descobrir no servidor.
Autenticação: deixe o ChatGPT descobrir o OAuth sozinho. O gateway PUCA publica os metadados OAuth 2.1 e registra o cliente (DCR + PKCE). Não é necessário colar Client ID / Client Secret.
3. Conectar a conta PUCA (OAuth)
Quando o ChatGPT pedir para autenticar:
- Confirme o domínio da sua empresa.
- Entre com usuário e senha do PUCA.
- Se precisar gravar dados (não só consultar), marque a permissão de escrita. Para o dia a dia, prefira só leitura.
4. Usar no chat
Fonte: ChatGPT Developer mode — How to use.
- Abra uma conversa nova.
- No menu + do compositor, escolha Developer mode.
- Selecione o app PUCA.
- Peça algo concreto, por exemplo:
- Use o app PUCA e liste as tools disponíveis.
- No PUCA, busque a ficha da empresa CASA FLORA.
- Liste minhas tarefas abertas no PUCA.
Dica da OpenAI: seja explícito (“use o app PUCA”) e, se o modelo tentar navegar na web, peça para não usar browsing, só o PUCA.
Ações de escrita pedem confirmação no chat. Confira o JSON da tool antes de autorizar.
5. Atualizar tools depois de uma mudança no PUCA
Fonte: Refresh metadata.
- Abra a conexão em ChatGPT Plugins.
- Clique em Refresh.
- Confirme a lista nova de tools.
- Comece uma conversa nova e teste de novo.
Opção B — Team / workspace (Business, Enterprise, Education)
Neste modelo o conector é da empresa, não de cada pessoa solta. Continua privado: publicar no workspace não é o mesmo que publicar no diretório público de plugins.
Fontes: Developer mode and MCP apps in ChatGPT e Apps in ChatGPT.
O que o admin faz
Business
- Só Admins usam Developer Mode.
- Ligar em User Settings → Apps → Advanced settings → Developer mode, ou criar o app em Workspace settings → Apps → Create já em Developer Mode.
- Depois de testar: Workspace settings → Apps → Drafts → Publish.
- No lançamento, app Business publicado não se atualiza: para mudar tools ou metadados é preciso recriar e republicar.
Enterprise / Education
- Em Workspace Settings → Permissions & Roles → Connected Data, ligue Developer mode / Create custom MCP connectors.
- (Opcional) Use RBAC para autorizar quem pode criar conectores e quem poderá usar o app depois de publicado.
- Cada admin/owner liga o Developer Mode na própria conta (Settings → Apps → Advanced Settings). O toggle do workspace não liga automaticamente para todos os admins.
- Crie o app em Workspace settings → Apps → Create.
- Informe nome, descrição e a URL MCP
https://mcp.puca.app/mcp. - Aguarde o Scan Tools.
- O rascunho fica em Workspace Settings → Apps → Drafts.
- Só Admins e Owners publicam: abra o draft, Publish, leia os avisos (principalmente escrita).
- Depois de publicado, o app entra na lista de conectores aprovados do workspace e em Settings → Apps dos usuários, com o rótulo custom.
O que cada membro do time faz
- Em Settings → Apps, abra o PUCA (rótulo custom ou Dev, conforme ainda for rascunho ou já publicado).
- Connect / autenticar — o mesmo login PUCA (domínio + usuário/senha).
- Cada um usa a própria conta PUCA. As permissões do ERP continuam valendo.
Publicar o MCP app no workspace não cria sozinho um plugin na loja pública. Para isso existiria outro fluxo de submissão, que o PUCA não usa neste manual.
O que o ChatGPT consegue consultar no PUCA
O gateway só expõe tools marcadas para o proxy MCP. Hoje isso inclui, entre outras:
- Base: consultas SQL autorizadas (
SELECT), tarefas, informações básicas de usuários, relatório e checagem de acesso. - CRM: pessoa/empresa, interações, relacionamentos.
- Financeiro: informações de lançamentos.
- Flow: documentação do kanban, cards do responsável, detalhes, requisitos, histórico, interações e tarefas do card.
Tools internas que não estão no proxy (por exemplo várias do WhatsApp) não aparecem neste conector.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Não aparece Developer Mode | Plano Free, ou admin do workspace ainda não liberou conectores MCP. |
| Botão + não cria app MCP | Developer Mode desligado. |
| Falha ao conectar a URL | Use exatamente https://mcp.puca.app/mcp (HTTPS + /mcp). |
| Login PUCA não abre / OAuth falha | Domínio correto, usuário ativo, pop-up de login não bloqueado. |
| Tool de escrita recusada | Marcar mcp:write no login e confirmar a ação no ChatGPT. |
| Membros do Team não veem o app | App ainda em Drafts; só admin/owner publica. No Enterprise, conferir RBAC. |
| Tools desatualizadas | Refresh na conexão e conversa nova. |
Menus da OpenAI: se Plugins tiver sido unificado com Apps, procure Settings → Apps ou Workspace settings → Apps. Os artigos oficiais abaixo são a referência da interface atual.
Links de referência (OpenAI)
- ChatGPT Developer mode — elegibilidade, ligar o modo, criar app MCP, usar no chat, confirmação de escrita.
- Connect and test your plugin — passo a passo: Developer Mode, adicionar servidor MCP, Refresh.
- Developer mode and MCP apps in ChatGPT — Business / Enterprise / Edu: permissões, Create, Drafts, Publish, RBAC.
- Apps in ChatGPT — apps, plugins, permissões e publicação no workspace versus diretório.
- Build with the Apps SDK — contexto de apps MCP no ChatGPT.
Documentação do protocolo: Model Context Protocol.