ツールとスキルを追加
Unity Gateway CLI(ug)を使用して、MCPサーバーと共有スキルをコーディングエージェントに追加します。MCPツールはデータとサービスへのアクセスを提供します。スキルはチームのタスクとワークフローに関する手順を提供します。
手動でセットアップするには、サポートされているコーディングエージェントの下にあるコーディングエージェントのガイドを参照してください。
始める前に
ug をインストールして構成します。基盤となるデータやサービスなど、使用するMCPサーバーまたはスキルへのアクセス権が必要です。
スキルdownloadを含め、インストールおよび設定済みの MCP 対応エージェントが必要です。MCP 接続は、MCP をサポートするように設定されたすべてのアージェントに適用されます。
スキルを使用するには、管理者がベータ機能を有効にする必要があります。See Govern skills.
設定を変更した後は、通常のugコマンドでエージェントを再起動してください。
MCPツールを追加
MCPサーバーを選択する
ug mcp add
プロンプトが表示された場合はサインインし、ピッカーでサーバーを選択します。入力してフィルターし、 Space キーを押して選択し、 Enter キーを押して確定します。
既存の接続は保持されます。タスクを記述して、ツールを使用するようにエージェントに指示します。
名前でMCPサーバーを選択する
MCPサーバーを名前で追加するには、完全なUnity Catalog名(<catalog>.<schema>.<server-name>)を使用します:
ug mcp add --names system.ai.github,system.ai.slack
スキーマ内のすべてのMCPサーバーを追加するには:
ug mcp add --location "<catalog>.<schema>"
その他の Databricks MCP サーバーを追加する
MCPサーバーピッカー外のリソースについては、--namesを指定したセレクターを使用します:
リソース | セレクター |
|---|---|
スキーマ内のベクトル検索インデックス |
|
スキーマ内の Unity Catalog 関数 |
|
外部MCPサーバーの接続 |
|
Genieスペース |
|
MCP server hosted in a Databricks app |
|
たとえば、Genie spaceを接続します:
ug mcp add --names "genie-space:<space-id>"
<space-id>をGenie space IDに置き換えます。
接続を確認して削除
ugによって構成されたMCPサーバーの一覧を表示します:
ug mcp list
追加した接続を削除するには:
ug mcp remove
削除するサーバーを選択し、 Enter キーを押します。選択した各接続は、追加したすべての日付から削除されます。MCPサーバー自体はワークスペース内で引き続き利用可能です。
スキルを追加
スキルは次の 2 つの方法で使用できます。
- download skills: エージェントは、ネイティブスキルワークフローを通じてローカルスキルファイルを検出し、使用します。
- MCPを通じたスキルの使用: エージェントは、管理すべきローカルファイルなしで、スキルを使用する際に公開されたスキルレジストリから指示を取得します。
download skills
ug skills add
ピッカーでdownloadするスキルを選択します。
ug SKILL.md およびサポートファイルを含む、完了した各スキル フォルダを ~/.claude/skills/ と ~/.agents/skills/ の両方にダウンロードします。エージェントに名前でスキルを使用するように依頼します。スキルコマンドについては、エージェントガイドを参照してください。
特定のスキルをdownloadするには、完全なUnity Catalog名を使用します。
ug skills add --names "<catalog>.<schema>.<skill-name>"
スキーマ内のすべてのスキルをdownloadするには:
ug skills add --location "<catalog>.<schema>"
両方のオプションでコンマ区切りの名前を受け入れます。コマンドでは、両方ではなく --names または --location を使用してください。同じコマンドを再実行して更新を取得します。既存のスキルフォルダーを上書きする前に ug がプロンプトを表示します。
downloadすると、MCPを介してすでに接続されているスキーマを変更することなく、スキル レジストリの検出ツールやロードツールも有効になります。
プロジェクトにスキルをdownloadする
プロジェクトディレクトリから、次のように実行します。
ug skills add --path "$PWD"
スキルを選択します。ugは、プロジェクトの.claude/skills/および.agents/skills/ディレクトリの下にそれらを書き込みます。--pathを--namesまたは--locationと組み合わせることもできます。
--path 既存の絶対プロジェクトディレクトリを指定する必要があります。エージェント設定用の個別のホームディレクトリを使用するug geminiでプロジェクトのdownloadを使用します。
MCPを通じて公開済みスキルに接続する
MCPを介してエージェントが使用できるスキルのスキーマを選択するには:
ug skills add --via mcp
ピッカーでスキーマを選択します。スキーマを直接指定するには:
ug skills add --location "<catalog>.<schema>" --via mcp
ug これらのスキーマをスキルレジストリ接続に追加し、すでに接続されているスキーマはそのまま維持します。--via mcpを--pathまたは--namesと組み合わせて使用することはできません。
エージェントで、公開されたスキルを使用するように指示します。
Use <catalog>.<schema>.<skill-name> to review this query.
エージェントにスキーマ内のスキルをリストアップするよう依頼することもできます。MCP を介して読み込まれたスキルは、エージェントのネイティブスキルメニューに表示されない場合があります。
スキルのリスト
ug skills list
スキルを削除する
To select download skills for removal:
ug skills remove
現在のプロジェクトから特定のスキルを削除するには:
ug skills remove --names "<catalog>.<schema>.<skill-name>" --path "$PWD"
スキーマからすべてのdownloadを削除するには、--namesの代わりに--location "<catalog>.<schema>"を使用します。--pathがない場合、削除にはユーザーディレクトリとプロジェクトディレクトリにわたってugによってdownloadされたコピーが含まれます。公開されたスキルはUnity Catalogに残ります。
ライブ MCP 接続からスキーマを削除するには:
ug skills remove --location "<catalog>.<schema>" --via mcp
--location を省略して、ピッカーでスキーマを選択します。スキーマを削除しても、downloadファイルやレジストリのディスカバリーツールはそのまま残ります。