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.
Antes de começar
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
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 do Vector Search em um esquema |
|
Funções do Unity Catalog em um esquema |
|
Conexão de servidor MCP externo |
|
Genie space |
|
Servidor MCP hospedado em um aplicativo do Databricks |
|
For example, connect a Genie space:
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.
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.