AI をスクリプトで縛るな。武器を持たせろ。
必要なことを普通の言葉で AI に伝えるだけ。 あとは MCP Skills が処理します。
これを貼り付けるだけ。それで完了。
下の行を任意の AI コーディングアシスタントにコピーしてください。
uv、Playwright、MCP 設定、スキルまで — すべて自動でインストールします。
Install and configure mfa-servicenow-mcp by following the instructions here:
curl -s https://raw.githubusercontent.com/jshsakura/mfa-servicenow-mcp/main/docs/llm-setup.md
Claude Code、Cursor、Codex、OpenCode、Windsurf、VS Code Copilot、Antigravity、Zed などで動作します。
AI がクライアントと OS を検出し、対話的にセットアップへ導きます。
セットアップ後は、AI クライアントを再起動 して MCP サーバーを読み込んでください。
企業のセキュリティツールによって uvx がブロックされている場合は、下記の
uvx がブロックされる場合（pip） セクションへ進んでください。
インストールしてから、クライアント設定に追加する
ターミナル派ですか? uv + Chromium をインストールしてから、サーバーを MCP クライアントの設定ファイルに追加してください（下記スニペット）。インストーラーコマンドも、クライアントごとのフラグも不要です。
# 1. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Fetch the server + Chromium up front (so the first browser-auth call
# doesn't download ~150 MB and time out)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium
# 3. Add the server to your MCP client config — copy a snippet below# 1. Install uv (if not already installed)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 2. Fetch the server + Chromium up front (so the first browser-auth call
# doesn't download ~150 MB and time out)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium
# 3. Add the server to your MCP client config — copy a snippet belowpip でインストールする
Windows の Smart App Control は uvx をブロックします。uvx は実行のたびに署名のない一時実行ファイルを展開するためです。少し前まで動いていた uvx が Windows Update の直後に動かなくなったなら、原因はこれです。pip でインストールし、サーバーはモジュールとして起動してください — servicenow-mcp コンソールスクリプトは pip が生成する署名のない .exe ラッパーなので、同じ理由でブロックされます。
# Homebrew やディストリ標準の Python はグローバルな pip インストールを拒否します (PEP 668)。
# python.org 版の Python を使うか、上の uvx のままでも構いません。
pip install mfa-servicenow-mcp playwright
python -m playwright install chromium
# 確認:
python -m servicenow_mcp --version
# 後で更新する場合:
pip install --upgrade mfa-servicenow-mcp playwright
python -m playwright install chromium# python.org の Python 3.10+ は署名済みで Smart App Control を通過します。
pip install mfa-servicenow-mcp playwright
python -m playwright install chromium
# 確認:
python -m servicenow_mcp --version
# 後で更新する場合:
pip install --upgrade mfa-servicenow-mcp playwright
python -m playwright install chromium
env ブロックはどちらでも同じで、変わるのは command と args だけです。下記の 手動フォールバック セクションのスニペットを貼り付け、command を python、args を ["-m", "servicenow_mcp"] に設定してください。
クライアント設定を手動で修復または検査する
インストーラーが推奨される方法です。下記の生の設定例は、クライアント設定を手作業で検査または修復する必要がある場合にのみ使用してください。
4 つの異なる形が、サポートされているすべてのクライアントをカバーします。env ブロックはどこでも同一です — 外側のラッパーだけが異なります。
{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your-username",
"SERVICENOW_PASSWORD": "your-password"
}
}
}
}{
"servicenow": {
"command": "uvx",
"args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your-username",
"SERVICENOW_PASSWORD": "your-password"
}
}
}[mcp_servers.servicenow]
command = "uvx"
args = ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"]
enabled = true
[mcp_servers.servicenow.env]
SERVICENOW_INSTANCE_URL = "https://your-instance.service-now.com"
SERVICENOW_AUTH_TYPE = "browser"
SERVICENOW_BROWSER_HEADLESS = "false"
SERVICENOW_USERNAME = "your-username"
SERVICENOW_PASSWORD = "your-password"{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servicenow": {
"type": "local",
"command": [
"uvx", "--with", "playwright",
"--from", "mfa-servicenow-mcp", "servicenow-mcp"
],
"enabled": true,
"environment": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your-username",
"SERVICENOW_PASSWORD": "your-password"
}
}
}
}
読み取り専用の standard パッケージがデフォルトで読み込まれます — MCP_TOOL_PACKAGE は不要です。
書き込みアクセスには、高度なパッケージ（service_desk、portal_developer、
platform_developer、または full）に設定してください —
ツールパッケージ（高度）ガイド を参照。
LLM 最適化スキルを追加する
ツールだけでは生の API 呼び出しにすぎません。スキルこそが LLM を実際に役立つものにします — 安全ゲート、ロールバック、コンテキスト対応の委譲を備えた検証済みパイプライン。 今日は 4 スキル、リリースのたびに増えていきます。
uvx --from mfa-servicenow-mcp servicenow-mcp-skills claudeuvx --from mfa-servicenow-mcp servicenow-mcp-skills codexuvx --from mfa-servicenow-mcp servicenow-mcp-skills opencodeuvx --from mfa-servicenow-mcp servicenow-mcp-skills antigravity🔍 analyze/
1 スキル — ローカルソース監査: 相互参照、デッドコード、実行順序、HTML レポート
🧭 explore/
1 スキル — フロートリガートレース: テーブル変更時にどのワークフロー/フローが発火するか
📦 manage/
2 スキル — アプリソースダウンロード、ローカル同期（diff → 競合検出付きプッシュ）
常に最新バージョンを実行する
uvx は最後にダウンロードしたバージョンをキャッシュします — 自動更新は されません。
uv 経由でアップグレードして最新リリースを取得してください:
uvx --refresh --from mfa-servicenow-mcp servicenow-mcp --versionその後、MCP クライアント（Claude Code、Cursor など）を再起動して新しいバージョンを読み込んでください。
本番までの 3 ステップ
設定する API キーも、設定ファイル内のパスワードもありません。 ブラウザで一度認証すれば、AI エージェントがライブセッションを引き継ぎます。
インストール
uvx による 1 コマンドですべてをセットアップ。設定ゼロ。
認証
MFA、SSO、SAML — 組織が要求するものは何でも、実ブラウザが開きます。
接続
Claude、Cursor、Zed、または任意の MCP クライアントを向けるだけ。66 個の登録済みツールがアクティブなパッケージプロファイルを通じて読み込まれます。
エンタープライズ向けに構築
AI エージェントと ServiceNow を、安全かつ大規模に橋渡しするために必要なすべて。
🔒 ゼロトラストセキュリティ
ブラウザベースの認証により、クレデンシャルがマシンから出ることはありません。MFA、SSO、SAML、そして組織が使う任意のログインフローに対応します。
⚡ トークン効率の高いパフォーマンス
遅延ツール検出、パッケージスコープのスキーマ、コンパクトな JSON、レスポンスキャッシュ、バッチ読み取りにより、起動と LLM のコンテキストコストを抑えます。
🧩 安全なデータ比較
任意の名前付きインスタンスは、読み取り専用の dev/test ドリフトチェックに限定されます。通常のツールは 1 つのアクティブなインスタンスに固定されたままです。
🤖 幅広いクライアント対応
Claude、Codex、Cursor、Zed、Antigravity、OpenCode、Windsurf、VS Code Copilot、そして stdio または Streamable HTTP 経由の MCP クライアントで動作します。