swsd

ローカル

mcp-swsd.pages.dev生産性42 日前に更新

swsd について

swsd は SolarWinds Service Desk に接続する MCP サーバーで、チケット、サービスリクエスト、ナレッジ業務、ITSM ワークフローを扱う IT サービスチーム向けです。役割別のツールプロファイルを備え、ユーザーのトークンはリクエストごとに転送し、保存しません。

主な機能

01インシデント、問題、タスクの管理
02変更・リリースワークフローの処理
03資産、調達、リスク情報の照会
04ソリューションとサービスカタログの管理
05業務ロールに応じたツール構成
06読み取りツールでインタラクティブ UI を表示

活用シーン

01担当インシデントの確認と更新
02サービスリクエストとナレッジ記事の処理
03資産と構成アイテムの検索
04工数の記録と添付ファイルのアップロード

MCP 対応

SolarWinds Service Desk API を通じて、チケット、ナレッジ、資産、ITSM 操作を扱う 66 個のツールを MCP クライアントに公開します。一部の読み取りツールは MCP Apps のインタラクティブ UI も返します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "mikimatsub-swsd": {
      "command": "npx",
      "args": [
        "-y",
        "swsd-mcp"
      ],
      "env": {
        "SWSD_TOKEN": "<SWSD_TOKEN>",
        "SWSD_BASE_URL": "<SWSD_BASE_URL>",
        "SWSD_PROFILE": "<SWSD_PROFILE>",
        "SWSD_WRITE_MODE": "<SWSD_WRITE_MODE>",
        "SWSD_ATTACHMENT_ROOT": "<SWSD_ATTACHMENT_ROOT>"
      }
    }
  }
}

起動コマンドnpx -y swsd-mcp

設定が必要な環境変数

SWSD_TOKENシークレットSolarWinds Service Desk admin token (JWT). Generate in the SWSD UI: Setup -> Users & Groups -> Users -> [your user] -> Actions -> Generate JSON Web Token. Service Desk administrator rights required.

SWSD_BASE_URLSWSD API base URL. US tenants: https://api.samanage.com (default). EU tenants: https://apieu.samanage.com.

SWSD_PROFILETool registration profile: 'triage' (14 read-heavy tools), 'agent' (37 default), 'knowledge' (15 KB-author), 'operations' (64 ITSM operations tools), 'full' (66 every tool).

SWSD_WRITE_MODEWrite safety mode: 'live' calls SWSD normally; 'dry-run' returns write payload previews without sending writes; 'disabled' rejects write tools.

SWSD_ATTACHMENT_ROOTOptional real-path boundary for local file_path attachment uploads over stdio. Files outside this directory are rejected.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmswsd-mcp3.1.0stdio

ツール

掲載時のツール一覧 · 4 日前に更新

このツールにパラメーターはありません。

詳細

swsd-mcp

SolarWinds Service Desk（SWSD／Samanage）用の MCP サーバーです。 任意の Model Context Protocol クライアントと連携し、各ユーザー自身の SWSD API トークンを使って、チケット、サービスリクエスト、ナレッジベース関連の作業、変更／リリースのワークフロー、資産／CMDB のコンテキスト、調達記録、リスク、作業時間の記録、添付ファイルを扱えます。テスト済みクライアントの一覧は、クライアント互換性マトリックスをご覧ください。

📖 ドキュメント全文： mcp-swsd.pages.dev

サーバーは認証情報を一切保存しません。トークンはリクエストごとに転送され、永続化もログへの記録もされず、設定された SWSD API ホストにのみ送信されます。

3.0.0 へのアップグレード

MCP SDK v2 では、66 個のツール、5 つのプロファイル、7 つのウィジェット、4 つの従来の HTTP／STDIO プロトコルリビジョンがすべて維持されます。不明なツール名では、JSON-RPC -32602 エラーが発生するようになりました。SDK の呼び出し元では、これらの拒否された呼び出しを捕捉する必要があります。既知のツールの検証エラーは引き続き isError: true を返しますが、エラーテキストが更新されました。厳密なスキーマバリデーターとツールリストのスナップショットでは、新しい JSON Schema 2020-12 のシリアライズを受け入れる必要があります。Node 24 の要件と起動設定に変更はありません。詳細は変更履歴をご覧ください。

