Aggiungere strumenti e competenze

Usa la CLI Unity Gateway (ug) per aggiungere server MCP e competenze condivise al tuo agente di programmazione. Gli strumenti MCP forniscono accesso a dati e servizi; le competenze forniscono istruzioni per i compiti e i flussi di lavoro del tuo team.

Per la configurazione manuale, consulta la guida del tuo agente sotto Agenti di codifica e di lavoro supportati.

Prerequisites

• Unity Gateway CLI (ug), installata e configurata. Consulta Installa e configura ug.
• Un agente installato e configurato con MCP, incluso per il download delle abilità. Le connessioni MCP si applicano a tutti i tuoi agenti configurati che supportano MCP.
• Accesso ai server MCP o alle competenze che desideri utilizzare, inclusi eventuali dati e servizi di base.
• Per utilizzare le competenze, il tuo amministratore deve abilitare la funzionalità beta. Vedi Abilità di Governo.

Dopo aver modificato la configurazione, riavvia l'agente con il consueto comando ug.

Aggiungi strumenti MCP

system.ai.dbsql, system.ai.sandbox, e system.ai.web_search sono in Beta. Per utilizzarli, un amministratore dell'account deve abilitare Enhanced Unity Gateway in anteprima dalla pagina Anteprime della console dell'account. Unity Gateway stesso è generalmente disponibile. Vedi Gestisci le anteprime dell'account.

Scegli i server MCP

ug mcp add

Accedi se ti viene richiesto, poi scegli i server nel selezionatore. Digita per filtrare, premi Spazio per selezionare e Invio per confermare.

Le connessioni esistenti vengono mantenute. Nel tuo agente, chiedigli di usare uno strumento descrivendo il compito.

Scegli i server MCP per nome

Per aggiungere server MCP per nome, usa i nomi completi del loro Catalogo Unity (<catalog>.<schema>.<server-name>):

ug mcp add --names system.ai.github,system.ai.slack

Per aggiungere ogni server MCP in uno schema:

ug mcp add --location "<catalog>.<schema>"

Add other Azure Databricks MCP servers

Per risorse al di fuori del selezionatore di server MCP, usa un selettore con --names:

Le funzioni AI Search, Unity Catalog e Genie Agent si collegano agli endpoint MCP dello spazio di lavoro governati dai permessi delle risorse. Le chiamate bypassano il tracciamento di Unity Gateway, i grant MCP, le politiche e i guardrail. Un amministratore di workspace deve abilitare i server MCP gestiti.

Usa la ricerca AI e i selettori di funzioni quando il tuo agente di codifica ha bisogno degli strumenti MCP per quelle risorse. Questi endpoint e il Genie Agent MCP sono in Anteprima Pubblica. Per le query SQL, usa system.ai.dbsql tramite Unity Gateway.

Ad esempio, collega un Genie Agent esistente:

ug mcp add --names "genie-space:<space-id>"

Sostituisci <space-id> con l'ID dello spazio Genie.

Controlla e rimuovi le connessioni

Elencare i server MCP configurati da:ug

ug mcp list

Per rimuovere le connessioni hai aggiunto:

ug mcp remove

Seleziona i server da rimuovere e premi Invio. Ogni connessione selezionata viene rimossa da tutti gli agenti dove l'hai aggiunta. Il server MCP stesso rimane disponibile nello spazio di lavoro.

Altri clienti MCP

Per system.ai.dbsql, prima abilita la beta di Unity Gateway.

Per Claude Code, Codex, GitHub Copilot o Cursor, usa la guida del tuo agente. Per Claude sia sul web che sul desktop, segui le istruzioni di Claude connectors.

Per la configurazione manuale di OAuth, fai registrare da un amministratore dell'account un'applicazione OAuth personalizzata con gli URL di reindirizzamento esatti del client e lo ai-gateway scope. I client desktop e CLI utilizzano un client pubblico senza un client secret. I client lato server che possono memorizzare un segreto in modo sicuro possono utilizzare un client confidenziale. Gli endpoint MCP di Azure Databricks non supportano la registrazione dinamica del client, quindi il client deve accettare un ID client preconfigurato. Usa HTTP streamabile e richiedi i token di refresh offline_access.

Per i client qui sotto, scegli un MCP sotto Unity Gateway > MCPs e usa questo URL:

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>

Sostituisci il nome host, l'ID dello spazio di lavoro e il nome MCP. Ad esempio, usa system.ai.genie_one_mcp per Genie One o system.ai.dbsql per Databricks SQL. Ti serve il permesso per chiamare l'MCP e, per gli MCP per utente, un accesso al provider.

ChatGPT

1. Attiva la modalità sviluppatore in ChatGPT. La disponibilità dipende dalla politica del tuo account e dello spazio di lavoro.

2. Segui le istruzioni collegate di ChatGPT per aggiungere una connessione MCP con il tuo URL MCP e scegli OAuth.

3. Per l'ID client OAuth, inserisci l'ID client predefinito di ChatGPT, https://chatgpt.com/oauth/client.json. Salva la connessione e completa l'accesso.

   Per usare invece la tua app OAuth, copia esattamente l'URL di reindirizzamento OAuth mostrato da ChatGPT. Fai creare un client Azure Databricks OAuth da un amministratore di account con quell'URL e l'ambitoai-gateway, poi inserisci il suo ID client e il segreto, se applicabile. Vedi gli URL di reindirizzamento OAuth di ChatGPT.

