Servicenow MCP

ServiceNow MCPサーバーの実装で、ClaudeがServiceNowインスタンスとやり取りするためのブリッジを提供します。

顧客サポート開発者ツール #サービス管理 #プロセス自動化 #API統合 #インテリジェントアシスタント .Python

スコア : 2.5ポイント

ダウンロード数 : 4.9K

更新時間 : 2025-04-28

サイトを開く

ServiceNow MCPサーバーとは？

ServiceNow MCPサーバーは、ClaudeがMCPプロトコルを介してServiceNowインスタンスに接続できるブリッジツールです。これを使用して、データを取得したり、レコードを作成または更新したり、スクリプトを実行したり、サービスカタログを最適化したりできます。

ServiceNow MCPサーバーの使い方は？

まず、Python環境をインストールし、正しい認証情報を設定してください。その後、サーバーを起動し、Claudeを介してサーバーとやり取りします。

適用シナリオ

ServiceNow機能を統合する必要がある企業ユーザー、特に自動化ワークフローを実現し、作業効率を向上させたいチームに適しています。

主要機能

インシデント管理

インシデントの作成、更新、コメントの追加、解決などの操作を行います。

サービスカタログ管理

サービスカタログに関連する操作を行います。

カタログ最適化

サービスカタログを分析し、最適化してユーザー体験を向上させます。

変更管理

変更要求の作成、提出、承認を行います。

ワークフロー管理

ワークフローのリスト表示、取得、作成、更新を行います。

変更セット管理

コードの変更セットを管理します。作成、提出、公開などの操作が含まれます。

知識ベース管理

知識記事の作成、更新、公開を行います。

ユーザー管理

ユーザーおよびユーザーグループの作成、更新を行います。

利点

ServiceNowとの統合プロセスを簡素化する

複数の認証方式（基本認証、OAuth、APIキー）をサポートする

複数のビジネス分野をカバーする強力なAPIインターフェース

制限

機能を完全に活用するには一定の技術的背景が必要です

追加のネットワーク環境の設定が必要になる場合があります

使い方

Python環境をインストールする

システムにPython 3.11以上がインストールされていることを確認してください。

認証情報を設定する

.envファイルにServiceNowインスタンスのURL、ユーザー名、パスワードなどの情報を記入してください。

サーバーを起動する

コマンドを実行してMCPサーバーを起動します。

使用例

新しいインシデントを作成する

Claudeに指令を送信して新しいインシデントレコードを作成します。

サービスカタログを最適化する

既存のカタログ項目を分析して改善提案を行います。

変更要求を提出する

データベースのアップグレードを実施するための変更要求を提出します。

よくある質問

認証失敗の問題はどう処理すればいいですか？

複数のServiceNowインスタンスを同時にサポートできますか？

未知のエラーが発生した場合はどうすればいいですか？

🚀 サービスナウ (ServiceNow) ツールドキュメント

このプロジェクトは、ServiceNowシステムとの相互作用を可能にするツールやスクリプトを提供します。主な機能は以下の通りです。

サービスディレクトリを統合し、管理することができます。
サービスディレクトリの最適化機能を提供します。
変更要求の作成、管理、操作を行うことができます。
ワークフローの設計と実行を行うことができます。
複数の変更要求の集合を管理することができます。
サービスの知識ベース記事を統合します。
ユーザーとグループの作成、更新、管理を行うことができます。

🚀 クイックスタート

このプロジェクトでは、ServiceNowシステムとのやり取りを支援するツールやスクリプトを提供しています。以下に主な機能を紹介します。

✨ 主な機能

サービスディレクトリ統合：ServiceNowのサービスディレクトリを統合し、管理します。
ディレクトリ最適化：サービスディレクトリを最適化する機能を提供します。
変更管理：変更要求の作成、管理、操作を行います。
ワークフロー管理：ワークフローの設計と実行を行います。
変更セット管理：複数の変更要求の集合を管理します。
知識ベース統合：サービスの知識ベース記事を統合します。
ユーザー管理：ユーザーとグループの作成、更新、管理を行います。

💻 使用例

基本的な使用法

プロジェクトには、ツールの使用方法を示すデモスクリプトが含まれています。

- examples/catalog_optimization_example.py：ServiceNowのサービスディレクトリを分析し、改善する方法を示します。
- examples/change_management_demo.py：変更要求の作成と管理方法を示します。

📦 インストール

基本認証

SERVICENOW_AUTH_TYPE=basic
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password

OAuth認証

SERVICENOW_AUTH_TYPE=oauth
SERVICENOW_CLIENT_ID=your-client-id
SERVICENOW_CLIENT_SECRET=your-client-secret
SERVICENOW_TOKEN_URL=https://your-instance.service-now.com/oauth_token.do

APIキー認証

SERVICENOW_AUTH_TYPE=api_key
SERVICENOW_API_KEY=your-api-key

📚 ドキュメント

詳細なドキュメントはdocsディレクトリにあります。

サービスディレクトリ統合 - サービスディレクトリ統合の詳細情報
ディレクトリ最適化計画 - ディレクトリ最適化機能の詳細な計画
変更管理 - 変更管理ツールの詳細説明
ワークフロー管理 - ワークフロー管理ツールの詳細説明
変更セット管理 - 変更セット管理ツールの詳細説明

🔧 技術詳細

変更管理ツールの一般的なエラー

エラー: argument after ** must be a mapping, not CreateChangeRequestParams
- このエラーは、create_change_request関数にCreateChangeRequestParamsオブジェクトではなく辞書を渡した場合に発生します。
- 解決策: パラメータ辞書を渡すようにし、Pydanticモデルオブジェクトではないことを確認してください。
- 注意: 変更管理ツールは、このエラーを自動的に処理するように更新されています。関数は、パラメータが誤って包装されたり、Pydanticモデルオブジェクトとして渡された場合でも、自動的にパラメータを展開しようとします。
エラー: 缺少必需的'短描述'参数
- このエラーは、変更要求を作成するために必要なすべてのパラメータが提供されていない場合に発生します。
- 解決策: すべての必須パラメータを含めるようにしてください。create_change_requestの場合、short_descriptionとtypeは必須です。
エラー: 无效的'type'参数值
- このエラーは、typeパラメータに無効な値が渡された場合に発生します。
- 解決策: 有効な値 ("normal"、"standard"、または "emergency") を使用してください。
エラー: 无法在auth_manager或server_config中找到get_headers方法
- このエラーは、認証設定が正しくない場合に発生します。
- 解決策: auth_managerとserver_configの設定が正しいことを確認してください。設定については、認証ドキュメントを参照してください。