MCPツールの使用

Model Context Protocolを使用して外部ツールとサービスを接続

モデルコンテキストプロトコル(MCP)を使用すると、標準化されたプロトコルを使用して外部ツールやサービスを接続し、APIやサービスをワークフローに直接統合することができます。MCPを使用することで、エージェントやワークフローとシームレスに連携するカスタム統合機能を追加して、SteelEngineの機能を拡張できます。

MCPとは?

MCPは、AIアシスタントが外部データソースやツールに安全に接続できるようにするオープンスタンダードです。以下のような標準化された方法を提供します:

  • データベース、API、ファイルシステムへの接続
  • 外部サービスからのリアルタイムデータへのアクセス
  • カスタムツールやスクリプトの実行
  • 外部リソースへの安全で制御されたアクセスの維持

MCPサーバーの設定

MCPサーバーはエージェントが使用できるツールのコレクションを提供します。ワークスペース設定で構成してください:

  1. ワークスペース設定に移動します
  2. MCP サーバーセクションに移動します
  3. MCPサーバーを追加をクリックします
  4. サーバー設定の詳細を入力します
  5. 設定を保存します

エージェントブロックのツールバーから直接MCPサーバーを構成することもできます(クイックセットアップ)。

ツールの更新

サーバーの更新をクリックすると、最新のツールスキーマを取得し、それらのツールを使用しているエージェントブロックを新しいパラメータ定義で自動的に更新します。

エージェントでのMCPツールの使用

MCPサーバーが設定されると、そのツールがエージェントブロック内で利用可能になります:

エージェントブロックでのMCPツールの使用
  1. エージェントブロックを開く
  2. ツールセクションで、利用可能なMCPツールが表示されます
  3. エージェントに使用させたいツールを選択
  4. エージェントは実行中にこれらのツールにアクセスできるようになります

スタンドアロンMCPツールブロック

より細かい制御が必要な場合は、専用のMCPツールブロックを使用して特定のMCPツールを実行できます:

スタンドアロンMCPツールブロック

MCPツールブロックでは次のことができます:

  • 設定済みのMCPツールを直接実行
  • ツールに特定のパラメータを渡す
  • ツールの出力を後続のワークフローステップで使用
  • 複数のMCPツールを連鎖させる

MCPツールとエージェントの使い分け

MCPツールを使用したエージェントを使用する場合:

  • AIにどのツールを使用するか決定させたい
  • ツールをいつどのように使用するかについて複雑な推論が必要
  • ツールとの自然言語による対話が必要

MCPツールブロックを使用する場合:

  • 決定論的なツール実行が必要な場合
  • 既知のパラメータで特定のツールを実行したい場合
  • 予測可能なステップで構造化されたワークフローを構築している場合

権限要件

MCP へのアクセスはロールと権限カタログによって制御されます。

操作カタログ権限
MCP 領域とサーバーメタデータの表示workspace:read_mcpmcp_server:readmcp_tool:list
サーバーの追加または変更workspace:manage_mcpmcp_server:manage
ツールの更新または呼び出しmcp_server:refreshmcp_tool:call
サーバーの削除mcp_server:delete

有効なアクセス権は、ロール、割り当てスコープ、グループ、継承、明示的な拒否によって決まります。

一般的な使用例

データベース統合

データベースに接続して、ワークフロー内でデータのクエリ、挿入、更新を行います。

API統合

SteelEngineに組み込まれていない外部APIやWebサービスにアクセスします。

ファイルシステムアクセス

ローカルまたはリモートのファイルシステム上のファイルの読み取り、書き込み、操作を行います。

カスタムビジネスロジック

組織固有のニーズに合わせたカスタムスクリプトやツールを実行します。

リアルタイムデータアクセス

ワークフロー実行中に外部システムからライブデータを取得します。

セキュリティに関する考慮事項

  • MCPサーバーは、それを構成したユーザーの権限で実行されます
  • インストール前に必ずMCPサーバーのソースを確認してください
  • 機密性の高い構成データには環境変数を使用してください
  • エージェントにアクセスを許可する前にMCPサーバーの機能を確認してください

トラブルシューティング

MCPサーバーが表示されない

  • サーバー構成が正しいことを確認してください
  • 必要な権限があることを確認してください
  • MCPサーバーが実行中でアクセス可能であることを確認してください

ツール実行の失敗

  • ツールパラメータが正しくフォーマットされていることを確認してください
  • エラーメッセージについてMCPサーバーログを確認してください
  • 必要な認証が構成されていることを確認してください

権限エラー

  • ワークスペースで有効なロールとカタログ権限を確認してください
  • MCPサーバーが追加の認証を必要としているか確認してください
  • サーバーがワークスペースに対して適切に設定されているか確認してください

On this page