ServiceNow ITSM MCPサーバー
ServiceNow ITSM MCPサーバーは、自然な会話を通じてLLMをServiceNow Incident Managementに接続します。 インシデントのログ記録、検索、読み取り、更新、解決を行い、ナレッジベース記事を検索してインシデントの回避または解決に役立てるためのツールを提供します。
このサーバーはServiceNow Incident Managementをサポートしています。 サービスリクエストとカタログ注文、変更管理と問題管理、CSMケース、CMDBとアセット操作、ナレッジ作成はサポートしていません。
用途
ServiceNow ITSM MCPサーバーを使用して、次のアクションを実行します:
- 説明、チャットメッセージ、または監視アラートから新しいインシデントをログに記録します。
- 状態、優先度、割り当てグループ、またはキーワードでインシデントキューを検索およびフィルタリングします。
- 番号またはシステムIDで特定のインシデントの完全な詳細を取得します。
- 特定のユーザーが報告したインシデントのステータスを確認します。
- 作業メモまたは顧客コメントの追加、優先度の更新、またはインシデントの再割り当てを行います。
- 解決コードとメモを使用してインシデントを解決します。
- ナレッジベースを検索し、記事を読んでインシデントの回避または解決の迅速化を行います。
- インシデントをルーティングするために、ユーザーと割り当てグループを検索します。
- インシデントフィールドを設定する前に、その有効な値を確認します。
プロンプト例
次のプロンプト例を使用して、ServiceNow ITSM MCPサーバーツールを呼び出します:
Log an incident: the VPN is down for the sales team, high urgency.What's the status of the incidents Jordan Lee reported?Show me all high-priority incidents assigned to the network team.Get the details for incident INC0010045.Add a work note to INC0010045 saying we're waiting on the vendor.Reassign INC0010045 to the database team.Resolve INC0010045: the network switch was replaced.Is there a knowledge article on resetting a VPN connection?Find the ServiceNow user record for [email protected].What resolution codes are available for closing an incident?
ServiceNow ITSM MCPサーバーツール
ServiceNow ITSM MCPサーバーは次のツールを提供します:
| ツール | 説明 |
|---|---|
| create_incident | 短い説明と、呼び出し元、緊急度、影響、割り当てグループ、カテゴリなどの任意のコンテキストから、ServiceNowに新しいインシデントを作成します。 |
| get_incident | 番号またはシステムIDで単一のインシデントの完全な詳細を取得します。これには、状態、優先度、割り当て、解決フィールドが含まれます。 |
| search_incidents | 状態、優先度、割り当てグループ、担当者、呼び出し元、日付範囲、キーワードなどのフィルターを使用してインシデントを検索します。 |
| list_caller_incidents | 指定されたユーザーが呼び出し元であるインシデントを、ステータス、割り当て、最終更新とともに一覧表示します。 |
| update_incident | 既存のインシデントの作業メモ、コメント、優先度、緊急度、影響、割り当て、または状態を更新します。 |
| resolve_incident | 必須の解決コードと解決メモを使用してインシデントを解決し、任意で最終的な顧客コメントを追加します。 |
| search_knowledge | クエリに一致する公開済み記事をナレッジベースで検索し、フォローアップ取得用のタイトルと識別子を返します。 |
| get_knowledge_article | 記事番号またはシステムIDで単一のナレッジ記事の完全な内容を取得します。 |
| find_users | 呼び出し元または担当者の参照を解決するために、名前またはメールアドレスでServiceNowユーザーを検索します。 |
| list_assignment_groups | インシデントをルーティングするための割り当てグループを一覧表示または検索します。任意で名前でフィルタリングできます。 |
| list_incident_field_values | 状態、優先度、緊急度、影響、保留理由、解決コード、カテゴリなど、指定されたインシデント選択フィールドで許可される値を返します。 |
ServiceNow ITSM MCPサーバーのインストール
構築済みMCPサーバーをプロジェクトにインストールするには、次の手順を完了します:
Workatoアカウントにサインインします。
AI Hub > Enterprise MCPに移動します。
+ Create MCP serverをクリックします。
接続済みアプリを使用して構築済みMCPサーバーを開始するセクションに移動し、使用する構築済みMCPサーバーを選択します。
Use this serverをクリックします。
サーバー名フィールドにMCPサーバーの名前を入力します。
場所ドロップダウンメニューを使用して、MCPサーバーのプロジェクトを選択します。
Connectionsセクションに移動し、アプリアカウントに接続します。
MCPサーバーテンプレートで使用するコネクションタイプを選択します。
- User's connection: MCPサーバーツールは、アプリケーションに接続するユーザーのIDと権限に基づいてアクションを実行します。 ユーザーは自分の認証情報で認証し、スキルを実行します。
- Your connection: このオプションでは、レシピビルダーによって確立されたコネクションを使用し、通常のアプリコネクションと同じ原則に従います。
コネクションタイプを選択
検証済みユーザーアクセスの認証要件
OAuth 2.0認可コードグラントを使用するアプリコネクションのみが、ユーザーのコネクションで利用できます。 詳細については、検証済みユーザーアクセスを参照してください。
次のセクションで、アプリ固有のコネクション設定手順を完了します。
APIバージョン
ServiceNowコネクターはServiceNow REST API v2を使用します。
ServiceNow ITSMコネクション設定
ServiceNow ITSMコネクション設定手順を表示
ServiceNowコネクターは、次の認証タイプをサポートしています:
ユーザー名とパスワード
ユーザー名とパスワード認証手順を表示
ログイン認証情報を使用してServiceNowインスタンスに接続するには、Username/Password認証タイプを選択します。
Username/Passwordコネクション
| フィールド | 説明 |
|---|---|
| コネクション名 | 接続先のServiceNowインスタンスを識別する一意の名前を入力します。 |
| 認証タイプ | このServiceNowコネクションの認証タイプを選択します。 ServiceNowコネクターは、Username/Password(Basic)認証、authorization code grantを使用したOAuth 2.0、およびPassword grant認証をサポートしています。 |
| インスタンス名 | インスタンスの名前を指定します。 たとえば、ServiceNow URLがhttps://acme.service-now.comの場合、インスタンス名はacmeです。 |
| ユーザー名 | ServiceNowへの接続に使用するユーザー名を指定します。 |
| パスワード | ServiceNowへの接続に使用するパスワードを指定します。 |
| Custom OAuth profile | 任意です。 このコネクションのCustom OAuth profileを選択します。 |
OAuth 2.0
OAuth 2.0認証手順を表示
OAuth 2.0クライアントの設定
OAuth 2.0クライアントを設定するには、ServiceNowのadminロールで次の手順を実行します:
OAuth 2.0 (com.snc.platform.security.oauth) プラグインを有効化します。 OAuth 2.0を有効化する方法の詳細については、ServiceNowドキュメントを参照してください。
OAuthプラグインの有効化
クライアントアプリケーションがServiceNowインスタンスへのアクセスを取得するためのエンドポイントを作成します。 Redirect URLとしてhttps://www.workato.com/oauth/callbackを使用します。 外部クライアント用のエンドポイントを作成する方法の詳細については、ServiceNowドキュメントを参照してください。
OAuth 2.0クライアント
Client IDとClient secretを使用して、WorkatoでServiceNowコネクションを作成します。 これにより、認可を要求する新しいブラウザーウィンドウが開くOAuth authorization code grantフローがトリガーされます。
Workatoでセットアップを完了する
ログイン認証情報を使用せずにServiceNowインスタンスに接続するには、OAuth 2.0認証タイプを選択します。 この認証タイプでは、ログイン認証情報を開示する代わりにトークンを取得することで、Workatoへのアクセスを許可できます。
ServiceNow Istanbul以降のリリースでは、認可コードグラントを使用するOAuth 2.0コネクションがサポートされています。 この認証タイプを選択する際は、ご利用のServiceNowバージョンがこれをサポートしていることを確認してください。
OAuth 2.0コネクション
| フィールド | 説明 |
|---|---|
| コネクション名 | 接続先のServiceNowインスタンスを識別する一意の名前を入力します。 |
| 認証タイプ | このServiceNowコネクションの認証タイプを選択します。 ServiceNowコネクターは、Username/Password(Basic)認証、authorization code grantを使用したOAuth 2.0、およびPassword grant認証をサポートしています。 |
| インスタンス名 | インスタンスの名前を指定します。 たとえば、ServiceNow URLがhttps://acme.service-now.comの場合、インスタンス名はacmeです。 |
| Client ID | 認可に使用するコネクションのClient IDを指定します。 OAuthクライアントのApplication Registry(アプリケーションレジストリ)をセットアップする方法の詳細については、OAuth 2.0クライアントのセットアップセクションを参照してください。 |
| クライアントシークレット | このOAuthアプリケーションのClient secretを指定します。 シークレットを表示するには、Toggle Password Visibility(ロックアイコン)をクリックします。 |
| Custom OAuth profile | 任意です。 このコネクションのCustom OAuth profileを選択します。 |
INVALID REFRESH TOKENエラー
ServiceNow OAuth 2.0コネクションの有効期限が切れた後、invalid_requestまたはinvalid refresh tokenエラーが発生する場合があります。 この動作は、ServiceNowがリフレッシュトークンの有効期間を制限しているために発生します。 トークンの有効期限が切れたら、コネクションを再認証する必要があります。
ServiceNow OAuthクライアント設定でRefresh Token Lifetimeを調整できます。 ServiceNowインスタンスに移動し、System OAuth > Application Registryをクリックして、Workato OAuthクライアントを開き、Refresh Token Lifetimeの値を確認します。 デフォルトのリフレッシュトークンの有効期間は100日です。
詳細については、ServiceNow external clientドキュメントを参照してください。
パスワードグラント
Password grant認証手順を表示
ServiceNowインスタンスに接続するには、Password grant認証タイプを選択します。 この認証タイプでは、アクセストークンの取得に使用されるログイン認証情報を提供することで、Workatoへのアクセスを許可できます。
Password grantコネクション
| フィールド | 説明 |
|---|---|
| コネクション名 | 接続先のServiceNowインスタンスを識別する一意の名前を入力します。 |
| 認証タイプ | このServiceNowコネクションの認証タイプを選択します。 ServiceNowコネクターは、Username/Password(Basic)認証、authorization code grantを使用したOAuth 2.0、およびPassword grant認証をサポートしています。 |
| インスタンス名 | インスタンスの名前を指定します。 たとえば、ServiceNow URLがhttps://acme.service-now.comの場合、インスタンス名はacmeです。 |
| ユーザー名 | ServiceNowへの接続に使用するユーザー名を指定します。 |
| パスワード | ServiceNowへの接続に使用するパスワードを指定します。 |
| Client ID | 認可に使用するコネクションのClient IDを指定します。 OAuthクライアントのApplication Registry(アプリケーションレジストリ)をセットアップする方法の詳細については、OAuth 2.0クライアントのセットアップセクションを参照してください。 |
| クライアントシークレット | このOAuthアプリケーションのClient secretを指定します。 シークレットを表示するには、Toggle Password Visibility(ロックアイコン)をクリックします。 |
| Custom OAuth profile | 任意です。 このコネクションのCustom OAuth profileを選択します。 |
ServiceNowロール要件
各ツールの利用可否は、接続済みアカウントに付与された権限によって異なります。 標準のインシデントアクションには、ITILロール、またはインシデントテーブルへの読み取りおよび書き込みアクセス権を持つカスタムロールが必要です。 ナレッジ、ユーザー、グループの読み取りには、それぞれのテーブルへの読み取りアクセス権が必要です。 必要な権限なしで行われたリクエストは、部分的な結果ではなく、権限拒否の結果を返します。 詳細については、ServiceNowのすべてのServiceNowロールガイドを参照してください。
プロジェクトプロパティ設定
ServiceNow ITSM MCPサーバーは、動作とデフォルトを制御するために、次のプロジェクトレベルのプロパティをサポートしています:
| プロジェクトレベルのプロパティ | 説明 |
|---|---|
knowledge_article_max_length | get_knowledge_articleによって返される記事本文の最大長。 これより長い記事は切り捨てられ、レスポンスには切り捨てが発生したことが示されます。 |
knowledge_article_format | コネクション設定に基づいてget_knowledge_articleによって返されるコンテンツ形式: プレーンテキストまたは未加工HTML。 |
プロジェクトレベルのプロパティ設定手順を表示
プロジェクトレベルのプロパティを設定するには、次の手順を実行します:
Workatoアカウントにサインインし、プロジェクトに移動します。
MCPサーバーを含むプロジェクトに移動します。
Settingsタブをクリックします。
Settingsタブをクリックします。
プロジェクトプロパティを選択します。
更新するプロジェクトプロパティに移動し、Edit(鉛筆)アイコンをクリックします。
Valueフィールドに移動して変更を加えます。
ServiceNow ITSM MCPサーバーツールの使用方法
利用可能なツールの詳細については、次のセクションを参照してください:
create_incidentツール
create_incidentツールは、短い説明と、呼び出し元、緊急度、影響、割り当てグループ、カテゴリなどの任意のコンテキストから、ServiceNowに新しいインシデントを作成します。 LLMはこのツールを使用して、説明、チャットメッセージ、または監視アラートから新しいインシデントをログに記録し、提供されたあらゆるコンテキストを取り込みます。
質問例:
Log an incident: the VPN is down for the sales team, high urgency.Open a ticket for a printer outage on the third floor.Report that the billing service is down and assign it to the applications team.Create an incident for Jordan Lee: their laptop won't connect to Wi-Fi.
get_incidentツール
get_incidentツールは、番号またはシステムIDで単一のインシデントの完全な詳細を取得します。これには、状態、優先度、割り当て、解決フィールドが含まれます。 LLMはこのツールを使用して、特定のインシデントのステータス、優先度、割り当て、またはその他の詳細を確認します。
質問例:
Get the details for incident INC0010045.What's the status of INC0010045?Who is INC0010045 assigned to?Show me the work notes on INC0010045.
search_incidentsツール
search_incidentsツールは、状態、優先度、割り当てグループ、担当者、呼び出し元、日付範囲、キーワードなどのフィルターを使用してインシデントを検索します。 LLMはこのツールを使用して、チームのオープンキュー、高優先度のインシデント、またはキーワードに言及しているインシデントなどの条件に一致するインシデントを検索します。
質問例:
Show me all high-priority incidents assigned to the network team.Find open incidents mentioning "VPN".What incidents were opened today?List incidents assigned to Jordan Lee that are still active.
list_caller_incidentsツール
list_caller_incidentsツールは、指定されたユーザーが呼び出し元であるインシデントを、ステータス、割り当て、最終更新とともに一覧表示します。 LLMはこのツールを使用して、特定の人物が報告したインシデントのステータスを確認します。
質問例:
What's the status of the incidents Jordan Lee reported?Show me the open tickets that [email protected] submitted.Has Jordan Lee reported any incidents this week?List all incidents raised by Jordan Lee.
update_incidentツール
update_incidentツールは、既存のインシデントの作業メモ、コメント、優先度、緊急度、影響、割り当て、または状態を更新します。 LLMはこのツールを使用してインシデントを進めます: メモの追加、重大度の変更、または再割り当てを行います。
質問例:
Add a work note to INC0010045 saying we're waiting on the vendor.Post a comment to the caller on INC0010045 confirming we're investigating.Reassign INC0010045 to the database team.Set INC0010045 to on hold, waiting on the vendor.
resolve_incidentツール
resolve_incidentツールは、必須の解決コードと解決メモを使用してインシデントを解決し、任意で最終的な顧客コメントを追加します。 LLMは、ユーザーがインシデントは修正済みで解決可能であることを確認したときに、このツールを使用します。
質問例:
Resolve INC0010045: the network switch was replaced.Close out INC0010045: the fix was clearing the browser cache.Mark this incident resolved and let the caller know it's fixed.Resolve INC0010045 and tell the caller the VPN issue is fixed.
search_knowledgeツール
search_knowledgeツールは、クエリに一致する公開済み記事をナレッジベースで検索し、フォローアップ取得用のタイトルと識別子を返します。 LLMはこのツールを使用して、インシデントを回避または解決するのに役立つ可能性があるナレッジ記事を検索します。
質問例:
Is there a knowledge article on resetting a VPN connection?Search the knowledge base for password reset instructions.Find articles about printer connectivity issues.Is there a KB article that explains this error?
get_knowledge_articleツール
get_knowledge_articleツールは、記事番号またはシステムIDで単一のナレッジ記事の完全な内容を取得します。 LLMはこのツールを使用して、ユーザーが指定した記事、またはsearch_knowledgeが返した記事の完全な内容を読み取ります。
質問例:
Read the article about resetting a VPN connection.Show me the full content of KB0012345.What does that knowledge article say to do?Pull up the steps in that VPN troubleshooting article.
find_usersツール
find_usersツールは、呼び出し元または担当者の参照を解決するために、名前またはメールアドレスでServiceNowユーザーを検索します。 LLMはこのツールを使用して、呼び出し元または担当者の設定に必要なServiceNowユーザーレコードを検索します。
質問例:
Find the ServiceNow user record for [email protected].Look up the user Jordan Lee.Who is the ServiceNow user for this email address?Find users matching the name "Jordan".
list_assignment_groupsツール
list_assignment_groupsツールは、インシデントをルーティングするための割り当てグループを一覧表示または検索します。任意で名前でフィルタリングできます。 LLMはこのツールを使用して、インシデントの割り当て先となる適切なチームを検索します。
質問例:
Find the assignment group for the database team.What assignment groups are available for network issues?Look up the group name for the service desk team.Which team should handle this incident?
list_incident_field_valuesツール
list_incident_field_valuesツールは、状態、優先度、緊急度、影響、保留理由、解決コード、カテゴリなど、指定されたインシデント選択フィールドで許可される値を返します。 LLMはこのツールを使用して、変更を行う前に解決コードや保留理由などのフィールドの有効な値を確認します。
質問例:
What resolution codes are available for closing an incident?What are the valid priority values for incidents?What hold reasons can I choose from?What states can an incident be in?
はじめに
MCP serverのツールは、Overviewページのツールセクションで表示および管理できます。 ツール管理では、次の機能を利用できます:
ツールを開始する必要があります
LLMは、MCP server connector内のアクティブなツールにのみアクセスできます。
最終更新日: