Use este guia se você administra um espaço de trabalho do ChatGPT ou usa o ChatGPT Plus ou Pro e quer conectar o ChatGPT ao Snowflake por meio de um servidor MCP gerenciado pelo Snowflake.
A maior parte da configuração é feita no Snowflake. Depois que o Snowflake estiver pronto, conclua a conexão do modelo do Snowflake no ChatGPT e ative o plugin do Snowflake que usa esse modelo.
OAuth integrado: quando disponível para sua conta do Snowflake e no ChatGPT, use o aplicativo parceiro do ChatGPT habilitado por um administrador do Snowflake. Entre no Snowflake usando o SSO da sua organização, se estiver configurado. Você não precisa inserir um ID do cliente nem um segredo do cliente no ChatGPT. Siga as instruções da seção OAuth integrado abaixo.
Cliente OAuth personalizado: use esta opção se sua organização exigir um cliente OAuth próprio ou se o OAuth integrado não estiver disponível. Siga as instruções da seção Cliente OAuth personalizado abaixo.
As duas opções de OAuth exigem a configuração comum do servidor MCP, as permissões dos objetos subjacentes e o acesso à rede descritos abaixo. Conclua a configuração comum até a seção Insira os detalhes do servidor Snowflake no ChatGPT antes de configurar o OAuth.
O que você está configurando
Você está criando um servidor MCP gerenciado pelo Snowflake que funciona como o endpoint MCP do ChatGPT. O servidor MCP define:
Quais ações o ChatGPT pode usar.
Quais dados ou objetos do Snowflake essas ferramentas podem acessar.
Qual função do Snowflake cada usuário usa para conceder autorização.
Qual banco de dados, schema e nome de servidor MCP do Snowflake identificam o endpoint.
Em seguida, você configura o Snowflake - Modelo oficial no ChatGPT com a URL completa do servidor MCP gerenciado. A tela de configuração do modelo pode exibir a URL em quatro campos separados:
Prefixo do host do Snowflake.
Banco de dados.
Schema.
Nome do servidor MCP.
O ChatGPT só pode descobrir e usar ferramentas expostas pelo servidor MCP e permitidas pela função do Snowflake que o usuário usa para conceder autorização.
Antes de começar
Você precisa de:
Acesso de administrador ou proprietário do espaço de trabalho do ChatGPT, ou acesso ao ChatGPT Plus ou Pro.
Acesso ao Snowflake com permissão para criar objetos de servidor MCP e conceder permissões.
O banco de dados e o schema do Snowflake onde ficará o servidor MCP.
Uma definição do que o ChatGPT poderá fazer, como usar o Cortex Search, o Cortex Analyst, SQL somente leitura ou um procedimento ou função específicos.
Uma função no Snowflake com os privilégios mínimos necessários, 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.
Se a sua conta Snowflake restringir o acesso por meio de uma política de rede ou lista de IPs permitidos, peça a um administrador do Snowflake para permitir conexões de entrada dos intervalos de IP de saída dos apps do ChatGPT atuais. A lista é dinâmica e deve ser mantida atualizada.
Valores a preparar
Prefixo do host do Snowflake: tudo que vem antes de .snowflakecomputing.com na URL da conta do 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.
Função do Snowflake: a função que os usuários devem usar ao autorizar o app.
Lista de ferramentas: os objetos e as ações do Snowflake que você quer que o ChatGPT use.
Decida o que o ChatGPT pode fazer
Escolha apenas os recursos que deseja disponibilizar. As opções mais comuns incluem:
Busca com o Cortex Search para encontrar respostas em dados ou conteúdos indexados do Snowflake.
Perguntas e respostas com o Cortex Analyst por meio de uma view semântica aprovada.
SQL somente leitura para acesso controlado a consultas.
Um agente do Snowflake, um procedimento armazenado ou uma UDF para um fluxo de trabalho específico.
Se você habilitar o SQL, mantenha-o como somente leitura, a menos que sua organização tenha revisado e aprovado o acesso de gravação.
Abra uma planilha do Snowflake
Entre no app do Snowflake.
Mude para uma função que possa criar o servidor MCP e conceder acesso.
Acesse Espaços de trabalho.