クイックスタート

必要なもの：

MCP クライアントがインストールされていること：MCP 対応のクライアントであれば利用できます（互換性マトリックス）
SolarWinds Service Desk の管理者トークン（JWT）：SWSD UI で生成します：Setup → Users & Groups → Users からユーザーをクリックし、Actions → Generate JSON Web Token を選択します（Service Desk 管理者権限が必要です）

VS Code

コマンドパレットを開きます：Windows／Linux では Ctrl+Shift+P、macOS では Shift+Command+P を押します。
MCP: Add Server... を実行します。

対応している次のローカル方法のいずれかでインストールします：
- Command (stdio)：npx -y swsd-mcp を入力します。
- NPM Package：swsd-mcp を入力し、発行元が mikimatsub であることを確認してから、Allow を選択します。

サーバー名に swsd を入力し、VS Code のプロファイル全体に適用する場合は Global、現在のプロジェクトに適用する場合は Workspace を選択します。
SWSD トークンを安全に追加して、接続を確認します。

その他の stdio クライアント

1. 設定を追加する

以下に示す VS Code 以外のクライアントでは、共通の JSON 形式を使用します。クライアントの設定ファイル内で、mcpServers の下に追加してください：

{
  "mcpServers": {
    "swsd": {
      "command": "npx",
      "args": ["-y", "swsd-mcp"],
      "env": {
        "SWSD_TOKEN": "your-jwt-here",
        "SWSD_BASE_URL": "https://api.samanage.com"
      }
    }
  }
}

your-jwt-here をトークンに置き換えます。EU テナントでは、代わりに https://apieu.samanage.com を使用します。動作をカスタマイズするには、任意の設定変数（よく使われるのはツールセットを選択する SWSD_PROFILE）を同じ env ブロックに追加します。

2. 適切なファイルに配置する

クライアント	設定ファイルのパス
Claude Desktop（macOS）	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop（Windows）	`%APPDATA%\Claude\claude_desktop_config.json`
Claude Desktop（Linux）	`~/.config/Claude/claude_desktop_config.json`
Claude Code	`~/.claude.json`（または以下のショートカットを使用）
Cursor	`~/.cursor/mcp.json`
Continue、Cline、その他のクライアント	クライアントのドキュメントを確認してください。JSON の形式は同じです

ファイルが存在しない場合は作成してください。その後、クライアントを再起動します。

Claude Code のショートカット：ファイルを手動で編集する必要はありません。この 1 行を任意のシェル（bash、zsh、PowerShell、cmd）に貼り付けてください。

claude mcp add swsd --env SWSD_TOKEN="your-jwt-here" --env SWSD_BASE_URL="https://api.samanage.com" -- npx -y swsd-mcp

Microsoft Copilot Studio：手順が異なります。Copilot Studio はローカルプロセスを起動できないため、HTTP トランスポートのサーバーが必要です。copilot-studio/README.md と Azure Container Apps の手順を参照してください。

3. 動作を確認する

MCP クライアントで、次のように尋ねてください。

「swsd を使って接続できるか確認してください。」

エージェントが swsd_health_check を呼び出し、成功を報告します。成功したら設定は完了です。ほかにもいくつか試してみましょう。

「インシデント 60310 を表示して」：ID をキーとするツールでは、内部 ID（7 桁以上）または SWSD UI に表示されるユーザー向けの番号（6 桁以下）のどちらでも指定できます。
「過去 7 日間に更新されたインシデントを一覧表示して」：updated_within: "7d"（"24h"、"1w"、"30d" も指定できます）。
「自分に割り当てられているチケットは？」：swsd_list_my_incidents は内部で swsd_get_me を呼び出すため、メールアドレスを明示する必要はありません。

