MCP 件のコネクタ¶

概要¶

Snowflakeの MCP コネクタは Snowflake Intelligence およびCortex Agentをリモートのモデルコンテキストプロトコル（ MCP ）サーバーに接続し、エージェントがAtlassian Jira、Salesforce、独自のカスタムアプリケーションなどのプロバイダーによってホストされているツールを検出して呼び出せるようにします。MCP コネクタを使用すると、エージェントは質問に回答するだけでなく、Jiraチケットの作成、Salesforceの記録の更新、Slackへの投稿など、すべてSnowflakeの管理対象環境内で、エンタープライズシステム全体でアクションを実行できます。

サポートされている MCP コネクタの設定¶

最小限の構成を持つ以下の MCP サーバーに接続できます。

• Atlassian

• GitHub

• Glean

• Linear

• Salesforce

これらの MCP プロバイダーの場合は、次のワークフローを完了します。

1. API_USER_AUTHENTICATION 型フィールドで、プロバイダーの詳細を指定します。

2. 各プロバイダーに固有のプロバイダー構成を設定します。

3. 外部 MCP サーバーオブジェクトの作成でこの API 統合を参照します。

-- Create the API integration using dynamic client registration (DCR)
CREATE API INTEGRATION jira_mcp_api_integration
  API_PROVIDER = external_mcp
  API_ALLOWED_PREFIXES = ('https://mcp.jira.atlassian.com')
  API_USER_AUTHENTICATION = (
    TYPE=OAUTH_DYNAMIC_CLIENT,
    OAUTH_RESOURCE_URL='https://mcp.atlassian.com/v1/mcp'
  )
  ENABLED = TRUE;

-- Create the external MCP server
CREATE EXTERNAL MCP SERVER atlassian_mcp_server
  WITH DISPLAY_NAME = 'Atlassian (Jira & Confluence)'
  URL='https://mcp.atlassian.com/v1/mcp'
  API_INTEGRATION = jira_mcp_api_integration;

カスタム MCP コネクタ¶

また、カスタムコネクタを手動で構成して、任意の MCP 互換エンドポイントに接続できます。

1. API 統合の作成の一環として、完全な OAuth 構成を提供します。

   CopyExpand

    -- Create the API integration with full OAuth configuration
   CREATE API INTEGRATION custom_mcp_api_integration
      API_PROVIDER = external_mcp
      API_ALLOWED_PREFIXES = ('https://internal.mycompany.com/mcp')
      API_USER_AUTHENTICATION = (
        TYPE = OAUTH2
        OAUTH_CLIENT_ID = 'your_client_id'
        OAUTH_CLIENT_SECRET = 'your_client_secret'
        OAUTH_TOKEN_ENDPOINT = 'https://internal.mycompany.com/oauth/token'
        OAUTH_CLIENT_AUTH_METHOD = CLIENT_SECRET_BASIC
        OAUTH_AUTHORIZATION_ENDPOINT = 'https://internal.mycompany.com/oauth/authorize'
      )
      ENABLED = TRUE;
   

   Show lessSee more

   Scroll to top

   または、 API 統合と DCR を使用できます。

   CopyExpand

   CREATE API INTEGRATION custom_mcp_api_integration
     API_PROVIDER = external_mcp
     API_ALLOWED_PREFIXES = ('https://internal.mycompany.com/mcp')
     API_USER_AUTHENTICATION = (
       TYPE = OAUTH_DYNAMIC_CLIENT
       OAUTH_RESOURCE_URL='https://internal.mycompany.com/mcp'
     )
     ENABLED = TRUE;
   

   Show lessSee more

   Scroll to top

2. MCP サーバーオブジェクトを作成します。

   CopyExpand

   -- Create the external MCP server
   CREATE EXTERNAL MCP SERVER mycompany_mcp_server
     WITH DISPLAY_NAME = 'Mycompany MCP server'
     API_INTEGRATION = custom_mcp_api_integration;
   

   Show lessSee more

   Scroll to top

3. エージェント構成の MCP サーバーを参照します。

   CopyExpand

   -- Add MCP server to agent
   ALTER AGENT my_support_agent
     ADD MCP_SERVER = 'db.schema.MCP server';
   

   Show lessSee more

   Scroll to top

MCP コネクタをCortex Agentへ追加する¶

MCP サーバーオブジェクトの作成後、エージェント開発者はCortex Agent構成でそれを参照します。MCP コネクタはAgent Admin UI で使用できます。そこでは、開発者はアカウントレベルで構成された MCP コネクタから閲覧して選択できます。SQL または API を使用して、 MCP コネクタをエージェントに追加することもできます。

ALTER AGENT [ IF EXISTS ] <name> MODIFY LIVE VERSION SET SPECIFICATION $$
    <previous_spec>
    mcp_servers:
      - server_spec:
         name: "db.schema.mcp_server1"
      - server_spec:
         name: "db.schema.mcp_server2"
$$;

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

{
    "comment": "An agent to answer questions about all my data",
    "profile": {
        "display_name": "My Agent"
    },
    "models": {
        "orchestration": "claude-4-sonnet"
    },
    "mcp_servers": [
        {"server_spec": "prod_db.integrations.jira_mcp_server"},
        {"server_spec": "prod_db.integrations.github_mcp_server"}
    ]
}

これらの MCP サーバーを参照するCortex Agentsは、プロバイダーが提供するツールにアクセスできます。例えば、Atlassianの場合、ツールにはJiraの問題の作成、問題へのコメント、Confluenceページの作成、既存のページの更新などがあります。

