メインコンテンツまでスキップ

ツールとスキルを追加

Unity Gateway CLI(ug)を使用して、MCPサーバーと共有スキルをコーディングエージェントに追加します。MCPツールはデータとサービスへのアクセスを提供します。スキルはチームのタスクとワークフローに関する手順を提供します。

手動でセットアップするには、サポートされているコーディングエージェントの下にあるコーディングエージェントのガイドを参照してください。

始める前に

ug をインストールして構成します。基盤となるデータやサービスなど、使用するMCPサーバーまたはスキルへのアクセス権が必要です。

スキルdownloadを含め、インストールおよび設定済みの MCP 対応エージェントが必要です。MCP 接続は、MCP をサポートするように設定されたすべてのアージェントに適用されます。

スキルを使用するには、管理者がベータ機能を有効にする必要があります。See Govern skills.

設定を変更した後は、通常のugコマンドでエージェントを再起動してください。

MCPツールを追加

MCPサーバーを選択する

Bash
ug mcp add

プロンプトが表示された場合はサインインし、ピッカーでサーバーを選択します。入力してフィルターし、 Space キーを押して選択し、 Enter キーを押して確定します。

既存の接続は保持されます。タスクを記述して、ツールを使用するようにエージェントに指示します。

名前でMCPサーバーを選択する

MCPサーバーを名前で追加するには、完全なUnity Catalog名(<catalog>.<schema>.<server-name>)を使用します:

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

スキーマ内のすべてのMCPサーバーを追加するには:

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

その他の Databricks MCP サーバーを追加する

MCPサーバーピッカー外のリソースについては、--namesを指定したセレクターを使用します:

リソース

セレクター

スキーマ内のベクトル検索インデックス

vector-search:<catalog>.<schema>

スキーマ内の Unity Catalog 関数

uc-functions:<catalog>.<schema>

外部MCPサーバーの接続

external:<connection>

Genieスペース

genie-space:<space-id>

MCP server hosted in a Databricks app

app:<app-name>

リソース

セレクター

スキーマ内のベクトル検索インデックス

vector-search:<catalog>.<schema>

スキーマ内の Unity Catalog 関数

uc-functions:<catalog>.<schema>

外部MCPサーバーの接続

external:<connection>

Genieスペース

genie-space:<space-id>

MCP server hosted in a Databricks app

app:<app-name>

たとえば、Genie spaceを接続します:

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

<space-id>をGenie space IDに置き換えます。

接続を確認して削除

ugによって構成されたMCPサーバーの一覧を表示します:

Bash
ug mcp list

追加した接続を削除するには:

Bash
ug mcp remove

削除するサーバーを選択し、 Enter キーを押します。選択した各接続は、追加したすべての日付から削除されます。MCPサーバー自体はワークスペース内で引き続き利用可能です。

スキルを追加

スキルは次の 2 つの方法で使用できます。

  • download skills: エージェントは、ネイティブスキルワークフローを通じてローカルスキルファイルを検出し、使用します。
  • MCPを通じたスキルの使用: エージェントは、管理すべきローカルファイルなしで、スキルを使用する際に公開されたスキルレジストリから指示を取得します。

download skills

Bash
ug skills add

ピッカーでdownloadするスキルを選択します。

ug SKILL.md およびサポートファイルを含む、完了した各スキル フォルダを ~/.claude/skills/~/.agents/skills/ の両方にダウンロードします。エージェントに名前でスキルを使用するように依頼します。スキルコマンドについては、エージェントガイドを参照してください。

特定のスキルをdownloadするには、完全なUnity Catalog名を使用します。

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

スキーマ内のすべてのスキルをdownloadするには:

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

両方のオプションでコンマ区切りの名前を受け入れます。コマンドでは、両方ではなく --names または --location を使用してください。同じコマンドを再実行して更新を取得します。既存のスキルフォルダーを上書きする前に ug がプロンプトを表示します。

downloadすると、MCPを介してすでに接続されているスキーマを変更することなく、スキル レジストリの検出ツールやロードツールも有効になります。

プロジェクトにスキルをdownloadする

プロジェクトディレクトリから、次のように実行します。

Bash
ug skills add --path "$PWD"

スキルを選択します。ugは、プロジェクトの.claude/skills/および.agents/skills/ディレクトリの下にそれらを書き込みます。--path--namesまたは--locationと組み合わせることもできます。

--path 既存の絶対プロジェクトディレクトリを指定する必要があります。エージェント設定用の個別のホームディレクトリを使用するug geminiでプロジェクトのdownloadを使用します。

MCPを通じて公開済みスキルに接続する

MCPを介してエージェントが使用できるスキルのスキーマを選択するには:

Bash
ug skills add --via mcp

ピッカーでスキーマを選択します。スキーマを直接指定するには:

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

ug これらのスキーマをスキルレジストリ接続に追加し、すでに接続されているスキーマはそのまま維持します。--via mcp--pathまたは--namesと組み合わせて使用することはできません。

エージェントで、公開されたスキルを使用するように指示します。

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

エージェントにスキーマ内のスキルをリストアップするよう依頼することもできます。MCP を介して読み込まれたスキルは、エージェントのネイティブスキルメニューに表示されない場合があります。

スキルのリスト

Bash
ug skills list

スキルを削除する

To select download skills for removal:

Bash
ug skills remove

現在のプロジェクトから特定のスキルを削除するには:

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

スキーマからすべてのdownloadを削除するには、--namesの代わりに--location "<catalog>.<schema>"を使用します。--pathがない場合、削除にはユーザーディレクトリとプロジェクトディレクトリにわたってugによってdownloadされたコピーが含まれます。公開されたスキルはUnity Catalogに残ります。

ライブ MCP 接続からスキーマを削除するには:

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

--location を省略して、ピッカーでスキーマを選択します。スキーマを削除しても、downloadファイルやレジストリのディスカバリーツールはそのまま残ります。

次のステップ