Use este guia se você for admin de um workspace do ChatGPT e estiver configurando o modelo de app Snowflake para sua organização. Um modelo não é o app final que os membros usam. É um fluxo de configuração que cria um app de rascunho específico do workspace depois que você fornece a configuração necessária do Snowflake.
Para o Snowflake, a maior parte da configuração acontece no Snowflake. Você cria um servidor MCP gerenciado pelo Snowflake, concede ao papel correto acesso ao servidor MCP e aos objetos subjacentes dele e, em seguida, insere a URL do servidor MCP gerenciado ou seus campos componentes no fluxo de configuração do modelo no ChatGPT. Depois que o ChatGPT cria o app de rascunho, você pode publicá-lo e gerenciá-lo como outros apps do workspace.
O que você está configurando
Você está criando um app Snowflake específico do workspace no ChatGPT. O app se conecta a um servidor MCP gerenciado pelo Snowflake que define:
Quais ações o ChatGPT pode usar, chamadas ferramentas.
Quais dados ou objetos do Snowflake essas ferramentas podem acessar.
Com qual papel do Snowflake os usuários devem autorizar.
Qual banco de dados, schema e nome de servidor MCP do Snowflake identificam o endpoint do conector.
O ChatGPT só pode descobrir e usar as ferramentas expostas pelo servidor MCP e permitidas pelo papel do Snowflake com o qual o usuário autoriza.
Antes de começar
Você precisa de:
Acesso de admin ou proprietário do workspace do ChatGPT.
Acesso ao Snowflake que possa criar objetos de servidor MCP e conceder permissões.
O banco de dados e o schema do Snowflake onde o servidor MCP ficará.
Uma decisão sobre o que o ChatGPT deve poder fazer, como Cortex Search, Cortex Analyst, SQL somente leitura ou um procedimento ou função específico.
Um papel do Snowflake de privilégio mínimo que os usuários usarão ao autorizar o app.
O prefixo do host da conta Snowflake, incluindo qualquer sufixo de região ou nuvem.
Valores a preparar
Prefixo do host Snowflake: tudo antes de .snowflakecomputing.com na URL da conta Snowflake.
Banco de dados: o banco de dados que contém o servidor MCP.
Schema: o schema que contém o servidor MCP.
Nome do servidor MCP: o nome do objeto de servidor MCP do Snowflake.
URL completa do servidor MCP gerenciado, se a tela de configuração do ChatGPT solicitar uma URL.
Papel do Snowflake: o papel que os usuários devem usar ao autorizar o app.
Lista de ferramentas: os objetos e ações do Snowflake que você quer que o ChatGPT use.
Decida o que o ChatGPT pode fazer
Escolha apenas os recursos que você quer expor. Opções comuns incluem:
Busca com Cortex Search para encontrar respostas em dados ou conteúdo indexados do Snowflake.
Perguntas e respostas com Cortex Analyst por meio de uma visualização semântica aprovada.
SQL somente leitura para acesso controlado a consultas.
Um agente do Snowflake, procedimento armazenado ou UDF para fluxos de trabalho específicos.
Se você habilitar SQL, mantenha-o somente leitura, a menos que sua organização tenha revisado e aprovado acesso de gravação.
Crie o servidor MCP do Snowflake
No Snowflake, entre com um papel que possa criar o servidor MCP e conceder acesso. Abra uma planilha no banco de dados e schema onde o servidor MCP deve ser criado.
Crie um servidor MCP que liste apenas as ferramentas que o ChatGPT deve usar. Substitua os nomes de objeto por seus próprios banco de dados, schema, serviços, visualizações, warehouse e nome de servidor do Snowflake.
Exemplo:
CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP FROM SPECIFICATION $$ tools: - name: "support-search" type: "CORTEX_SEARCH_SERVICE_QUERY" identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE" title: "Support Search" description: "Search support content for relevant customer issues." - name: "sql-readonly" type: "SYSTEM_EXECUTE_SQL" title: "Read-only SQL" description: "Run read-only SQL queries against approved Snowflake data." config: read_only: true query_timeout: 600 warehouse: "CHATGPT_WH" $$;
Os nomes das ferramentas devem ser estáveis e descritivos para que o ChatGPT possa escolher a ferramenta certa. Criar o servidor MCP não concede acesso automaticamente aos objetos subjacentes do Snowflake.
Conceda as permissões corretas do Snowflake
Escolha o papel do Snowflake com o qual os usuários autorizarão e, em seguida, conceda a esse papel acesso ao banco de dados, schema, servidor MCP e a todos os objetos subjacentes usados pelas ferramentas.
Exemplo:
GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;
Se o servidor MCP expuser uma visualização semântica, UDF, procedimento armazenado ou Cortex Agent, conceda também as permissões necessárias para esses objetos.
Verifique se o Snowflake está pronto
Execute:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Depois execute:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirme:
O servidor existe no banco de dados e schema esperados.
A lista de ferramentas é a que você pretendia.
Cada identificador de ferramenta aponta para o objeto Snowflake correto.
O papel de conexão tem USAGE no servidor MCP.
O papel de conexão tem as permissões necessárias em cada objeto subjacente.
Inicie a configuração do modelo no ChatGPT
No ChatGPT, mude para o workspace onde o app deve estar disponível.
Abra Configurações do workspace > Apps.
Selecione Diretório.
Procure por Snowflake.
Selecione o modelo de app Snowflake e inicie a configuração.
Insira um nome e uma descrição claros para o app, como Snowflake ou Snowflake - Analytics.
Insira os detalhes do servidor MCP gerenciado solicitados pelo fluxo de configuração.
Se a tela de configuração solicitar a URL completa do servidor MCP gerenciado, use este formato:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Se a tela de configuração solicitar campos separados, use os mesmos valores dessa URL:
Prefixo do host Snowflake.
Banco de dados.
Schema.
Nome do servidor MCP.
Crie e publique o app de rascunho
Salve a configuração do modelo Snowflake no ChatGPT.
Crie o app de rascunho.
Revise os detalhes do app de rascunho, as configurações de autenticação e as ações disponíveis.
Publique o app de rascunho quando estiver pronto.
Confirme se o app aparece em Configurações do workspace > Apps > Habilitados.
Configure o Acesso do usuário para as funções que devem usá-lo.
Revise o Controle de ações para as ferramentas expostas.
Revise as Permissões do app para escolher quando o ChatGPT pergunta aos membros antes de usar o app.
Essas permissões do app se aplicam às conversas do ChatGPT. Agentes do Workspace usam controles por agente definidos pelo criador do agente para determinar quais ações do app ficam disponíveis e quando os usuários finais são solicitados a aprová-las. Para o comportamento de agentes, consulte: Agentes do Workspace do ChatGPT para Enterprise e Business.
Teste o app
Inicie o fluxo de conexão pelo ChatGPT como um usuário de teste permitido.
Entre no Snowflake e selecione o papel pretendido, se solicitado.
Confirme se o ChatGPT descobre as ferramentas esperadas do servidor MCP.
Execute primeiro uma ação de leitura de baixo risco, como uma busca ou consulta somente leitura em dados aprovados.
Confirme se as permissões do Snowflake impedem acesso fora do papel e dos objetos aprovados.
URL do servidor MCP e comportamento do OAuth
O ChatGPT se conecta à URL completa do servidor MCP gerenciado pelo Snowflake. O ChatGPT usa o prefixo do host Snowflake dessa URL para resolver endpoints OAuth do Snowflake.
Não cole uma URL do Snowsight, a URL raiz da conta Snowflake por si só nem qualquer URL com segmentos de caminho extras. A URL do MCP deve incluir o caminho do banco de dados, schema e servidor MCP e deve corresponder exatamente aos seus objetos Snowflake.
Solução de problemas
Servidor MCP não encontrado: verifique novamente a URL completa do servidor MCP ou os campos separados de prefixo de host, banco de dados, schema e servidor.
Nenhuma ferramenta aparece no ChatGPT: confirme se a especificação do servidor MCP inclui ferramentas e se o papel tem USAGE no servidor MCP.
Uma ferramenta aparece, mas falha ao ser usada: confirme se o papel tem a permissão correta no objeto Snowflake subjacente.
Falha na ferramenta SQL: confirme se o nome do warehouse está correto, se o warehouse está disponível, se o papel tem USAGE nele e se read_only é true caso você pretendesse acesso somente leitura.
Falha na autorização: confirme se o usuário consegue entrar no Snowflake e usar o papel pretendido.
Problema de conexão do nome de host: use o prefixo correto do host Snowflake. Nomes de host do Snowflake com sublinhados podem causar problemas; prefira hifens.