MCP-Konnektoren¶

Übersicht¶

Ein MCP-Konnektor in Snowflake verbindet Snowflake Intelligence und Cortex Agenten mit einem entfernten Model Context Protocol (MCP)-Server, sodass der Agent Tools erkennen und aufrufen kann, die von Anbietern wie Atlassian Jira, Salesforce oder Ihren eigenen benutzerdefinierten Anwendungen bereitgestellt werden Durch MCP-Konnektoren können Ihre Agenten über die Beantwortung von Fragen hinaus gehen und Aktionen in Unternehmenssystemen durchführen, z. B. das Erstellen von Jira-Tickets, das Aktualisieren von Salesforce-Datensätzen oder das Posten in Slack, und das alles innerhalb der verwalteten Umgebung von Snowflake.

Einrichten unterstützter MCP-Konnektoren¶

Sie können sich mit minimalem Konfigurationsaufwand mit den folgenden MCP-Servern verbinden

• Atlassian

• GitHub

• Glean

• Linear

• Salesforce

Mit diesen MCP-Anbietern durchlaufen Sie den folgenden Workflow:

1. Geben Sie in die Anbieterdetails im Typfeld API_USER_AUTHENTICATION an.

2. Richten Sie die Anbieterkonfiguration ein, die für jeden Anbieter eindeutig ist.

3. Referenzieren Sie diese API-Integration bei der Erstellung des externen MCP-Server-Objekts.

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

Kundenspezifische MCP-Konnektoren¶

Sie können benutzerdefinierte Konnektoren auch manuell konfigurieren, um eine Verbindung zu einem beliebigen MCP-kompatiblem Endpunkt herzustellen.

1. Stellen Sie die vollständige OAuth-Konfiguration als Teil der API-Integrationserstellung bereit:

   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

   Alternativ können Sie auch API-Integration mit DCR verwenden:

   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. Erstellen Sie das MCP-Serverobjekt:

   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. Referenzieren Sie den MCP-Server in der Konfiguration des Agenten:

   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-Konnektoren zum Cortex Agent hinzufügen¶

Nach der MCP-Serverobjekterstellung referenziert der Agentenentwickler es in der Cortex Agent-Konfiguration. MCP-Konnektoren sind im Agent Admin-UI verfügbar, wo Entwickler MCP-Konnektoren durchsuchen und auswählen können, die auf Kontoebene konfiguriert sind. Sie können auch SQL oder API verwenden, um MCP-Konnektoren zu Ihren Agenten hinzuzufügen.

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

Cortex Agenten, die auf diese MCP-Server verweisen, können auf vom Anbieter bereitgestellte Tools zugreifen. Beispielsweise umfassen die Tools bei Atlassian das Erstellen von Jira-Tickets, das Kommentieren von Tickets, das Erstellen von Confluence-Seiten sowie das Aktualisieren bestehender Seiten.

Wenn der Agent aufgerufen wird, ruft er die Toolliste von jedem MCP-Server ab und bezieht diese Tools in seine Orchestrierung ein. Der Agent wählt Tools basierend auf der Anfrage des Benutzers und den vom MCP-Server bereitgestellten Tool-Beschreibungen aus und ruft diese auf.

Verwenden von MCP-Konnektoren in Snowflake Intelligence¶

Snowflake Intelligence-Benutzer verbinden sich mit externen MCP-Servern über die Snowflake Intelligence-Schnittstelle:

1. Navigieren Sie zu Snowflake Intelligence, indem Sie die Anweisungen unter Zugriff auf den Agenten befolgen.

2. Öffnen Sie das Quellenfenster und wählen Sie Connectors aus.

3. Wählen Sie Connect neben dem gewünschten Konnektor. Sie können auch Manage Connections auswählen. Wählen Sie dann Connect.

4. Der Benutzer wird auf die Seite des Authentifizierungsdienstes eines Drittanbieters weitergeleitet, um die Verbindung zu genehmigen.

5. Nach der Authentifizierung wird der Konnektor als Connected in der Liste der Quellen angezeigt. Sie können nun mit dem Agenten interagieren, um Informationen vom externen MCP-Server zu erhalten.

