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 Release 中，并同步发布在 Smithery 上。更喜欢使用包管理器或容器？请参阅下方的快速入门。

它能做什么？

63 个只读工具开箱即用。33 个写入工具（事件、知识库、时间跟踪）仅在你显式选择启用后才会激活。

快速入门

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（或咨询管理员）。服务使用 HTTP Basic 进行身份验证，用户名为 api，密码为你的令牌。

配置

配置按以下顺序解析（优先级从高到低）：

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

输出的信号：

• 跟踪 — 工具执行 Span（GenAI 语义约定）+ InvGate API 请求 Span，包含响应大小和项目数量
• 指标 — 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