Ansluta Genie Code till MCP-servrar

Anslut Genie Code till externa verktyg och datakällor via Model Context Protocol (MCP). Genie Code kan använda alla MCP-servrar som har lagts till på din arbetsyta och som du har behörighet att använda.

Anmärkning

MCP-servrar stöds endast i Genie Code Agent-läge.

Vad är MCP?

MCP är en open-source standard som ansluter AI-agenter till verktyg, resurser, uppmaningar och annan kontextbaserad information. MCP är ett standardiserat sätt att exponera verktyg, data och arbetsflöden för Genie Code utan att bädda in kontexten direkt i uppmaningar eller instruktioner.

MCP är utformat för fall där det redan finns en viktig kontext men är svår att komma åt från en AI-agent, till exempel Genie Code. MCP erbjuder ett säkert sätt att ge Genie Code åtkomst till kontext som följande:

  • Dokumentationssystem: Teams behåller ofta runbooks eller operativa dokument i verktyg som Confluence. I stället för att kopiera avsnitt till prompter kan innehållet exponeras en gång via en extern MCP-server och refereras när det är relevant. Dina dokument kanske också redan finns i Databricks som ett vektorsökningsindex, som Genie Code kan använda för att fråga relevanta dokument.
  • Verktyg och tjänster: Plattformsteam kan underhålla API:er eller skript för installation, validering eller distribution. MCP gör dessa funktioner direkt tillgängliga för Genie Code.
  • Datakällor: Om du redan har data i Databricks kan du ansluta Genie Code till ett Genie Space som hjälper dig att analysera data med naturligt språk. För data som lagras utanför Databricks kan du ge Genie Code säker åtkomst via externa MCP-servrar.
  • Anpassade appar: Du kan också lägga till anpassade funktioner som hanteras via Databricks-appar. På så sätt kan du ansluta Genie Code till egna verktyg, arbetsflöden eller integreringar som skapats specifikt för dig eller din organisation, som alla hanteras på ett säkert sätt på din Databricks-arbetsyta.

I dessa fall ersätter MCP manuell kopiering med en strukturerad, återanvändbar metod, vilket gör rätt kontext tillgänglig endast när den behövs.

Du kan ansluta Genie Code till alla MCP-servrar på din arbetsyta som du har behörighet att använda. Arbetsyteadministratörer styr vilka servrar som är tillgängliga, medan användare kan välja från de godkända källorna efter behov.

Mer information om MCP-servrar i Databricks och hur du skapar egna finns i McP (Model Context Protocol) på Databricks.

Ansluta till datakällor från tredje part

Viktigt!

Den här funktionen finns i Beta. Om du vill använda anslutningsprogram för datakällor från tredje part måste en arbetsyteadministratör aktivera förhandsversionen av anslutningsprogram från tredje part för agenter . Se Hantera Azure Databricks förhandsversioner.

Genie Code tillhandahåller inbyggda anslutningsappar för vanliga företagsdatakällor, inklusive Google Drive och SharePoint.

Genom att ansluta till dessa datakällor kan Genie Code söka i dina dokument när du svarar på frågor. Varje användare autentiserar individuellt och OAuth-token delas inte mellan användare.

Så här ansluter du en datakälla från tredje part:

  1. På din arbetsyta klickar du på Sparkle genie code-ikonen. Genie Code i det övre högra hörnet för att öppna en chatt.
  2. I promptfältet klickar du på Ny ikon. plusikonen.
  3. Bredvid den datakälla som du vill ansluta till klickar du på Anslut.
  4. Slutför stegen för att logga in.

När du har autentiserats kan Genie Code söka i dina dokument när du svarar på frågor. Metaarkivadministratörer och anslutningsägare kan hantera eller återkalla användarbehörigheter för anslutningen. Se Dela MCP-serveranslutningen.

Anmärkning

Datakällans verktyg aktiveras inte alltid automatiskt. Om dokumentsökningen inte startar kan du prova att uttryckligen uppmana Genie Code att använda verktyget, till exempel "använd Google Docs" eller "använd SharePoint".

Om du vill ansluta andra datakällor lägger du till dem manuellt i Genie Code. Se Lägga till MCP-servrar i Genie Code manuellt.

Begränsningar för Google Drive

  • När du auktoriserar Google Drive kan du se en "icke-verifierad app"-skärm. Klicka på Avancerat och fortsätt auktoriseringsprocessen.
  • Maximal filstorlek är 10 MB.
  • Endast interna Google Workspace-filer (Docs, Sheets, Slides) stöds. PDF-filer, bilder och andra binära format stöds inte.
  • Anslutnings- eller tokens förfallofel kan visas i agentens utdata. Autentisera igen för att lösa.

SharePoint begränsningar

  • Maximal filstorlek är 10 MB.
  • Filtyper som stöds är Office-dokument (.docx, .xlsx, .pptx), samt vanliga textbaserade format som .txt, .csv, .json, .mdoch andra. PDF-filer, bilder och andra binära format stöds inte.

Lägg till MCP-servrar i Genie Code manuellt

Om du vill ansluta Genie Code till en MCP-server lägger du till den i inställningarna för Genie Code:

  1. Öppna inställningarna för Genie Code. I panelen Genie Code klickar du på kugghjulsikonen. Inställningar.
  2. Under MCP-servrar klickar du på Ny ikon. Lägg till server.
  3. Välj de MCP-servrar som du vill lägga till. Du kan välja Databricks-hanterade MCP-servrar eller externa MCP-servrar:
    • Funktionen Unity Catalog: Välj schemat för funktionen. På så sätt kan Genie Code använda funktioner för att köra fördefinierade SQL-frågor.
    • Vektorsökning: Välj schemat för indexet. På så sätt kan Genie Code köra frågor mot vektorsökningsindexet för att hitta relevanta dokument.
    • Genie Space: Välj Genie Space. Genie MCP anropar Genie som ett verktyg, så att du kan köra frågor mot Genie Space för att analysera data med naturligt språk.
    • Extern MCP-server: Välj den Unity Catalog-anslutning som ska användas som en extern MCP-server. Du måste logga in på anslutningen först innan den kan användas.
    • Anpassad MCP-server: Välj den Databricks-app som ska användas som en anpassad MCP-server. På så sätt kan du använda alla anpassade verktyg. Följande krav gäller:
      • Appen måste distribueras på samma arbetsyta som du försöker ansluta till den från.
      • MCP-servern måste nås på https://<server-url>/mcp.
      • Appen måste vara tillståndslös. Ange mcp_app = mcp_server.http_app(stateless_http=True)till exempel .
      • Om du stöter på CORS-fel kan du behöva lägga till din arbetsyte-URL i appens lista över tillåtna ursprung. Ange app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])till exempel .
  4. Klicka på Spara.

När de har lagts till är MCP-servrar omedelbart tillgängliga för Genie Code. Du kan börja använda dem i agentläge utan att ändra dina uppmaningar eller instruktioner. Genie Code drar automatiskt nytta av dessa servrar när det är relevant.

För närvarande är MCP-åtkomst begränsad till 20 verktyg på alla servrar. Du kan välja vilka verktyg och servrar som ska aktiveras eller inaktiveras i inställningarna för Genie Code.