Um die Verbindung zum Server zu trennen, kann der Benutzer Folgendes tun:

1. Wählen Sie Manage Connections aus.

2. Wählen Sie MCP Server und dann Disconnect aus.

Benutzer können Konnektoren im Dropdown-Menü „Quellen“ verbinden und trennen, um sie in die Orchestrierung des Agenten einzubeziehen oder davon auszuschließen. Konnektoren, die nicht im Connected-Status enthalten, sind bei der Orchestrierung nicht enthalten.

Wenn das Authentifizierungstoken eines Benutzers abläuft, forder Snowflake Intelligence den Benutzer auf, sich erneut zu authentifizieren.

Verwenden von MCP Konnektoren in Agent:run API¶

Agent:run API stellt eine Verbindung zu MCP-Servern über die Clientschnittstelle her. Verwenden Sie die folgenden Funktionen, um Benutzer mit dem Drittanbieterdienst zu authentifizieren:

• Funktion zum Starten des OAuth-Ablaufs:

  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

• Funktion zum Beenden des OAuth-Ablaufs:

  CopyExpand

  SYSTEM$FINISH_OAUTH_FLOW( '<query_string>' )
  

  Show lessSee more

  Scroll to top

SYSTEM$START_USER_OAUTH_FLOW gibt eine Autorisierungs-URL für API-Integrationen mit API_PROVIDER = EXTERNAL_MCP zurück. Öffnen Sie die URL in einem Browser, um die Zustimmung zu vervollständigen, und führen Sie dann SYSTEM$FINISH_OAUTH_FLOW in derselben Sitzung mit der Abfragezeichenfolge aus der Umleitungs-URL aus. Weitere Informationen zu SYSTEM$FINISH_OAUTH_FLOW finden Sie unter SYSTEM$FINISH_OAUTH_FLOW.

Verwalten von MCP-Servern¶

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

Wichtige Hinweise und Best Practices¶

• Benutzerdefinierte MCP-Server: Verwenden Sie benutzerdefinierte Server, wenn Sie eine Verbindung zu MCP-Endpunkten herstellen, die nicht in der Liste der verfügbaren MCP-Konnektoren sind. Snowflake unterstützt Benutzerauthentifizierungstypen für Atlassian, GitHub, Glean, Linear und Salesforce in der API-Integration.

• Zugriff mit geringsten erforderlichen Berechtigungen: Gewähren Sie jeder Rolle nur die geringsten erforderlichen Berechtigungen. Der Zugriff auf einen MCP-Server gewährt nicht automatisch Zugriff auf dessen Tools; Sie müssen die Berechtigungen für jedes Tool separat erteilen.

• OAuth-Authentifizierung: Snowflake unterstützt nur die Verwendung von OAuth für alle MCP-Serververbindungen.

• Deaktivieren oder Löschen: Deaktivieren einer API-Integration behält ihre Konfiguration bei, macht aber sofort alle Benutzer-Token ungültig und blockiert Tool-Aufrufe. Löschen einer API-Integration löscht sie zusammen mit allen gespeicherten Geheimnissen dauerhaft. Deaktivieren Sie die Integration, wenn Sie Wartungsarbeiten durchführen. Löschen Sie die Integration bei einer Stilllegung.

• Formatierung von Hostnamen: Verwenden Sie Bindestriche (-) anstelle von Unterstrichen (_) in Hostnamen bei der Konfiguration von MCP-Serververbindungen. Hostnamen mit Unterstrichen verursachen Verbindungsprobleme.

Einschränkungen¶

Es gelten die folgenden Einschränkungen für MCP-Konnektoren:

• Überwachung: MCP-Tool-Aufrufe werden nicht in der Überwachungstabelle protokolliert.

• MCP-Protokollbereich: Externe MCP-Server unterstützen nur Tool-Funktionen. Ressourcen, Eingabeaufforderungen, Roots, Benachrichtigungen, Versionsverhandlungen, Lebenszyklusphasen und Sampling werden nicht unterstützt.

• Deaktivierte Integrationen: Sie können keinen MCP-Server erstellen, der auf eine deaktivierte API-Integration verweist.

• Format von Hostnamen: Hostnamen dürfen Bindestriche und keine Unterstriche enthalten.