메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.crewai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
개요

Snowflake 관리형 MCP 서버를 통해 CrewAI 에이전트를 Snowflake 데이터에 직접 연결하세요. Snowflake 연동을 사용하면 에이전트가 Cortex Analyst로 구조화된 데이터를 쿼리하고, Cortex Search로 비구조화된 데이터를 검색하며, 커넥터 코드를 작성하거나 호스팅할 필요 없이 웨어하우스에 대해 관리되는 SQL을 실행할 수 있습니다. 내부적으로 Snowflake 연동은 CrewAI의 Custom MCP Server 지원을 기반으로 하는 관리형 래퍼입니다. Snowflake는 Model Context Protocol 엔드포인트를 통해 Cortex AI 기능을 노출하며, CrewAI가 이를 안전하게 연결합니다. Snowflake 측에서 노출하는 모든 도구 — Cortex Analyst, Cortex Search, SQL 실행, Cortex Agents 또는 사용자 정의 도구 — 가 크루에서 사용할 수 있게 됩니다.

​
주요 기능

Cortex Analyst

자연어로 질문하고 Cortex Analyst가 풍부한 시맨틱 모델을 사용하여 구조화된 데이터에 대해 SQL을 생성하고 실행하도록 합니다.

Cortex Search

Snowflake의 완전 관리형 검색 서비스인 Cortex Search를 사용하여 RAG 및 지식 워크플로우를 위한 관련 비구조화된 데이터를 검색합니다.

SQL 실행

구성 가능한 읽기 전용 모드, 타임아웃 및 웨어하우스 선택을 통해 Snowflake 웨어하우스에 대해 관리되는 SQL 쿼리를 직접 실행합니다.
연동이 MCP 서버가 게시하는 도구를 노출하므로, Cortex Agents 및 사용자 정의 도구(사용자 정의 함수 및 저장 프로시저)도 CrewAI 에이전트에 노출할 수 있습니다.

​
사전 준비 사항

Snowflake 연동을 사용하기 전에 다음을 확인하십시오:
  • 활성 구독이 있는 CrewAI AMP 계정
  • Cortex AI 기능에 액세스할 수 있는 Snowflake 계정
  • 노출하려는 도구가 구성된 Snowflake 관리형 MCP 서버
  • MCP 서버 및 기본 객체에 대한 적절한 Snowflake 권한(USAGE/SELECT)

​
Snowflake MCP 서버 설정

Snowflake 관리형 MCP 서버는 Snowflake 계정 내에서 실행되며 CrewAI와 같은 외부 클라이언트에서 사용할 수 있는 도구를 정의합니다. CREATE MCP SERVER 명령을 사용하여 노출하려는 Cortex Search 서비스, Cortex Analyst 시맨틱 뷰 및 SQL 도구를 나열하여 생성합니다. 
CREATE MCP SERVER my_mcp_server
  FROM SPECIFICATION $$
    tools:
      - name: "sales_analyst"
        type: "CORTEX_ANALYST"
        identifier: "MY_DATABASE.MY_SCHEMA.sales_semantic_view"
        description: "Answer questions about sales metrics"
      - name: "docs_search"
        type: "CORTEX_SEARCH_SERVICE_QUERY"
        identifier: "MY_DATABASE.MY_SCHEMA.support_docs_search"
        description: "Search internal support documentation"
      - name: "run_sql"
        type: "SQL_EXECUTION"
        description: "Execute read-only SQL queries"
  $$;
MCP 엔드포인트는 https://<account_URL>/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{name} 형식을 따릅니다. CrewAI는 연동 구성 시 제공하는 계정 URL, 데이터베이스, 스키마 및 MCP 서버 이름을 사용하여 이 URL을 자동으로 구성합니다.
Cortex Agents, 사용자 정의 도구, 응답 크기 제한 및 거버넌스 옵션을 포함한 전체 사양은 Snowflake 관리형 MCP 서버 문서를 참조하세요.

​
CrewAI AMP에서 Snowflake 연결

CrewAI AMP에서 Snowflake 연동 구성
1

도구 및 연동 열기

