MCP Connecteurs¶

Vue d’ensemble¶

Un connecteur MCP dans Snowflake connecte Snowflake Intelligence et Cortex Agents à un Model Context Protocol (MCP) distant, ce qui permet à l’agent de découvrir et d’invoquer des outils hébergés par des fournisseurs tels que Atlassian Jira, Salesforce ou vos propres applications personnalisées. Avec les connecteurs MCP, vos agents peuvent aller au-delà de la réponse aux questions pour prendre des mesures sur les systèmes d’entreprise, telles que la création de tickets Jira, la mise à jour des enregistrements Salesforce ou la publication sur Slack, le tout dans l’environnement contrôlé de Snowflake.

Configuration des connecteurs MCP pris en charge¶

Vous pouvez vous connecter avec les serveurs MCP suivants avec une configuration minimale :

• Atlassian

• GitHub

• Glean

• Linear

• Salesforce

Avec ces fournisseurs MCP, vous effectuez le workflow suivant :

1. Spécifiez les détails du fournisseur dans le champ de type API_USER_AUTHENTICATION.

2. Définissez la configuration du fournisseur, qui est unique pour chaque fournisseur.

3. Référencez cette intégration d’API dans la création d’objet de serveur MCP externe.

-- 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;

Connecteurs MCP personnalisés¶

Vous pouvez également configurer manuellement des connecteurs personnalisés pour qu’ils se connectent à n’importe quel point de terminaison compatible avec MCP.

1. Fournissez la configuration OAuth complète dans le cadre de la création de l’intégration d’API :

   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

   Vous pouvez également utiliser l’intégration d’API avec 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. Créez l’objet de serveur 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. Mentionnez le serveur MCP dans la configuration Agent :

   CopyExpand

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

   Show lessSee more

   Scroll to top

Ajouter les connecteurs MCP au Cortex Agent¶

Une fois l’objet de serveur MCP créé, le développeur de l’agent le référence dans la configuration du Cortex Agent. Les connecteurs MCP sont disponibles dans l’UI Agent Admin, où les développeurs peuvent parcourir et sélectionner des connecteurs MCP configurés au niveau du compte. Vous pouvez également utiliser SQL ou une API pour ajouter des connecteurs MCP à vos agents.

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"}
    ]
}

Les Cortex Agents qui font référence à ces serveurs MCP peuvent accéder aux outils fournis par le fournisseur. Par exemple, avec Atlassian, ces outils permettent notamment de créer des tickets Jira, de commenter des tickets, de créer des pages Confluence et de mettre à jour des pages existantes.

Lorsque l’agent est appelé, il récupère la liste des outils de chaque serveur MCP et inclut ces outils dans son orchestration. L’agent sélectionne et appelle les outils en fonction de la requête de l’utilisateur et des descriptions d’outils fournies par le serveur MCP.

Utiliser les connecteurs MCP dans Snowflake Intelligence¶

Les utilisateurs Snowflake Intelligence se connectent à des serveurs MCP externes via l’interface Snowflake Intelligence :

1. Accédez à l’interface Snowflake Intelligence en suivant les instructions dans Accéder à l’agent.

2. Ouvrez le panneau des sources et sélectionnez Connectors.

3. Sélectionnez Connect à côté du connecteur choisi. Vous pouvez également sélectionner Manage Connections, puis sélectionner Connect.

4. L’utilisateur est redirigé vers la page d’authentification du service tiers pour approuver la connexion.

5. Après l’authentification, le connecteur apparaît comme Connected dans la liste des sources. Vous pouvez désormais interagir avec l’Agent pour obtenir des informations depuis le serveur MCP externe.

Pour déconnecter le serveur, l’utilisateur peut effectuer les opérations suivantes :

1. Sélectionnez Manage Connections.

2. Sélectionnez MCP Server puis Disconnect.

Les utilisateurs peuvent connecter et déconnecter des connecteurs dans la liste déroulante des sources pour les inclure ou les exclure de l’orchestration de l’agent. Les connecteurs qui ne sont pas en état Connected ne sont pas inclus dans l’orchestration.

Lorsque le jeton d’authentification d’un utilisateur expire, Snowflake Intelligence invite l’utilisateur à se réauthentifier.

Utiliser les connecteurs MCP dans l’API Agent:run¶

L’API Agent:run se connecte aux serveurs MCP via l’interface client. Utilisez les fonctions suivantes pour authentifier les utilisateurs auprès du service tiers :

• Fonction pour démarrer le flux 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

• Fonction pour mettre un terme au flux OAuth :

  CopyExpand

  SYSTEM$FINISH_OAUTH_FLOW( '<query_string>' )
  

  Show lessSee more

  Scroll to top

SYSTEM$START_USER_OAUTH_FLOW renvoie une URL d’autorisation pour les intégrations d’API avec API_PROVIDER = EXTERNAL_MCP. Ouvrez l’URL dans un navigateur pour remplir le consentement, puis exécutez SYSTEM$FINISH_OAUTH_FLOW dans la même session avec la chaîne de requête de l’URL de redirection. Pour plus d’informations sur SYSTEM$FINISH_OAUTH_FLOW, voir SYSTEM$FINISH_OAUTH_FLOW.

Gérer les serveurs 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;

Considérations clés et bonnes pratiques¶

• Serveurs MCP personnalisés : utilisez des serveurs personnalisés lors de la connexion aux points de terminaison MCP ne figurant pas dans la liste des connecteurs MCP disponibles. Snowflake prend en charge les types d’authentification utilisateur pour Atlassian, GitHub, Glean, Linear et Salesforce dans l’intégration d’API.

• Accès au moindre privilège : n’accordez que les privilèges minimaux requis pour chaque rôle. L’accès à un serveur MCP n’accorde pas automatiquement l’accès à ses outils ; vous devez accorder des autorisations séparément pour chaque outil.

• Authentification OAuth : Snowflake prend uniquement en charge l’utilisation OAuth pour toutes les connexions au serveur MCP.

• Désactivation ou suppression : désactiver une intégration d’API préserve la configuration, mais invalide immédiatement tous les jetons utilisateur et les blocs d’appel d’outils. Supprimer une intégration d’API la supprime définitivement, ainsi que tous les secrets stockés. Désactiver l’intégration lors de la maintenance. Supprimez l’intégration lors de la mise hors service.

• Formatage du nom d’hôte : utilisez des traits d’union (-) au lieu de traits de soulignement (_) dans les noms d’hôte lors de la configuration des connexions au serveur MCP. Les noms d’hôte contenant des traits de soulignement entraînent des problèmes de connexion.

Limitations¶

Les limitations suivantes s’appliquent aux connecteurs MCP :

• Surveillance : les appels d’outils MCP ne sont pas consignés dans la table de surveillance.

• Portée du protocole MCP : les serveurs MCP externes ne prennent en charge que les capacités d’outils. Les ressources, les invites, les racines, les notifications, les accords de version, les phases de cycle de vie et l’échantillonnage ne sont pas pris en charge.

• Intégrations désactivées : vous ne pouvez pas créer de serveur MCP qui fait référence à une intégration d’API désactivée.

• Format du nom d’hôte : les noms d’hôte doivent utiliser des traits d’union et non des traits de soulignement.