Crie um espaço de trabalho com um arquivo SQL.

Defina o contexto do espaço de trabalho para o banco de dados e o schema em que o servidor MCP será criado.

Crie o servidor MCP do Snowflake
No Snowflake, entre com uma função que possa criar o servidor MCP e conceder acesso. Abra uma planilha no banco de dados e no schema em que o servidor MCP deve ser criado.
Execute uma instrução como a do exemplo a seguir. Substitua os nomes pelos do seu banco de dados, schema, serviços, views, warehouse e servidor do Snowflake.
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: "revenue-analyst" type: "CORTEX_ANALYST_MESSAGE" identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW" title: "Revenue Analyst" description: "Answer revenue questions using the approved semantic view." - 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 e os objetos do Snowflake nesta instrução são exemplos:
support-searchdisponibiliza o serviço Cortex Search especificado.revenue-analystdisponibiliza a view semântica especificada. Adicione ferramentas para outras views conforme necessário.sql-readonlydisponibiliza SQL somente leitura com o warehouse especificado.
Use nomes estáveis e descritivos para as ferramentas, para que o ChatGPT possa escolher a ferramenta certa. Criar o servidor MCP não concede acesso automaticamente aos objetos subjacentes do Snowflake.
Para ver outras opções de especificação, consulte: Criar um servidor MCP gerenciado pelo Snowflake.
Conceda as permissões corretas no Snowflake
Escolha a função do Snowflake que os usuários usarão para autorizar a conexão e conceda a ela acesso a:
O banco de dados e o schema.
O servidor MCP.
Todos os objetos subjacentes usados pelas ferramentas, como um serviço de busca, uma view semântica ou um warehouse.
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 SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;
Se o servidor MCP disponibilizar uma UDF, um procedimento armazenado ou um agente do Cortex, conceda também as permissões necessárias para esse objeto.
Verifique se o Snowflake está pronto
Execute:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Em seguida, execute:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirme se:
O servidor existe no banco de dados e no schema esperados.
A lista de ferramentas corresponde ao que você pretendia.
O
identifierde cada ferramenta aponta para o objeto correto do Snowflake.A função usada na conexão tem a permissão
USAGEno servidor MCP.A função usada na conexão tem as permissões necessárias em cada objeto subjacente.
Insira os detalhes do servidor Snowflake no ChatGPT
Para configurar um espaço de trabalho, abra admin.openai.com, selecione o espaço de trabalho desejado do ChatGPT e abra Plugins. Para saber como navegar no espaço de trabalho e acessar apps legados, consulte Controles de administração, segurança e conformidade para plugins e apps.
No ChatGPT, mude para a conta ou o espaço de trabalho em que o app deve ficar disponível.
Acesse Configurações > Plugins para uma configuração pessoal ou Console de administração > Plugins como administrador para configurar um espaço de trabalho.
Busque por Snowflake.
Ative Snowflake - Modelo oficial.
Abra Snowflake - Modelo oficial, insira um nome claro para a conexão e selecione Conectar.
Insira a URL completa do servidor MCP gerenciado:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Exemplo:
https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

