Usa esta guía si eres administrador de un área de trabajo de ChatGPT y vas a configurar la plantilla de app de Snowflake para tu organización. Una plantilla no es la app final que usan los miembros. Es un flujo de configuración que crea una app en borrador específica del área de trabajo después de que proporciones la configuración requerida de Snowflake.
En Snowflake, la mayor parte de la configuración se realiza en Snowflake. Creas un servidor MCP administrado por Snowflake, concedes al rol adecuado acceso al servidor MCP y a sus objetos subyacentes y, después, introduces la URL del servidor MCP administrado o sus campos de componente en el flujo de configuración de la plantilla de ChatGPT. Después de que ChatGPT cree la app en borrador, puedes publicarla y gestionarla como otras apps del área de trabajo.
Qué vas a configurar
Vas a crear una app de Snowflake específica del área de trabajo en ChatGPT. La app se conecta a un servidor MCP administrado por Snowflake que define:
Qué acciones puede usar ChatGPT, llamadas herramientas.
A qué datos u objetos de Snowflake pueden acceder esas herramientas.
Con qué rol de Snowflake deben autorizar los usuarios.
Qué base de datos, esquema y nombre de servidor MCP de Snowflake identifican el punto de acceso del conector.
ChatGPT solo puede descubrir y usar las herramientas expuestas por el servidor MCP y permitidas por el rol de Snowflake con el que se autoriza el usuario.
Antes de empezar
Necesitas:
Acceso de administrador o propietario del área de trabajo de ChatGPT.
Acceso a Snowflake que permita crear objetos de servidor MCP y conceder permisos.
La base de datos y el esquema de Snowflake donde residirá el servidor MCP.
Una decisión sobre lo que ChatGPT debe poder hacer, como Cortex Search, Cortex Analyst, SQL de solo lectura o un procedimiento o función específicos.
Un rol de Snowflake con privilegios mínimos que los usuarios usarán al autorizar la app.
El prefijo de host de la cuenta de Snowflake, incluido cualquier sufijo de región o nube.
Valores que preparar
Prefijo de host de Snowflake: todo lo que aparece antes de .snowflakecomputing.com en la URL de la cuenta de Snowflake.
Base de datos: la base de datos que contiene el servidor MCP.
Esquema: el esquema que contiene el servidor MCP.
Nombre del servidor MCP: el nombre del objeto de servidor MCP de Snowflake.
URL completa del servidor MCP administrado, si la pantalla de configuración de ChatGPT solicita una URL.
Rol de Snowflake: el rol que los usuarios deben usar al autorizar la app.
Lista de herramientas: los objetos y acciones de Snowflake que quieres que use ChatGPT.
Decidir qué puede hacer ChatGPT
Elige solo las capacidades que quieres exponer. Entre las opciones habituales se incluyen:
Buscar con Cortex Search para encontrar respuestas en datos o contenido indexados de Snowflake.
Preguntas y respuestas con Cortex Analyst mediante una vista semántica aprobada.
SQL de solo lectura para un acceso a consultas controlado.
Un Snowflake Agent, un procedimiento almacenado o una UDF para flujos de trabajo específicos.
Si habilitas SQL, mantenlo en solo lectura salvo que tu organización haya revisado y aprobado el acceso de escritura.
Crear el servidor MCP de Snowflake
En Snowflake, inicia sesión con un rol que pueda crear el servidor MCP y conceder acceso. Abre una hoja de trabajo en la base de datos y el esquema donde se debe crear el servidor MCP.
Crea un servidor MCP que enumere solo las herramientas que debe usar ChatGPT. Sustituye los nombres de objetos por los de tu propia base de datos, esquema, servicios, vistas, almacén y nombre de servidor de Snowflake.
Ejemplo:
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" $$;
Los nombres de las herramientas deben ser estables y descriptivos para que ChatGPT pueda elegir la herramienta adecuada. Crear el servidor MCP no concede automáticamente acceso a los objetos subyacentes de Snowflake.
Conceder los permisos de Snowflake adecuados
Elige el rol de Snowflake con el que se autorizarán los usuarios y, después, concede a ese rol acceso a la base de datos, el esquema, el servidor MCP y todos los objetos subyacentes usados por las herramientas.
Ejemplo:
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;
Si el servidor MCP expone una vista semántica, UDF, procedimiento almacenado o Cortex Agent, concede también los permisos requeridos para esos objetos.
Verificar que Snowflake está listo
Ejecuta:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Después, ejecuta:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Confirma:
El servidor existe en la base de datos y el esquema esperados.
La lista de herramientas es la que pretendías.
Cada identificador de herramienta apunta al objeto de Snowflake correcto.
El rol de conexión tiene USAGE en el servidor MCP.
El rol de conexión tiene los permisos necesarios en cada objeto subyacente.
Iniciar la configuración de la plantilla en ChatGPT
En ChatGPT, cambia al área de trabajo donde la app debe estar disponible.
Abre Configuración del área de trabajo > Aplicaciones.
Selecciona Directorio.
Busca Snowflake.
Selecciona la plantilla de app de Snowflake e inicia la configuración.
Introduce un nombre y una descripción claros para la app, como Snowflake o Snowflake - Analytics.
Introduce los detalles del servidor MCP administrado que solicite el flujo de configuración.
Si la pantalla de configuración solicita la URL completa del servidor MCP administrado, usa este formato:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Si la pantalla de configuración solicita campos separados, usa los mismos valores de esa URL:
Prefijo de host de Snowflake.
Base de datos.
Esquema.
Nombre del servidor MCP.
Crear y publicar la app en borrador
Guarda la configuración de la plantilla de Snowflake en ChatGPT.
Crea la app en borrador.
Revisa los detalles de la app en borrador, la configuración de autenticación y las acciones disponibles.
Publica la app en borrador cuando esté lista.
Confirma que la app aparece en Configuración del área de trabajo > Aplicaciones > Habilitadas.
Configura Acceso de usuarios para los roles que deben usarla.
Revisa Control de acciones para las herramientas expuestas.
Revisa Permisos de la app para elegir cuándo ChatGPT pregunta a los miembros antes de usar la app.
Estos permisos de la app se aplican a las conversaciones de ChatGPT. Los agentes del área de trabajo usan controles por agente definidos por el creador del agente para determinar qué acciones de la app están disponibles y cuándo se pide a los usuarios finales que las aprueben. Para el comportamiento de los agentes, consulta: Agentes del área de trabajo de ChatGPT para Enterprise y Business.
Probar la app
Inicia el flujo de conexión desde ChatGPT como usuario de prueba permitido.
Inicia sesión en Snowflake y selecciona el rol previsto si se te solicita.
Confirma que ChatGPT descubre las herramientas esperadas del servidor MCP.
Ejecuta primero una acción de lectura de bajo riesgo, como una búsqueda o una consulta de solo lectura sobre datos aprobados.
Confirma que los permisos de Snowflake impiden el acceso fuera del rol y los objetos aprobados.
URL del servidor MCP y comportamiento de OAuth
ChatGPT se conecta a la URL completa del servidor MCP administrado por Snowflake. ChatGPT usa el prefijo de host de Snowflake de esa URL para resolver los puntos de acceso de OAuth de Snowflake.
No pegues una URL de Snowsight, la URL raíz de la cuenta de Snowflake por sí sola ni ninguna URL con segmentos de ruta adicionales. La URL de MCP debe incluir la ruta de la base de datos, el esquema y el servidor MCP, y debe coincidir exactamente con tus objetos de Snowflake.
Solución de problemas
Servidor MCP no encontrado: vuelve a comprobar la URL completa del servidor MCP o los campos separados de prefijo de host, base de datos, esquema y servidor.
No aparecen herramientas en ChatGPT: confirma que la especificación del servidor MCP incluye herramientas y que el rol tiene USAGE en el servidor MCP.
Una herramienta aparece, pero falla al usarla: confirma que el rol tiene el permiso adecuado en el objeto subyacente de Snowflake.
La herramienta SQL falla: confirma que el nombre del almacén es correcto, que el almacén está disponible, que el rol tiene USAGE en él y que read_only es true si querías acceso de solo lectura.
La autorización falla: confirma que el usuario puede iniciar sesión en Snowflake y usar el rol previsto.
Problema de conexión con el nombre de host: usa el prefijo de host de Snowflake correcto. Los nombres de host de Snowflake con guiones bajos pueden causar problemas; prefiere los guiones.