ツール（15 カテゴリにわたる 66 個）

カテゴリ	ツール
ユーティリティ	`swsd_get_server_info`, `swsd_health_check`, `swsd_get_me`
インシデント	`swsd_list_incidents`, `swsd_list_my_incidents`, `swsd_get_incident`, `swsd_create_incident`, `swsd_update_incident`, `swsd_assign_incident`, `swsd_update_incident_state`, `swsd_link_solution_to_incident`
コメント	`swsd_list_incident_comments`, `swsd_add_incident_comment`, `swsd_update_comment`
タスク	`swsd_list_incident_tasks`, `swsd_create_incident_task`, `swsd_update_task_state`
問題	`swsd_list_problems`, `swsd_get_problem`, `swsd_create_problem`
変更とリリース	`swsd_list_changes`, `swsd_get_change`, `swsd_create_change`, `swsd_update_change`, `swsd_list_releases`, `swsd_get_release`, `swsd_create_release`, `swsd_update_release`
資産と CMDB	`swsd_list_hardware_assets`, `swsd_get_hardware_asset`, `swsd_list_mobile_devices`, `swsd_get_mobile_device`, `swsd_list_printers`, `swsd_get_printer`, `swsd_list_software_assets`, `swsd_get_software_asset`, `swsd_list_other_assets`, `swsd_get_other_asset`, `swsd_list_configuration_items`, `swsd_get_configuration_item`
調達とリスク	`swsd_list_contracts`, `swsd_get_contract`, `swsd_list_purchase_orders`, `swsd_get_purchase_order`, `swsd_list_vendors`, `swsd_get_vendor`, `swsd_list_risks`
時間記録	`swsd_list_time_tracks`, `swsd_log_time`, `swsd_update_time_track`
添付ファイル	`swsd_upload_attachment`
ソリューション／KB	`swsd_search_solutions`, `swsd_get_solution`, `swsd_create_solution`, `swsd_update_solution`
サービスカタログ	`swsd_list_catalog_items`, `swsd_get_catalog_item`, `swsd_create_service_request`
参照データ	`swsd_list_categories`, `swsd_list_sites`, `swsd_list_departments`, `swsd_list_users`, `swsd_list_groups`, `swsd_list_roles`
カスタムフィールド	`swsd_describe_custom_fields`
監査	`swsd_get_record_audits`

各ツールの入力スキーマ、説明、出力形式は、実行時に MCP クライアントによって自動検出されます。ツールごとの詳しいドキュメントについては、ツールのリファレンスを参照してください。

MCP Apps ウィジェット（リッチ UI）

7 つの読み取りツールには、MCP Apps 機能を使ったインタラクティブな UI バンドルが含まれています。対応ホスト（Claude Desktop、Claude Web、VS Code Copilot Chat、ChatGPT、Goose、Postman）では、ツールは構造化レスポンスとともにレンダリング済みのウィジェットを返します。テキストのみのホスト（Claude Code、LM Studio）では、同じツールが通常の構造化ペイロードを返します。

合成データの Acme Corp チケットを、並べ替え可能なテーブルで表示する incident-list ウィジェット

例：swsd_list_incidents が incident-list ウィジェットをレンダリングしています。合成データであり、実際のテナント情報は含まれていません。7 つすべてのウィジェットのスクリーンショットはギャラリー全体をご覧ください。

ツール	ウィジェット	表示内容
`swsd_get_incident`	`incident-detail`	単一レコードのカード（説明、期限、SLA、解決内容、カスタムフィールド）
`swsd_get_solution`	`solution-detail`	サニタイズされた HTML 本文を含むナレッジベースの記事
`swsd_list_incidents`, `swsd_list_my_incidents`	`incident-list`	フィルタリングと並べ替えが可能なテーブル
`swsd_list_incident_comments`	`comment-thread`	投稿者チップと公開／非公開バッジを備えた縦型の会話
`swsd_get_record_audits`	`audit-timeline`	操作チップとフィールド差分を日ごとにまとめたタイムライン
`swsd_get_catalog_item`	`catalog-item-form`	`swsd_create_service_request` 経由で送信するフォーム
`swsd_describe_custom_fields`	`custom-fields`	スコープ／モジュールのフィルターを備えた検索可能なエクスプローラー

