Adicionar ferramentas e habilidades
Use a CLI do Unity Gateway (ug) para adicionar servidores MCP e habilidades
compartilhadas ao seu agente de codificação. As ferramentas de MCP fornecem acesso a dados e serviços; as habilidades fornecem instruções para as tarefas e os fluxos de trabalho da sua equipe.
Para a configuração manual, consulte o guia do seu agente de programação em Agentes de programação suportados.
Pré-requisitos
Instale e configure ug. Você precisa de acesso aos servidores ou habilidades MCP que deseja usar, incluindo quaisquer dados e serviços subjacentes.
Você precisa de um agente compatível com MCP instalado e configurado, inclusive para downloads de habilidades. As conexões MCP se aplicam a todos os seus agentes configurados que oferecem suporte a MCP.
Para habilidades, seu administrador deve habilitar o recurso beta. Consulte Governar habilidades.
Após alterar sua configuração, reinicie seu agente com o comando ug usual.
Adicionar ferramentas MCP
Para usar system.ai.dbsql, system.ai.sandbox ou system.ai.web_search, o administrador da account deve habilitar a versão beta do Unity Gateway na página Previews do console da account. Consulte Gerenciar prévias da account.
Escolher servidores MCP
ug mcp add
Faça login se for solicitado e escolha os servidores no seletor. Digite para filtrar, pressione Space para selecionar e Enter para confirmar.
As conexões existentes são mantidas. No seu agente, peça para ele usar uma ferramenta descrevendo a tarefa.
Escolha servidores MCP pelo nome
Para adicionar servidores MCP pelo nome, use os nomes completos do Unity Catalog (<catalog>.<schema>.<server-name>):
ug mcp add --names system.ai.github,system.ai.slack
Para adicionar todos os servidores MCP em um esquema:
ug mcp add --location "<catalog>.<schema>"
Adicionar outros servidores MCP do Databricks
Para recursos fora do seletor de servidor MCP, use um seletor com --names:
Recursos | Seletor |
|---|---|
Índices de Pesquisa de AI em um esquema (legado) |
|
Funções do Unity Catalog em um esquema (legado) |
|
Genie Agent (legado) |
|
Servidor MCP hospedado em um aplicativo do Databricks |
|
A Pesquisa de AI, as funções do Unity Catalog e os seletores do Genie Agent se conectam a Endpoints MCP de Workspace legados. Para novas integrações, consulte as abordagens recomendadas.
Por exemplo, conecte um Genie Agent existente:
ug mcp add --names "genie-space:<space-id>"
Substitua <space-id> pelo ID do Genie space.
Verificar e remover conexões
Liste os servidores MCP configurados por ug:
ug mcp list
Para remover as conexões que você adicionou:
ug mcp remove
Select the servers to remove and press Enter . Each selected connection is removed from all agents where you added it. The MCP server itself remains available in the workspace.
Outros clientes MCP
Para system.ai.dbsql, primeiro habilite o Unity Gateway beta.
Para o Claude Code, Codex ou Cursor, use o guia do seu agente. Para o Claude na web ou no desktop, siga os conectores do Claude.
Para os clientes abaixo, escolha um MCP em Unity Gateway > MCPs e use esta URL:
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>
Substitua o hostname e o nome do MCP. Por exemplo, use system.ai.genie_one_mcp para o Genie One ou system.ai.dbsql para o Databricks SQL. Você precisa de permissões de MCP e login do provedor.
- ChatGPT
- Windsurf
- Replit
- Ative o Developer Mode no ChatGPT. A disponibilidade depende da sua account e da política do workspace.
- Siga as instruções vinculadas do ChatGPT para adicionar uma conexão MCP com sua URL do MCP e escolha OAuth .
- Copie a URL de redirecionamento do OAuth exata exibida pelo ChatGPT. Peça a um administrador account para criar um cliente OAuth do Databricks com essa URL e o escopo
ai-gateway. Consulte as URLs de redirecionamento de OAuth do ChatGPT para obter detalhes sobre o retorno de chamada. - Enter the client ID and secret, if applicable, in ChatGPT. Save the connection and complete sign-in.
- Selecione a conexão MCP em uma conversa e peça para ela usar uma ferramenta somente de leitura.
Se as listas de acesso IP estiverem habilitadas, permita os IPs de saída do ChatGPT.
Use a configuração manual do OAuth para o Cursor, salvando o JSON em ~/.codeium/windsurf/mcp_config.json. Isso usa mcp-remote com a ID do cliente OAuth registrada.
Reinicie o Windsurf, conclua o login no navegador e peça para o agente chamar uma ferramenta somente de leitura. Consulte a configuração do MCP do Windsurf.
Para testes locais com um access token pessoal:
- No seu Workspace do Replit, clique em Add MCP Server e insira o URL do MCP.
- Adicione o cabeçalho personalizado
Authorizationcom o valorBearer <databricks-pat>. - Save and ask the agent to call a read-only tool.
Mantenha o tokens fora do controle de origem. Para obter as opções de autenticação atuais, consulte a documentação do Replit MCP.
Confirme que o cliente faz uma chamada de ferramenta e retorna seu resultado. Para system.ai.dbsql, tente SELECT 1 AS result. Se a conexão falhar, consulte MCP authentication and networking.
Adicionar habilidades
Você pode usar habilidades de duas maneiras:
- Download skills: Your agent discovers and uses local skill files through its native skill fluxo de trabalho.
- Use skills through MCP: Your agent retrieves instructions from the published skill registry when it uses a skill, without local files to gerenciar.
Fazer download de habilidades
ug skills add
Selecione as habilidades para fazer download no seletor.
ug faz o download de cada pasta de skill completa, incluindo SKILL.md e arquivos de suporte, tanto em ~/.claude/skills/ quanto em ~/.agents/skills/. Peça ao seu agente para usar a skill pelo nome. Consulte o guia do agente para ver os comandos de skill dele.
Para fazer download de skills específicas, use seus nomes completos do Unity Catalog:
ug skills add --names "<catalog>.<schema>.<skill-name>"
Para fazer download de todas as habilidades em um esquema:
ug skills add --location "<catalog>.<schema>"
Ambas as opções aceitam nomes separados por vírgulas. Use --names ou --location em um comando, não ambos. Execute o mesmo comando novamente para buscar atualizações; ug solicita confirmação antes de substituir pastas de habilidades existentes.
O download também habilita as ferramentas de descoberta e carregamento do registro de skills, sem alterar os esquemas já conectados por meio do MCP.
Fazer download de habilidades para um projeto
No diretório do seu projeto, execute:
ug skills add --path "$PWD"
Escolha suas habilidades. ug os grava nos diretórios .claude/skills/ e .agents/skills/ do projeto. Você também pode combinar --path com --names ou --location.
--path deve apontar para um diretório de projeto absoluto e existente. Use downloads de projetos com ug gemini, que usa um diretório inicial separado para as configurações do agente.
Conecte-se a habilidades publicadas por meio do MCP
Para escolher esquemas cujas habilidades seu agente possa usar por meio do MCP:
ug skills add --via mcp
Selecione os esquemas no seletor. Para especificar um esquema diretamente:
ug skills add --location "<catalog>.<schema>" --via mcp
ug adds these schemas to the skill registry connection, keeping any already connected. You cannot combine --via mcp with --path or --names.
No seu agente, peça para ele usar uma habilidade publicada:
Use <catalog>.<schema>.<skill-name> to review this query.
Você também pode pedir ao agente para listar as habilidades em um esquema. As habilidades carregadas por meio do MCP podem não aparecer no menu de habilidades nativo do agente.
Listar habilidades
ug skills list
Remover habilidades
To select download skills for removal:
ug skills remove
Para remover um recurso específico do seu projeto atual:
ug skills remove --names "<catalog>.<schema>.<skill-name>" --path "$PWD"
Use --location "<catalog>.<schema>" em vez de --names para remover todos os downloads de um esquema. Sem --path, a remoção inclui cópias de download por ug em seus diretórios de usuário e de projeto. As habilidades publicadas permanecem no Unity Catalog.
Para remover um esquema da conexão MCP ativa:
ug skills remove --location "<catalog>.<schema>" --via mcp
Omitir o --location para escolher esquemas em um seletor. A remoção de um esquema mantém os arquivos download e as ferramentas de descoberta do registro no lugar.