CrewAI AMP 왼쪽 사이드바에서 도구 및 연동으로 이동하고, 애플리케이션 목록에서 Snowflake를 찾아 구성 패널을 엽니다.
2

연결 세부 정보 제공

CrewAI가 Snowflake MCP 서버에 연결하는 데 사용하는 연결 필드를 채웁니다:
필드필수설명
이름예이 연결의 설명적 이름(기본값: Snowflake).
설명아니오이 연결이 제공하는 내용에 대한 선택적 요약.
계정 URL예Snowflake 계정 URL, 예: xy12345.us-east-1.snowflakecomputing.com.
데이터베이스예MCP 서버가 포함된 데이터베이스(예: MY_DATABASE).
스키마예MCP 서버가 포함된 스키마(예: MY_SCHEMA).
MCP 서버 이름예Snowflake에서 생성한 MCP 서버 객체의 이름(예: MY_MCP_SERVER).
3

인증 방법 선택

CrewAI가 Snowflake에 인증하는 방법을 선택합니다. OAuth가 권장됩니다.
  • OAuth 사용 — 자격 증명을 공유하지 않고 토큰 기반 인증을 위해 OAuth 2.0을 사용하여 안전하게 연결합니다. CrewAI가 전체 인증 흐름을 처리하고 자동으로 토큰을 갱신합니다. 양식에 표시된 리디렉트 URI(https://oauth.crewai.com/oauth/add)를 복사하여 Snowflake OAuth 보안 연동에 인증된 리디렉트 URI로 등록하세요.
  • 개인 액세스 토큰 사용 — Snowflake 계정 설정에서 생성한 프로그래밍 방식 액세스 토큰을 사용하여 인증합니다. 노출을 제한하기 위해 토큰에 최소 권한 역할을 할당하세요.
4

인증

인증을 클릭합니다. OAuth의 경우 Snowflake로 리디렉션되어 액세스를 승인합니다. 인증되면 Snowflake 서버가 연결 목록에 나타나고 해당 도구를 크루에서 사용할 수 있게 됩니다.
OAuth를 사용하면 각 사용자가 개별적으로 인증하며 쿼리는 해당 Snowflake DEFAULT_ROLE로 실행됩니다. 연결하는 사용자에게 기본 역할과 웨어하우스가 설정되어 있는지 확인하세요(ALTER USER <username> SET DEFAULT_ROLE = '<role>' DEFAULT_WAREHOUSE = '<warehouse>'). 그래야 Cortex Analyst 및 SQL 도구에 실행할 컴퓨팅이 있습니다.

​
크루에서 Snowflake 도구 사용

연결되면 MCP 서버가 노출하는 도구가 도구 및 연동 페이지에서 기본 연결과 함께 표시됩니다. 다음을 수행할 수 있습니다:
  • 다른 CrewAI 도구처럼 크루의 에이전트에 도구를 할당합니다.
  • 가시성을 관리하여 어떤 팀원이 연결을 사용할 수 있는지 제어합니다.
  • 연결 목록에서 언제든지 연결을 편집하거나 제거합니다.
이제 에이전트가 Cortex Analyst에 메트릭을 요청하고, 문서에 대해 Cortex Search를 실행하고, SQL을 실행할 수 있으며 — 결과가 자동으로 추론에 반영됩니다.
Snowflake는 MCP 서버에 거버넌스를 적용합니다: 역할 기반 액세스 제어가 사용자가 발견하고 호출할 수 있는 도구를 결정하며, 응답 크기, 도구 수(서버당 최대 50개) 및 재귀 깊이에 제한이 적용됩니다. 도구 호출이 실패하면 연결하는 사용자의 역할에 MCP 서버 및 기본 객체에 대한 필수 권한이 있는지 확인하세요.

​
자세히 알아보기

Snowflake 관리형 MCP 서버

MCP 서버를 생성하고 관리하기 위한 공식 Snowflake 문서.

CrewAI의 Custom MCP 서버

CrewAI가 모든 MCP 서버에 연결하는 방법을 알아보세요. Snowflake 연동이 기반으로 하는 기초입니다.

도움이 필요하신가요?

Snowflake 연동 또는 문제 해결에 대해 지원팀에 문의하세요.