スクリーンショットと各ウィジェットの詳細は、ウィジェットのリファレンスをご覧ください。

設定

ほとんどのユーザーに必要なのは SWSD_TOKEN と SWSD_BASE_URL だけです。

変数	デフォルト	説明
`SWSD_TOKEN`	なし	必須です。SWSD 管理者トークン（JWT）です。
`SWSD_BASE_URL`	`https://api.samanage.com`	EU テナント：`https://apieu.samanage.com`
`SWSD_PROFILE`	`agent`	`triage`、`agent`、`knowledge`、`operations`、または `full`：プロファイルをご覧ください
`SWSD_WRITE_MODE`	`live`	`live`、`dry-run`、または `disabled`：プロファイルを変更せずに書き込みツールをプレビューまたはブロックします
`SWSD_ATTACHMENT_ROOT`	なし	stdio モードでのローカル `file_path` アップロードに対する、任意の実パス境界です

環境変数の全リファレンス（HTTP トランスポート、再試行、レート制限、許可リスト）は、設定をご覧ください。

プロファイル

プロファイルは起動時に登録されるツールを制御します。セッション中に変更することはできません。

プロファイル	用途	ツール数
`triage`	読み取り中心の一次サポートとコメント	14
`agent`	チケット対応の全ワークフロー（デフォルト）	37
`knowledge`	ナレッジベース作成ワークフローとインシデントの読み取り	15
`operations`	エージェントのワークフローに変更／リリース、ITAM、CMDB、調達、リスクのコンテキストを追加	64
`full`	すべてのツール	66

SWSD_ENABLE_EXTRAS=swsd_foo,swsd_bar を使うと、プロファイルに特定のツールを追加できます。

HTTP サーバーのホスティング（上級者向け）

上記のクイックスタートでは、swsd-mcp をご自身のマシンで実行し、MCP クライアントが必要に応じて npx 経由で起動します。ほとんどのユーザーはこれだけで十分です。

次の要件がある場合にのみ、HTTP モードのサーバーをセットアップしてください。

Microsoft Copilot Studio との統合：Copilot Studio はローカルプロセスを起動できません
チームで共有する単一のインスタンス：1 回のデプロイで多くのユーザーが利用でき、各ユーザーはリクエストごとに自分のトークンを指定します
より厳格なネットワーク制御：プライベート VNet、IP 許可リスト、カスタムドメイン

Docker イメージは、Azure、AWS、GCP、Render、Fly.io、ご自身の VM など、どこでも実行できます。詳しい手順はデプロイをご覧ください。また、Azure Container Apps の手順もご参照ください（Copilot Studio に推奨。ゼロスケール課金）。

ドキュメント

SECURITY.md：GitHub Security Advisories を通じた脆弱性の報告
docs/SECURITY-POSTURE.md：セキュリティ対策、サプライチェーンの強化、検証方法
CONTRIBUTING.md：バグ報告、PR のレビュー基準、ローカル開発環境のセットアップ
CHANGELOG.md：バージョン履歴
copilot-studio/：Microsoft Copilot Studio の Swagger コネクター仕様とインポートガイド
docs/deployment/：クラウドデプロイの手順

ライセンス

MIT：詳細は LICENSE をご覧ください。保証なしの「現状有姿」で提供されます。

商標

SolarWinds、Samanage、Service Desk は SolarWinds Worldwide, LLC の商標です。このプロジェクトは SolarWinds と提携、推奨、または支援を受けていません。公開されている SWSD REST API をラップしています。

Markdown 対応

ログインしてコメント

基本情報

作者: mikimatsub
言語: node
バージョン: 3.1.0
トランスポート: stdio
掲載日: 2026年10月24日
最終更新: 2 日前
公式 Registry: io.github.mikimatsub/swsd

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。