ツールパッケージ — 高度なリファレンス¶
ほとんどのユーザーにこのページは不要です。 デフォルトのパッケージは
standardです — 読み取り専用で、どの環境でも安全です。standardが提供する以上の書き込みツールが必要な場合のみ読み進めてください。
パッケージの選択¶
自分の作業をカバーする最も狭いパッケージから始めてください。1 段階上がるごとに、より多くのドメインへの書き込みアクセスが追加されます:
読み取り専用 — どの環境でも安全、書き込みツールなし:
| パッケージ | ツール数 | ~トークン | 使うべき場面 |
|---|---|---|---|
core |
12 | ~3.0K | 最小限の読み取り専用: ヘルス、スキーマ、検出、キーアーティファクトの検索のみ |
standard |
30 | ~7.3K | （デフォルト） インシデント、変更、ポータル、ログ、ソース分析にわたる読み取り専用 |
none |
0 | 0 | すべてのツールを意図的に無効化する（テスト、ロックダウンされた環境） |
⚠️ 書き込み可能 — 作成/更新/削除を許可する 高度なオプション:
| パッケージ | ツール数 | ~トークン | 使うべき場面 |
|---|---|---|---|
service_desk |
32 | ~8.2K | ⚠️ インシデントと変更の更新/クローズが必要なサービスデスクエージェント |
portal_developer |
45 | ~10.6K | ⚠️ ウィジェット、チェンジセット、スクリプトインクルードをデプロイするポータル開発者 |
platform_developer |
42 | ~10.8K | ⚠️ ワークフロー、Flow Designer、スクリプトを管理するプラットフォームエンジニア |
full |
56 | ~13.8K | ⚠️ 最も高度 — すべてのドメインにわたるすべての書き込みツールを一度に有効化（下記の警告を参照） |
~トークン = リクエストごとに各パッケージのツールスキーマがモデルのコンテキストに追加する概算トークン数（tiktoken cl100k_base 基準、実際の Claude のトークン数は多少異なる）。狭いパッケージほどコンテキストとコストを節約できます。
core と none を除くすべてのパッケージは、_extends を介して standard の読み取り専用ツールを継承します。完全な継承ツリーは config/tool_packages.yaml を参照してください。
⚠️ standard より上のパッケージは、高度な書き込み可能オプションです
service_desk、portal_developer、platform_developer、full はすべて書き込みツールを有効化します — それらの下で動作する AI
エージェントは ServiceNow レコードの作成、更新、削除が可能です。full はそれを すべての
ドメインで同時に（インシデント、変更、ポータル、Flow Designer、ワークフロー、スクリプトなど）行うため、1 つの
誤解されたプロンプトや幻覚が、複数の領域にわたる破壊的な変更を一度に引き起こす可能性があります。
次に該当しない限り、standard から上げないでください:
- パッケージが有効化するすべての書き込みツールを理解している（ツールインベントリ を参照）
- 非本番 または サンドボックス化された インスタンスで作業している、または allow_writes のゲートが整っている
- 意図しない変更からの回復方法を知っている経験豊富な ServiceNow 開発者である
確信がない場合は、読み取り専用のデフォルト standard のままにし、タスクが本当に必要とするときだけ最も狭い書き込みパッケージを選んでください。
パッケージの設定¶
環境変数経由（推奨）:
CLI フラグ経由:
MCP クライアント設定内:
ツールがパッケージに含まれていない場合に何が起きるか¶
現在のパッケージで有効になっていないツールを呼び出すと、サーバーは明確なエラーを返します:
Tool 'manage_widget' is not available in package 'standard'.
Enable package 'portal_developer' or higher to use this tool.
サイレントな失敗はありません — LLM は、どのパッケージを要求すべきか正確に把握します。
完全なツール一覧¶
全 73 ツールのカテゴリ別およびパッケージ所属の完全な一覧は、ツールインベントリ を参照してください。