MCP-authenticatie en netwerken

Voor stapsgewijze opzet gebruik je de gids van je codeeragent of de Python quickstart. Gebruik deze pagina om de vereisten voor gedeelde authenticatie en netwerktoegang te controleren.

Sign in to Azure Databricks

Gebruik je Azure Databricks-gebruikersaccount voor interactief werk, of een service principal voor een agent die onbewaakt draait. Volg de opzet voor je makelaar:

Gebruiksituatie	Aanbevolen installatie
Coderingsagenten	Gebruik de Unity Gateway CLI. Het verzorgt het inloggen en ververst de inloggegevens.
Lokale Python-ontwikkeling	Gebruik Databricks CLI-aanmelding.
Andere interactieve MCP-clients	Configureer OAuth met een geregistreerde client-ID.
Onbeheerde agenten	Gebruik een service principal met OAuth machine-to-machine (M2M). Voor agenten op Databricks Apps, zie Agentauthenticatie.

De gebruiker of dienstprincipal heeft toestemming nodig om de MCP aan te roepen. Als een tool je vraagt in te loggen bij een externe provider, volg dan de setup van externe diensten.

Voor lokaal testen accepteren door Databricks geleverde en geregistreerde MCP's, en legacy workspace-endpoints, een persoonlijk toegangstoken in de Authorization: Bearer <token> header. Houd tokens buiten de bronbeheer. Servers die op Databricks Apps worden gehost, vereisen OAuth en accepteren geen persoonlijke toegangstokens.

Configureer een aangepaste OAuth-client

Gebruik dit wanneer je klant een eigen OAuth-app nodig heeft. De Claude Code- en Codex-gidsen bevatten hun client-specifieke instellingen.

1. Haal de exacte redirect-URL van je client op, inclusief de host, port en pad.

2. Laat een accountbeheerder Instellingen openen in de accountconsole, selecteer App-verbindingen en klik op Verbinding toevoegen.

3. Voer een naam in, voeg de redirect-URL toe en selecteer de scopes van je server:

   Server	URL	Scope
   Aangeboden of geregistreerde MCP	https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>	ai-gateway
   Server op Databricks Apps	https://<app-url>/mcp	Neem de gebruikersautorisatiescopes van de app op. Je moet ook KAN GEBRUIKEN in de app.
   Workspace MCP-eindpunt (legacy)	De URL op de serverpagina	Gebruik de scopes die voor die server zijn vermeld.

4. Kies of je een clientgeheim genereert:

   • Desktop of CLI-client (publieke client): Clear Genereer een clientgeheim.
   • Server-side client die geheimen veilig opslaat (vertrouwelijke client): Laat Genereer een clientgeheim geselecteerd.

5. Sla de verbinding op en kopieer de Client-ID. Als je een client secret hebt gegenereerd, kopieer dan die waarde ook.

6. Voer de server-URL en clientgegevens in je MCP-client in. Gebruik Streamable HTTP, vraag de scope van de server en offline_access verversingstokens op, en log in.

Zie Create an OAuth app voor UI- en CLI-opties. Wijzigingen kunnen tot 30 minuten duren voordat ze effect hebben. Azure Databricks MCP-endpoints ondersteunen geen dynamische clientregistratie, dus gebruik een client die een vooraf geconfigureerde client ID accepteert.

Netwerktoegang

Controleer de toegang van de client naar de werkruimte en van de werkruimte naar de externe server.

Client naar werkruimte

MCP-verzoeken moeten worden toegestaan door de inkomende netwerkcontroles van je werkruimte. Als IP-toegangslijsten voor de werkruimte zijn ingeschakeld, vraag dan een beheerder om de publieke IP-adressen waar de verzoeken vandaan komen toe te staan:

Waar de MCP-client draait	Adressen die toegestaan moeten worden
Op je computer, zoals Claude Code, Codex CLI of Cursor	Het publieke uitgaande IP van je netwerk. Als het verkeer via een bedrijfs-VPN of proxy gaat, gebruik dan het uitgaande IP van dat netwerk. Je netwerkbeheerder kan het leveren.
In een gehoste dienst, zoals een Claude connector of ChatGPT	De door de provider gepubliceerde uitgaande IP-bereiken. Bekijk de uitgaande IP's van Claude en de uitgaande IP's van ChatGPT.

Voor gehoste clients komt de inloggegevens van de browser vanuit je netwerk, terwijl MCP-oproepen van de servers van de provider komen. Beide moeten worden toegestaan. Bijvoorbeeld, succesvol inloggen vanaf je bedrijfs-VPN betekent niet dat ChatGPT je MCP kan bereiken.

Als uw organisatie ook contextgebaseerde ingangscontroles gebruikt, moeten de verzoeken ook aan die beleidsregels voldoen. IP-toegangslijsten van accounts zijn van toepassing op accountconsole- en account-API-toegang, zoals een beheerder die een OAuth-app aanmaakt.

Werkruimte naar externe MCP-server

Aanroepen naar externe MCP-providers via Unity Gateway gebruiken het serverless computeplan van de werkruimte. Dit geldt voor geregistreerde externe servers en door Databricks geleverde MCP's voor externe diensten.

Als je serverloze netwerkbeleidBeperkte toegang gebruikt, voeg dan de volledig gekwalificeerde domeinnaam (FQDN) van de server toe aan Toegestane domeinen. Begin met de host op de Unity Catalog-verbinding van de MCP. Controleer system.access.outbound_network op extra geblokkeerde bestemmingen. Zie Beheren van netwerkbeleid en uitgaande netwerklogboeken.

• Een Unity Catalog-verbinding staat zijn bestemming niet automatisch toe.
• Volledige toegang is standaard de modus in het serverless netwerkbeleid om uitgaande internetverbindingen toe te staan. Expliciet geblokkeerde domeinen blijven geweigerd. Bijvoorbeeld, een beleid dat blokkeert mcp.example.com voorkomt dat je aanroepen naar die MCP-server oproepen krijgt. Vraag een beheerder om de geblokkeerde bestemmingen van het beleid te bekijken.
• Om MCP-verkeer in de proefmodus te testen, selecteer je Alle producten. De SQL- en AI-modelserviceopties van Databricks brengen MCP-verkeer niet in de proefloop.

Privéconnectiviteit

Om een MCP-server in je cloudnetwerk te bereiken, kies je hoe Azure Databricks serverless compute ermee verbindt:

• Privé-eindpunt: Gebruik Private Link om verkeer op een privéverbinding te houden. Een accountbeheerder voegt een privé-endpointregel toe voor het domein van de server aan een netwerkconnectiviteitsconfiguratie (NCC) die aan je werkruimte is gekoppeld. Je cloudbeheerder keurt de endpointverbinding goed. Zie Privé-connectiviteit configureren.
• Publiek endpoint met een firewall: Configureer de firewall van de server om Azure Databricks serverless uitgaande IP's voor de cloud en regio van je werkruimte toe te staan. Deze IP's worden gedeeld tussen Azure Databricks-klanten, dus houd authenticatie ingeschakeld op de server. Zie Find the outbound IP's en configureer je firewall.

Domeinen die aan privé-endpointregels worden toegevoegd, zijn automatisch toegestaan door netwerkbeleid, dus je hoeft ze niet apart toe te voegen aan Toegestane domeinen. Voor een openbaar eindpunt volg je de hierboven opgestelde netwerkbeleidsopstelling.