Use este guia se for administrador de um espaço de trabalho ChatGPT e estiver a configurar o modelo de app Snowflake para a sua organização. Um modelo não é a app final que os membros utilizam. É um fluxo de configuração que cria um rascunho de app específico do espaço de trabalho depois de fornecer a configuração Snowflake necessária.
Para a Snowflake, a maior parte da configuração ocorre na Snowflake. Cria um servidor MCP gerido pela Snowflake, concede à função certa acesso ao servidor MCP e aos respetivos objetos subjacentes e, em seguida, introduz o URL do servidor MCP gerido ou os respetivos campos de componente no fluxo de configuração do modelo do ChatGPT. Depois de o ChatGPT criar o rascunho da app, pode publicá-lo e geri-lo como outras apps do espaço de trabalho.
O que está a configurar
Está a criar uma app Snowflake específica do espaço de trabalho no ChatGPT. A app liga-se a um servidor MCP gerido pela Snowflake que define:
Que ações o ChatGPT pode usar, chamadas ferramentas.
A que dados ou objetos Snowflake essas ferramentas podem aceder.
Com que função Snowflake os utilizadores devem autorizar.
Que base de dados, schema e nome de servidor MCP Snowflake identificam o endpoint do conector.
O ChatGPT só consegue descobrir e usar as ferramentas expostas pelo servidor MCP e permitidas pela função Snowflake com que o utilizador autoriza.
Antes de começar
Precisa de:
Acesso de administrador ou proprietário do espaço de trabalho ChatGPT.
Acesso à Snowflake que possa criar objetos de servidor MCP e conceder permissões.
A base de dados e o schema Snowflake onde o servidor MCP irá residir.
Uma decisão sobre o que o ChatGPT deve poder fazer, como Cortex Search, Cortex Analyst, SQL só de leitura ou um procedimento ou função específico.
Uma função Snowflake com privilégios mínimos que os utilizadores usarão ao autorizar a app.
O prefixo do anfitrião da conta Snowflake, incluindo qualquer sufixo de região ou cloud.
Valores a preparar
Prefixo do anfitrião Snowflake: tudo antes de .snowflakecomputing.com no URL da conta Snowflake.
Base de dados: a base 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 Snowflake.
URL completo do servidor MCP gerido, se o ecrã de configuração do ChatGPT pedir um URL.
Função Snowflake: a função que os utilizadores devem usar ao autorizar a app.
Lista de ferramentas: os objetos e ações Snowflake que quer que o ChatGPT use.
Decida o que o ChatGPT pode fazer
Escolha apenas as capacidades que quer expor. As opções comuns incluem:
Pesquisa com Cortex Search para encontrar respostas em dados ou conteúdos Snowflake indexados.
Perguntas e respostas com o Cortex Analyst através de uma vista semântica aprovada.
SQL só de leitura para acesso controlado a consultas.
Um Snowflake Agent, procedimento armazenado ou UDF para fluxos de trabalho específicos.
Se ativar SQL, mantenha-o só de leitura, salvo se a sua organização tiver revisto e aprovado o acesso de escrita.
Criar o servidor MCP Snowflake
Na Snowflake, inicie sessão com uma função que possa criar o servidor MCP e conceder acesso. Abra uma folha de trabalho na base de dados e no 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 dos objetos pela sua própria base de dados, schema, serviços, vistas, warehouse e nome de servidor 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 automaticamente acesso aos objetos Snowflake subjacentes.
Conceder as permissões Snowflake certas
Escolha a função Snowflake com que os utilizadores irão autorizar e, em seguida, conceda a essa função acesso à base de dados, ao schema, ao 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 vista semântica, UDF, procedimento armazenado ou Cortex Agent, conceda também as permissões necessárias para esses objetos.
Verificar se a Snowflake está pronta
Execute:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Em seguida, execute:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirme:
O servidor existe na base de dados e no schema esperados.
A lista de ferramentas é a que pretendia.
Cada identificador de ferramenta aponta para o objeto Snowflake correto.
A função de ligação tem USAGE no servidor MCP.
A função de ligação tem as permissões necessárias em cada objeto subjacente.
Iniciar a configuração do modelo no ChatGPT
No ChatGPT, mude para o espaço de trabalho onde a app deve estar disponível.
Abra Definições do espaço de trabalho > Apps.
Selecione Diretório.
Pesquise Snowflake.
Selecione o modelo de app Snowflake e inicie a configuração.
Introduza um nome e uma descrição claros para a app, como Snowflake ou Snowflake - Analytics.
Introduza os detalhes do servidor MCP gerido pedidos pelo fluxo de configuração.
Se o ecrã de configuração pedir o URL completo do servidor MCP gerido, use este formato:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Se o ecrã de configuração pedir campos separados, use os mesmos valores desse URL:
Prefixo do anfitrião Snowflake.
Base de dados.
Schema.
Nome do servidor MCP.
Criar e publicar o rascunho da app
Guarde a configuração do modelo Snowflake no ChatGPT.
Crie o rascunho da app.
Reveja os detalhes do rascunho da app, as definições de autenticação e as ações disponíveis.
Publique o rascunho da app quando estiver pronto.
Confirme que a app aparece em Definições do espaço de trabalho > Apps > Ativadas.
Configure Acesso de utilizadores para as funções que a devem usar.
Reveja Controlo de ações para as ferramentas expostas.
Reveja Permissões da app para escolher quando o ChatGPT pede confirmação aos membros antes de usar a app.
Estas permissões da app aplicam-se às conversas do ChatGPT. Os agentes do espaço de trabalho usam controlos por agente definidos pelo criador do agente para determinar que ações da app estão disponíveis e quando é pedido aos utilizadores finais que as aprovem. Para o comportamento dos agentes, consulte: Agentes do espaço de trabalho ChatGPT para Enterprise e Business.
Testar a app
Inicie o fluxo de ligação a partir do ChatGPT como utilizador de teste permitido.
Inicie sessão na Snowflake e selecione a função pretendida, se lhe for pedido.
Confirme que o ChatGPT descobre as ferramentas esperadas do servidor MCP.
Execute primeiro uma ação de leitura de baixo risco, como uma pesquisa ou uma consulta só de leitura a dados aprovados.
Confirme que as permissões Snowflake impedem o acesso fora da função e dos objetos aprovados.
URL do servidor MCP e comportamento OAuth
O ChatGPT liga-se ao URL completo do servidor MCP gerido pela Snowflake. O ChatGPT usa o prefixo do anfitrião Snowflake desse URL para resolver endpoints OAuth da Snowflake.
Não cole um URL do Snowsight, o URL raiz da conta Snowflake por si só, nem qualquer URL com segmentos de caminho adicionais. O URL MCP deve incluir o caminho da base de dados, do schema e do servidor MCP e deve corresponder exatamente aos seus objetos Snowflake.
Resolução de problemas
Servidor MCP não encontrado: volte a verificar o URL completo do servidor MCP ou os campos separados de prefixo do anfitrião, base de dados, schema e servidor.
Não aparecem ferramentas no ChatGPT: confirme que a especificação do servidor MCP inclui ferramentas e que a função tem USAGE no servidor MCP.
Aparece uma ferramenta, mas falha quando é usada: confirme que a função tem a permissão certa no objeto Snowflake subjacente.
A ferramenta SQL falha: confirme que o nome do warehouse está correto, que o warehouse está disponível, que a função tem USAGE nele e que read_only é true se pretendia acesso só de leitura.
A autorização falha: confirme que o utilizador consegue iniciar sessão na Snowflake e usar a função pretendida.
Problema de ligação ao nome de anfitrião: use o prefixo de anfitrião Snowflake correto. Os nomes de anfitrião Snowflake com underscores podem causar problemas; prefira hífenes.