エージェントが呼び出されると、各 MCP サーバーからツールリストを取得します。サーバーのオーケストレーションにこれらのツールが含まれています。エージェントは、ユーザーのクエリと MCP サーバーから提供されたツールの説明に基づいてツールを選択し、呼び出します。

Snowflake Intelligence での MCP コネクタの使用¶

Snowflake Intelligence ユーザーは、 Snowflake Intelligence インターフェースを介して外部の MCP サーバーに接続します。

1. エージェントにアクセスする の指示に従って、 Snowflake Intelligence インターフェースにナビゲートします。

2. ソースパネルを開き、 Connectors を選択します。

3. 選択したコネクタの横にある Connect を選択します。また、 Manage Connections を選択してから、 Connect を選択します。

4. ユーザーはサードパーティサービスの認証ページにリダイレクトされ、接続を承認します。

5. 認証後、コネクタはソースリストに Connected として表示されます。エージェントと対話して、外部の MCP サーバーから情報を取得できるようになりました。。

サーバーを切断するには、ユーザーは以下の手順を完了します。

1. Manage Connections を選択します。

2. MCP Server 、 Disconnect の順に選択します。

ユーザーは、ソースドロップダウンでコネクタを接続または切断して、エージェントのオーケストレーションに含めるか、除外できます。Connected 状態でないコネクタはオーケストレーションに含まれません。

ユーザーの認証トークンの有効期限が切れると、 Snowflake Intelligence はユーザーに再認証を求めます。

Agent:run API での MCP コネクタの使用¶

Agent:run API を実行して、クライアントインターフェースを介して MCP サーバーに接続します。サードパーティサービスでユーザーを認証するには、次の関数を使用します。

• OAuth フローを開始する関数:

  CopyExpand

  -- Returns authorization URI to authenticate through the third-party service
  SELECT SYSTEM$START_USER_OAUTH_FLOW('<API_INTEGRATION_NAME>');
  

  Show lessSee more

  Scroll to top

• OAuth フローを終了する関数:

  CopyExpand

  SYSTEM$FINISH_OAUTH_FLOW( '<query_string>' )
  

  Show lessSee more

  Scroll to top

SYSTEM$START_USER_OAUTH_FLOW は、 API_PROVIDER = EXTERNAL_MCP の API 統合用の認証 URL を返します。ブラウザーで URL を開き、同意を完了し、 URL リダイレクトからのクエリ文字列を使用して同じセッション内で SYSTEM$FINISH_OAUTH_FLOW を実行します。SYSTEM$FINISH_OAUTH_FLOW の詳細については、 SYSTEM$FINISH_OAUTH_FLOW をご参照ください。

MCP サーバーの管理¶

-- List all MCP servers in the account
SHOW EXTERNAL MCP SERVERS IN ACCOUNT;

-- List MCP servers in a specific database or schema
SHOW EXTERNAL MCP SERVERS IN DATABASE prod_db;
SHOW EXTERNAL MCP SERVERS IN SCHEMA prod_db.integrations;

DESCRIBE EXTERNAL MCP SERVER mycompany_mcp_server;

-- Disable the MCP server
ALTER API INTEGRATION mycompany_mcp_integration SET ENABLED = FALSE;

-- Re-enable the MCP server
ALTER API INTEGRATION mycompany_mcp_integration SET ENABLED = TRUE;

-- Drop the MCP server
DROP EXTERNAL MCP SERVER mycompany_mcp_server;

-- Drop the API integration (permanently deletes OAuth configuration and secrets)
DROP API INTEGRATION mycompany_mcp_integration;

主な考慮事項とベストプラクティス¶

• カスタム MCP サーバー: 使用可能な MCP コネクタリストにない MCP エンドポイントに接続している場合、カスタムサーバーを使用します。Snowflakeは、 API 統合でAtlassian、 GitHub 、Glean、Linear、Salesforceのユーザー認証タイプをサポートしています。

• 最小権限のアクセス: 各ロールに必要最低限の権限のみを付与します。MCP サーバーへのアクセスはツールへのアクセスを自動的に付与しません。ツールごとに個別に権限を付与する必要があります。

• OAuth 認証: Snowflakeは、すべての MCP サーバー接続で OAuth の使用のみをサポートしています。

• 無効またはドロップ: API 統合を無効化しても、その構成は保持されますが、すぐにすべてのユーザートークンが無効になり、ツール呼び出しはブロックされます。API 統合をドロップすると、保存されているすべてのシークレットとともに永久に削除されます。メンテナンスを実行する場合は、統合を無効にします。デコミッショニング時に統合をドロップします。

• ホスト名の書式設定: MCP サーバー接続の構成時に、ホスト名にアンダースコア（ _ ）の代わりにハイフン（ - ）を使用します。アンダースコアを含むホスト名は、接続の問題を引き起こします。

制限事項¶

MCP コネクタには、次の制限が適用されます。

• **モニタリング:**MCP ツール呼び出しはモニタリングテーブルにログされません。

• MCP プロトコルスコープ: 外部 MCP サーバーはツール機能のみをサポートしています。リソース、プロンプト、ルート、通知、バージョン交渉、ライフサイクルフェーズ、サンプリングはサポートされていません。

• 無効な統合: 無効な API 統合を参照する MCP サーバーは作成できません。

• ホスト名の形式: ホスト名にはアンダースコアではなくハイフンを使用する必要があります。