Se a tela de configuração mostrar a configuração do Snowflake em campos separados, use os mesmos valores da URL:
Prefixo do host do Snowflake
Use tudo que vem antes de .snowflakecomputing.com na URL da sua conta do Snowflake, incluindo qualquer sufixo de região ou nuvem.
Por exemplo, se a URL da conta começar com:
https://myorg-myaccount.azure.snowflakecomputing.com
O prefixo do host é:
myorg-myaccount.azure
Banco de dados
Insira o banco de dados que contém o servidor MCP, por exemplo:
CHATGPT_APPS
Schema
Insira o schema que contém o servidor MCP, por exemplo:
TOOLS
Nome do servidor MCP
Insira o nome do objeto de servidor MCP do Snowflake, por exemplo:
CHATGPT_SNOWFLAKE_MCP
Configure o OAuth
Escolha a opção de OAuth que esteja disponível para sua conta e atenda aos requisitos da sua organização. As duas opções usam a configuração comum do servidor MCP acima e os testes de conexão e controles de acesso abaixo.
Em qualquer uma das opções de OAuth, quando você usa session:role:all, o Snowflake usa a função padrão de cada usuário. A função padrão deve constar na lista de funções permitidas da integração OAuth, se essa lista estiver configurada, e não pode estar bloqueada. Ter outra função aprovada não faz com que ela seja selecionada automaticamente.
OAuth integrado
Antes de continuar, conclua as seções de configuração comum acima para criar o servidor MCP, conceder permissões, verificar o servidor e inserir seus detalhes no ChatGPT. Isso é necessário mesmo que você tenha vindo diretamente para esta seção.
Use esta opção somente quando o aplicativo parceiro do ChatGPT estiver disponível para sua conta do Snowflake e o OAuth integrado estiver disponível na janela de configuração do ChatGPT.
Peça a um administrador do Snowflake para habilitar a integração de parceiro do ChatGPT na mesma conta do Snowflake que hospeda o servidor MCP. Reutilize uma integração de parceiro do ChatGPT já habilitada.
Na janela de configuração do ChatGPT, use o OAuth integrado. Você não precisa inserir um ID do cliente nem um segredo do cliente, ou registrar uma URL de callback.
Prossiga com a seção Conecte e gerencie o Snowflake abaixo para entrar, dar consentimento e configurar o acesso. Em seguida, conclua a seção Teste o app, incluindo testes com membros autorizados que não sejam administradores.
O funcionamento da função padrão, da lista de permissões e das funções bloqueadas descrito acima também se aplica a esta opção.
Cliente OAuth personalizado
Antes de continuar, conclua as seções de configuração comum acima para criar o servidor MCP, conceder permissões, verificar o servidor e inserir seus detalhes no ChatGPT. Isso é necessário mesmo que você tenha vindo diretamente para esta seção.
Para um cliente OAuth personalizado, você precisa de um ID do cliente e um segredo do cliente fornecidos pelo Snowflake. O funcionamento da função padrão, da lista de permissões e das funções bloqueadas descrito acima também se aplica a esta opção.
Na janela de configuração do ChatGPT, selecione Configurações avançadas de OAuth > Cliente OAuth definido pelo usuário e copie exatamente a URL de callback exibida no ChatGPT.
Crie uma integração de segurança OAuth personalizada com
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'eOAUTH_REDIRECT_URIdefinido exatamente como essa URL de callback.Execute a seguinte instrução no Snowflake, usando o nome da integração em letras maiúsculas:
SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');Do resultado JSON, cole
oauth_client_idem ID do cliente OAuth eoauth_client_secretem Segredo do cliente OAuth no ChatGPT.Defina Método de autenticação do endpoint de token como
client_secret_basic.
Depois de inserir as credenciais do cliente personalizado, prossiga com as seções Conecte e gerencie o Snowflake e Teste o app abaixo.
Conectar e gerenciar o Snowflake
Em qualquer uma das opções de OAuth, na mesma janela de configuração do ChatGPT, selecione Continuar, entre no Snowflake e autorize a conexão. Você pode usar o SSO da sua organização, se estiver configurado.
Ao configurar um espaço de trabalho, verifique se tanto Snowflake quanto Snowflake - Modelo oficial estão ativados. Nos planos Enterprise e Edu, configure a política de instalação do plugin e o Acesso de usuários de cada app incluído para as funções atribuídas aos membros ou grupos desejados. No Business, gerencie a política de instalação de plugins e a disponibilidade de apps em todo o espaço de trabalho.
Os administradores do espaço de trabalho são responsáveis por revisar o Controle de ações das ferramentas expostas.
Os administradores do espaço de trabalho são responsáveis por revisar as Permissões do app para escolher quando o ChatGPT deve pedir autorização aos membros antes de usar o app.
Essas permissões do app se aplicam às conversas do ChatGPT. Os agentes do espaço de trabalho usam controles individuais definidos pelo criador de cada agente para determinar quais ações de apps estão disponíveis e quando os usuários finais precisam aprová-las. Para saber mais sobre o comportamento dos agentes, consulte: Agentes do espaço de trabalho do ChatGPT para Enterprise e Business.
Teste o app
Abra uma conversa, selecione Snowflake e teste a conexão.
Confirme se o ChatGPT descobre as ferramentas que você configurou.
Primeiro, execute 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 o acesso fora da função e dos objetos aprovados.
Ao configurar um espaço de trabalho, teste com membros autorizados que não sejam administradores e tenham funções padrão diferentes no Snowflake. Uma conexão bem-sucedida de um administrador não confirma que todos os membros conseguem se conectar.
Para os administradores do espaço de trabalho, não basta ativar apenas Snowflake. Se Snowflake - Modelo oficial não tiver sido ativado e conectado, o plugin poderá aparecer desativado para os membros.
URL do servidor MCP e funcionamento do OAuth
O ChatGPT se conecta à URL completa do servidor MCP gerenciado pelo Snowflake:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
O ChatGPT usa o prefixo do host do Snowflake dessa URL para determinar estes endpoints OAuth do Snowflake:
Autorização:
https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorizeToken:
https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request
Não cole uma URL do Snowsight, apenas a URL raiz da conta do Snowflake ou uma URL com segmentos de caminho extras. A URL do MCP deve incluir /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} e corresponder exatamente aos seus objetos do Snowflake.
Solução de problemas
O Snowflake está ativado para um administrador, mas desativado para um membro
Confirme se tanto Snowflake quanto Snowflake - Modelo oficial estão ativados em Console de administração > Plugins.
Abra Snowflake - Modelo oficial e conclua o fluxo de Conectar. Não basta ativar o modelo sem conectá-lo.
Abra Snowflake e confirme se o modelo aparece como app obrigatório.
Confirme se a política de instalação do plugin permite a função ou o grupo do membro afetado.
Servidor MCP não encontrado
Verifique novamente a URL completa do servidor MCP ou os quatro campos do modelo, se a tela de configuração os solicitar.
Confirme se o servidor MCP existe exatamente nesse banco de dados e nesse schema.
Nenhuma ferramenta aparece no ChatGPT
Confirme se a especificação do servidor MCP inclui ferramentas.
Confirme se a função tem a permissão
USAGEno servidor MCP.
Uma ferramenta aparece, mas falha ao ser usada
Confirme se a função tem a permissão necessária no objeto subjacente do Snowflake, como o serviço de busca, a view semântica, o warehouse, o procedimento ou a UDF.
Falha na ferramenta SQL
Confirme se o nome do warehouse está correto e se ele está em execução.
Confirme se a função tem a permissão
USAGEno warehouse.Confirme se
read_only: trueestá definido caso a intenção seja permitir acesso somente leitura.
A função ALL solicitada foi explicitamente bloqueada
Peça ao administrador do Snowflake para comparar sua função padrão com as funções permitidas e bloqueadas da integração OAuth. Ter outra função permitida não faz com que ela seja selecionada automaticamente. Se for apropriado, altere a função padrão para uma função aprovada e reconecte. Alterar sua função padrão também afeta suas sessões do Snowflake fora do ChatGPT.
Falha na autorização
Confirme se o usuário consegue entrar no Snowflake.
Ao usar
session:role:all, confirme se a função padrão do usuário é permitida pela integração OAuth.Confirme se a configuração usa o fluxo OAuth de MCP gerenciado pelo Snowflake.
Se você usa um cliente OAuth personalizado, confirme se o ID do cliente e o Segredo do cliente correspondem à integração OAuth do Snowflake e se o URI de redirecionamento dela corresponde exatamente à URL de callback exibida no ChatGPT.
Se você usa o OAuth integrado, peça a um administrador do Snowflake para verificar se a integração de parceiro do ChatGPT está disponível e habilitada na conta que hospeda o servidor MCP.
A política de rede ou a lista de IPs permitidos do Snowflake bloqueia o app
Peça a um administrador do Snowflake para atualizar a política de rede ou as regras de acesso do Snowflake.
Permita conexões de entrada dos intervalos de IP de saída dos apps do ChatGPT atuais.
Configure essa lista de permissões no Snowflake. Ela é independente da lista de IPs permitidos do espaço de trabalho do ChatGPT.
Sempre que possível, automatize as atualizações a partir do JSON publicado, pois os intervalos podem mudar.
Problema de conexão com o nome do host
Use o prefixo correto do host do Snowflake. Nomes de host do Snowflake com sublinhados podem causar problemas; prefira hifens.
