Ansluta Genie Code till MCP-servrar

Genie Code ansluter till externa verktyg, dokument och data via Model Context Protocol (MCP)-servrar och inbyggda kopplingar för Google Drive, Gmail, Google Kalender, Microsoft 365, Atlassian, Glean, Slack och GitHub. Använd de interna anslutningsprogrammen för vanliga SaaS-källor eller lägg till dina egna externa eller anpassade MCP-servrar från arbetsytan. Du väljer vilka verktyg som ska aktiveras i inställningarna för Genie Code.

Vad är MCP?

MCP är en open-source standard som ansluter agenter till verktyg, resurser, uppmaningar och annan kontextuell 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 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 AI Search-index, 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 en Genie-agent 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.

För att lära dig mer om MCP-servrar i Databricks och hur du skapar dina egna, se MCPs.

Använd inbyggda anslutningar för datakällor från tredje part

Genie Code tillhandahåller inbyggda kopplingar för vanliga företagsdatakällor:

  • Google Drive: Sök och skapa Google Docs, Sheets och Slides; redigera de dokument som den skapat.
  • Gmail: Sök, läs och skriv e-post.
  • Google Kalender: Sök och skapa kalenderhändelser.
  • Microsoft 365: Sök i SharePoint, Teams, Outlook och Kalender; utkast till Outlook-e-post.
  • Atlassian: Sök och uppdatera Jira och Confluence.
  • Glean (Beta): Sök i din organisations anslutna appar med hjälp av Glean.
  • Slack: Sök i Slack-meddelanden och kanaler, och skicka meddelanden.
  • GitHub: Sök och uppdatera repositorier, problem och pull requests.

Genom att koppla upp sig mot dessa datakällor kan Genie Code söka i dina dokument och vidta åtgärder i anslutna verktyg när du besvarar frågor. Varje användare autentiserar individuellt och OAuth-token delas inte mellan användare.

Dessa anslutningar använder MCP-kopplingar som tillhandahålls av Databricks, så det finns ingen server att hosta och ingen OAuth-app att registrera sig på. Azure Databricks styr varje anslutning via Unity Catalog och Unity Gateway. Gatewayen auktoriserar varje verktygsanrop mot dina Unity-katalogbehörigheter, tillämpar inbyggda policyer och godkännandekrav samt registrerar användnings- och revisionsloggar i systemtabeller. Se externa MCP-servrar.

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. Metastoreadministratörer och anslutningsägare kan hantera eller återkalla användarbehörigheter på anslutningen. Se Ge och återkalla behörigheter för anslutningar.

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.

Schemalagda uppgifter och autentisering

  • Genie Code varnar dig inte när en anslutnings autentisering går ut. Du kanske bara får veta när ett verktygsanrop misslyckas eller när du öppnar anslutningslistan. Autentisera igen för att lösa.
  • Att ändra en anslutnings behörigheter kräver att varje användare autentiserar sig igen. Schemalagda uppgifter som använder anslutningen misslyckas tills användaren autentiserar sig igen.

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 25 MB.
  • Endast interna Google Workspace-filer (Docs, Sheets, Slides) stöds. PDF-filer, bilder och andra binära format stöds inte.
  • Genie Code kan skapa Google Docs, Sheets och Slides och redigera Google Docs som den har skapat via anslutningen. Den kan inte redigera dokument som skapats utanför kontakten, eller redigera befintliga Sheets eller Slides.
  • Att läsa ett mycket stort dokument kan gå långsamt.

Anmärkning

Användning och överföring av rådata eller härledda användardata som tas emot från Google Workspace-API:er följer Google API-tjänsternas användardataprincip, inklusive kraven på begränsad användning.

Gmail-begränsningar

  • Genie Code kan söka, läsa och skriva e-post, men den kan inte skicka e-post eller redigera befintliga meddelanden.
  • Genie Code kan inte lägga till Drive-filer som inbyggda Gmail-bilagor. Som en lösning, inkludera länkar till filerna i e-postens brödtext.

Microsoft 365:s begränsningar

  • Innehåller SharePoint, Teams, Outlook och Kalender.
  • Genie Code kan skriva ett utkast till Outlook-mejl men kan inte skicka det.
  • Maximal filstorlek är 25 MB för SharePoint-filer.
  • Stödda SharePoint filtyper inkluderar 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.

Glean (Beta) begränsningar

  • Glean är endast sökbar. Den kan inte läsa ett dokument från en direktlänk.
  • En metastore-administratör måste först konfigurera Glean-tenant-ID:t innan icke-administratörsanvändare kan använda anslutningen. Administratören kan ange klientorganisations-ID:t när den först ansluter till Glean.
  • För att ansluta till en specifik Glean MCP-server kan en metastore-administratör valfritt ställa in MCP-servervägen (till exempel /mcp/eng) vid anslutningen. Låt detta fält vara tomt för att använda standardsökvägen (/mcp/default). Icke-administratörsanvändare kan inte specificera eller ändra Glean MCP-serverns sökväg.

Begränsningar i Slack

  • Genie Code kan inte redigera eller ta bort ett meddelande efter att ha skickat det.

GitHub begränsningar

  • Skrivningar är begränsade till filinnehåll, problem och pull requests.
  • Som standard kan Databricks GitHub MCP-anslutningsprogram endast komma åt offentliga lagringsplatser. Om du vill ge anslutningsappen läsbehörighet till dina privata företagslagringsplatser måste en GitHub organisationsadministratör slutföra ytterligare konfiguration. Se GitHub privata repositorier.
  • GitHub Enterprise Server (den lokalt installerade versionen av GitHub) 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 fönstret 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:
    • UC MCP-tjänst: Välj en tjänst från Välj en UC MCP-tjänst. Använd en MCP-tjänst för en extern server registrerad i Unity Catalog. Se 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.
    • AI-sökning: Välj schemat för indexet. På så sätt kan Genie Code köra frågor mot AI Search-indexet för att hitta relevanta dokument.
    • Genie-agent: Välj Genie-agenten. Genie MCP anropar Genie som ett verktyg, så att du kan fråga Genie Agent för att analysera data med naturligt språk.
    • 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 utan att ändra dina uppmaningar eller instruktioner. Genie Code använder automatiskt dessa servrar när det är relevant.

Du kan välja vilka verktyg och servrar som ska aktiveras eller inaktiveras i inställningarna för Genie Code.

För efterlevnadsriktlinjer för anslutna applikationer, se Krav för externa provider.

Limitations

  • Uppdaterades senast