コンテンツにスキップ
MFA ServiceNow MCP

ツールパッケージ — 高度なリファレンス

ほとんどのユーザーにこのページは不要です。 デフォルトのパッケージは standard です — 読み取り専用で、どの環境でも安全です。 standard が提供する以上の書き込みツールが必要な場合のみ読み進めてください。

パッケージの選択

Section titled “パッケージの選択”

自分の作業をカバーする最も狭いパッケージから始めてください。1 段階上がるごとに、より多くのドメインへの書き込みアクセスが追加されます:

読み取り専用 — どの環境でも安全、書き込みツールなし:

パッケージ ツール数 ~トークン 使うべき場面
core 12 ~3.0K 最小限の読み取り専用: ヘルス、スキーマ、検出、キーアーティファクトの検索のみ
standard 31 ~7.3K （デフォルト） インシデント、変更、ポータル、ログ、ソース分析にわたる読み取り専用
none 0 0 すべてのツールを意図的に無効化する（テスト、ロックダウンされた環境）

⚠️ 書き込み可能 — 作成/更新/削除を許可する 高度なオプション:

パッケージ ツール数 ~トークン 使うべき場面
service_desk 33 ~8.2K ⚠️ インシデントと変更の更新/クローズが必要なサービスデスクエージェント
portal_developer 50 ~10.6K ⚠️ ウィジェット、チェンジセット、スクリプトインクルードをデプロイするポータル開発者
platform_developer 44 ~10.8K ⚠️ ワークフロー、Flow Designer、スクリプトを管理するプラットフォームエンジニア
full 61 ~13.8K ⚠️ 最も高度 — すべてのドメインにわたるすべての書き込みツールを一度に有効化（下記の警告を参照）

~トークン = リクエストごとに各パッケージのツールスキーマがモデルのコンテキストに追加する概算トークン数（tiktoken cl100k_base 基準、実際の Claude のトークン数は多少異なる）。狭いパッケージほどコンテキストとコストを節約できます。

core と none を除くすべてのパッケージは、_extends を介して standard の読み取り専用ツールを継承します。完全な継承ツリーは config/tool_packages.yaml を参照してください。

パッケージの設定

Section titled “パッケージの設定”

環境変数経由（推奨）:

Terminal window
MCP_TOOL_PACKAGE=standard

CLI フラグ経由:

Terminal window
servicenow-mcp --tool-package standard --instance-url ...

MCP クライアント設定内:

{
  "env": {
    "MCP_TOOL_PACKAGE": "standard"
  }
}

ツールがパッケージに含まれていない場合に何が起きるか

Section titled “ツールがパッケージに含まれていない場合に何が起きるか”

現在のパッケージで有効になっていないツールを呼び出すと、サーバーは明確なエラーを返します:

Tool 'manage_widget' is not available in package 'standard'.
Enable package 'portal_developer' or higher to use this tool.

サイレントな失敗はありません — LLM は、どのパッケージを要求すべきか正確に把握します。

完全なツール一覧

Section titled “完全なツール一覧”

全 73 ツールのカテゴリ別およびパッケージ所属の完全な一覧は、ツールインベントリ を参照してください。