Invgate Service Desk

invgate-service-desk-mcp

InvGate Service Desk / Service Management 向けの Model Context Protocol サーバーです。

AI アシスタントから InvGate Service Desk にフルアクセスできます。インシデントの照会、ユーザーの検索、ナレッジベースの検索、資産の確認、チケットの管理を、すべて自然言語で行えます。

11 のドメインにわたる96 個のツールを提供します。デフォルトでは読み取り専用で、書き込み操作は明示的に有効にした場合のみ利用できます。

ワンクリックでインストール

Claude Desktop（およびその他の MCPB 対応クライアント）でこのサーバーを使う最も簡単な方法は、ビルド済みバンドルを使用することです。

➡️ invgate-service-desk.mcpb をダウンロード — ダウンロード後、ダブルクリックしてください。Claude Desktop がインストーラーを開き、InvGate のベース URL と API トークンの入力を求めます。これで完了です。Python、npx／uvx、設定ファイルは必要ありません。

.mcpb はすべての GitHub リリースに添付され、Smithery にもミラーされています。パッケージマネージャーやコンテナを使いたい場合は、以下のクイックスタートをご覧ください。

何ができますか？

読み取り専用ツール 63 個はインストール後すぐに利用できます。書き込みツール 33 個（インシデント、KB、時間の記録）は、明示的に有効にした場合のみ利用できます。

クイックスタート

1. インストール

pip install invgate-service-desk-mcp

または、インストールせずに実行します（uv が必要です）。

uvx invgate-service-desk-mcp

2. Claude Desktop に接続する

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "invgate": {
      "command": "uvx",
      "args": ["invgate-service-desk-mcp"],
      "env": {
        "INVGATE_BASE_URL": "https://acme.sd.cloud.invgate.net",
        "INVGATE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Desktop を再起動します。これで完了です。チケットについて質問してみましょう。

{
  "mcpServers": {
    "invgate": {
      "command": "invgate-service-desk-mcp",
      "env": {
        "INVGATE_BASE_URL": "https://acme.sd.cloud.invgate.net",
        "INVGATE_API_TOKEN": "your-api-token"
      }
    }
  }
}

{
  "mcpServers": {
    "invgate": {
      "command": "uvx",
      "args": ["invgate-service-desk-mcp"],
      "env": {
        "INVGATE_BASE_URL": "https://acme.sd.cloud.invgate.net",
        "INVGATE_API_TOKEN": "your-api-token",
        "INVGATE_WRITE_PROFILE": "support"
      }
    }
  }
}

3. API トークンを取得する

InvGate Service Desk インスタンスで、Settings > Integrations > API を開きます（または管理者に問い合わせてください）。サーバーは、ユーザー名 api、パスワードにトークンを指定した HTTP Basic 認証を使用します。

設定

設定は次の順で解決されます（優先度の高い順）。

1. 環境変数（常に優先）
2. ~/.config/invgate-service-desk-mcp/config.toml の TOML 設定

# ~/.config/invgate-service-desk-mcp/config.toml
base_url = "https://acme.sd.cloud.invgate.net"
api_token = "..."
# api_username = "api"
# write_profile = "none"  # "none" (default) | "support" | "full"
# telemetry_enabled = false
# telemetry_detail = "metadata"

ヒント： まず設定ディレクトリを作成してください：mkdir -p ~/.config/invgate-service-desk-mcp

コピーして貼り付けて使えるテンプレートは、config.toml.example を参照してください。

サーバーの実行

invgate-service-desk-mcp                 # STDIO transport (default)
invgate-service-desk-mcp --transport sse # SSE/HTTP transport

セキュリティに関する注意： デフォルトの STDIO では、すべての処理がローカルで行われます。sse と streamable-http のトランスポートには認証機能が組み込まれていないため、ループバックにバインドするか、認証済みのリバースプロキシの背後に置いて使用してください。

オブザーバビリティ（任意）

サーバーは OpenTelemetry のトレース、メトリクス、ログを出力できます。完全にオプトイン方式で、ベンダーに依存しません。OTLP 互換の任意のバックエンド（Dynatrace、Grafana、Datadog、Jaeger など）にエクスポートできます。

pip install "invgate-service-desk-mcp[telemetry]"

export INVGATE_TELEMETRY=1

OTLP エンドポイントとヘッダーは、標準の OpenTelemetry 環境変数を使って設定します（TOML ファイルでは設定しません）。

export OTEL_EXPORTER_OTLP_ENDPOINT="https://<your-env>.live.dynatrace.com/api/v2/otlp"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Api-Token <YOUR_DT_TOKEN>"
export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta
export OTEL_SERVICE_NAME=invgate-service-desk-mcp

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"
export OTEL_SERVICE_NAME=invgate-service-desk-mcp

出力されるシグナル：

• トレース — ツール実行スパン（GenAI セマンティック規約）と、応答サイズおよび項目数を含む InvGate API リクエストスパン
• メトリクス — mcp.tool.duration、invgate.client.request.duration、mcp.tool.errors、invgate.response.item_count、invgate.response.size
• ログ — ツールのエラーと予期しない API 応答形式。トレースと関連付けられます（OTLP のみ。stdout には出力されません）

開発

git clone https://github.com/tracegazer/invgate-service-desk-mcp.git
cd invgate-service-desk-mcp
uv venv && uv pip install -e ".[dev]"
pytest

ライセンス

MIT