4. Seleziona la connessione MCP in una conversazione e chiedile di usare uno strumento di sola lettura.

Se la tua area di lavoro limita l'accesso in ingresso, aggiungi ChatGPT come piattaforma partner in un criterio di ingresso basato sul contesto. Azure Databricks mantiene aggiornati gli indirizzi IP di ChatGPT al posto tuo. Puoi anche aggiungere gli indirizzi IP di ChatGPT ai tuoi elenchi di accesso IP, ma OpenAI può modificare questi indirizzi, quindi devi predisporre una procedura automatizzata per mantenere aggiornati i tuoi elenchi. Vedi indirizzi IP di uscita di OpenAI.

ChatGPT si collega al tuo spazio di lavoro tramite Internet pubblica. Se il tuo workspace usa collegamento privato in entrata con accesso pubblico disattivato, ChatGPT non può connettersi.

Windsurf

Usa la configurazione manuale OAuth per Cursor, salvando il JSON in ~/.codeium/windsurf/mcp_config.json. Questo utilizza mcp-remote con il tuo ID client OAuth registrato.

Riavvia Windsurf, completa l'accesso al browser e chiedi all'agente di chiamare uno strumento di sola lettura. Vedi configurazione Windsurf MCP.

Replit

Per test locali con un token di accesso personale:

1. Nel tuo workspace Replit, clicca su Aggiungi server MCP e inserisci l'URL MCP.
2. Aggiungi l'intestazione Authorization personalizzata con valore Bearer <databricks-pat>.
3. Salva e chiedi all'agente di chiamare uno strumento di sola lettura.

Tieni il token fuori dal controllo versione. Per le opzioni di autenticazione attuali, consulta la documentazione Replit MCP.

Verifica che il client effettui una chiamata allo strumento e restituisca il risultato. Per system.ai.dbsql, prova SELECT 1 AS result. Se la connessione fallisce, vedi autenticazione MCP.

Aggiungere competenze

Puoi usare le abilità in due modi:

• Scarica le skill: Il tuo agente individua e utilizza file di skill locali tramite il flusso di lavoro nativo per le skill.
• Usa le competenze tramite MCP: Il tuo agente recupera le istruzioni dal registro delle abilità pubblicato quando utilizza una competenza, senza gestire file locali.

Scarica le competenze

ug skills add

Seleziona le abilità da scaricare nel selettore.

ug scarica la cartella completa di ogni skill, inclusi SKILL.md e i file di supporto, sia in ~/.claude/skills/ che in ~/.agents/skills/ Chiedi al tuo agente di utilizzare l'abilità per nome. Consulta la guida del tuo agente per i comandi delle abilità.

Per scaricare competenze specifiche, usa i nomi completi del loro Catalogo Unity:

ug skills add --names "<catalog>.<schema>.<skill-name>"

Per scaricare tutte le abilità in uno schema:

ug skills add --location "<catalog>.<schema>"

Entrambe le opzioni accettano nomi separati da virgole. Usa --names o --location in un comando, non entrambi. Riesegui lo stesso comando per scaricare gli aggiornamenti; ug chiede conferma prima di sovrascrivere le cartelle delle abilità esistenti.

Il download consente anche l'individuazione e il caricamento tramite il registro delle skill, senza modificare gli schemi già collegati tramite MCP.

Scarica le competenze in un progetto

Dalla directory del progetto, esegui:

ug skills add --path "$PWD"

Scegli le tue competenze. ug li scrive nelle directory .claude/skills/ e .agents/skills/ del progetto. Puoi anche combinare --path con --names o --location.

--path deve indicare una directory di progetto esistente e assoluta. Usa i download dei progetti con ug gemini, che utilizza una cartella home separata per le impostazioni dell'agente.

Connettiti alle competenze pubblicate tramite MCP

Per scegliere gli schemi le cui competenze il tuo agente può utilizzare tramite MCP:

ug skills add --via mcp

Seleziona gli schemi nel selettore. Per specificare direttamente uno schema:

ug skills add --location "<catalog>.<schema>" --via mcp

ug aggiunge questi schemi alla connessione del registro delle abilità, mantenendo quelli già connessi. Non puoi combinare --via mcp con --path o --names.

Per client MCP personalizzati e dettagli sulle interfacce supportate, vedi Accedere alle competenze tramite MCP.

Nel tuo agente, chiedigli di usare una competenza pubblicata:

Use <catalog>.<schema>.<skill-name> to review this query.

Puoi anche chiedere all'agente di elencare le competenze in uno schema. Le abilità caricate tramite MCP potrebbero non apparire nel menu delle abilità nativo dell'agente.

Elencare le competenze

ug skills list

Rimuovere competenze

Per selezionare le abilità scaricate da rimuovere:

ug skills remove

Per rimuovere una particolare abilità dal tuo progetto attuale:

ug skills remove --names "<catalog>.<schema>.<skill-name>" --path "$PWD"

Usa --location "<catalog>.<schema>" invece di --names rimuovere tutti i download da uno schema. Senza --path, la rimozione include le copie scaricate da ug nelle directory utente e di progetto. Le competenze pubblicate rimangono nel Catalogo Unity.

Per rimuovere uno schema dalla connessione MCP attiva:

ug skills remove --location "<catalog>.<schema>" --via mcp

Ometti --location per scegliere gli schemi tramite un selettore. La rimozione di uno schema mantiene disponibili i file scaricati e l'individuazione del registro.

Passaggi successivi

• Riferimento CLI di ug
• Programmazione supportata e agenti di lavoro