使用说明

TDX MCP服务器

A. 模型上下文协议（MCP）包装的服务器 TeamDynamix（TDX）REST API，通过Claude Desktop、Claude Code和其他MCP客户端实现人工智能辅助的IT服务管理。

此服务器公开 41工具 穿过 9个域名 --票证、资产、CMDB、知识库、人员、项目、帐户、组和自定义属性——允许与TDX实例进行自然语言交互。

快速开始

macOS

双击 setup-mac.command
出现提示时，输入您的BEID、Web服务密钥和应用程序ID
重新启动克劳德桌面

视窗

双击 setup-windows.bat
出现提示时，输入您的BEID、Web服务密钥和应用程序ID
重新启动克劳德桌面

手动设置

npm install
npm run build

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "tdx": {
      "command": "node",
      "args": ["/path/to/TDX-MCP/dist/index.js"],
      "env": {
        "TDX_BASE_URL": "https://yourorg.teamdynamix.com/TDWebApi/api",
        "TDX_BEID": "your-beid-guid",
        "TDX_WEB_SERVICES_KEY": "your-web-services-key-guid",
        "TDX_APP_ID": "123"
      }
    }
  }
}

认证

此服务器使用TDX 管理员令牌身份验证 (POST /auth/loginadmin)使用BEID和Web服务密钥，而不是用户名/密码。这些是特定于API的服务帐户密钥，它们是：

不与SSO或任何用户的凭据绑定
生成于 TDAdmin>组织详细信息>API设置
可独立撤销，不影响用户帐户
任何具有“添加BE管理员”权限的管理员都可以访问

令牌在第一次工具调用时被延迟提取，并在23小时后自动刷新（24小时TDX到期前的1小时缓冲区）。

环境变量

变量	必填	描述
`TDX_BASE_URL`	是	TDX Web API基本URL（例如。 `https://yourorg.teamdynamix.com/TDWebApi/api`)
`TDX_BEID`	是	管理员来自TDAdmin
`TDX_WEB_SERVICES_KEY`	是	TDAdmin提供的Web服务密钥
`TDX_APP_ID`	是	默认TDX应用程序ID（整数）

工具（41）

在应用程序中运行的所有工具都接受可选 appId 参数覆盖默认值 TDX_APP_ID.

门票（9工具）

工具	方法	端点	描述
`tdx-ticket-create`	职位	`/{appId}/tickets`	创建新票证
`tdx-ticket-get`	得到	`/{appId}/tickets/{id}`	凭身份证买票
`tdx-ticket-update`	职位	`/{appId}/tickets/{id}`	机票的完整更新
`tdx-ticket-patch`	补丁	`/{appId}/tickets/{id}`	票的部分更新
`tdx-ticket-search`	职位	`/{appId}/tickets/search`	使用过滤器搜索门票
`tdx-ticket-feed-get`	得到	`/{appId}/tickets/{id}/feed`	获取门票评论/订阅源
`tdx-ticket-feed-add`	职位	`/{appId}/tickets/{id}/feed`	在工单上添加评论
`tdx-ticket-add-asset`	职位	`/{appId}/tickets/{id}/assets/{assetId}`	将资产链接到票证
`tdx-ticket-add-contact`	职位	`/{appId}/tickets/{id}/contacts/{uid}`	在工单中添加联系人

资产（7个工具）

工具	方法	端点	描述
`tdx-asset-create`	职位	`/{appId}/assets`	创建新资产
`tdx-asset-get`	得到	`/{appId}/assets/{id}`	按ID获取资产
`tdx-asset-update`	职位	`/{appId}/assets/{id}`	资产的完整更新
`tdx-asset-patch`	补丁	`/{appId}/assets/{id}`	资产的部分更新
`tdx-asset-delete`	删除	`/{appId}/assets/{id}`	删除资产
`tdx-asset-search`	职位	`/{appId}/assets/search`	使用筛选器搜索资产
`tdx-asset-feed-add`	职位	`/{appId}/assets/{id}/feed`	向资产添加评论

CMDB/配置项（7个工具）

工具	方法	端点	描述
`tdx-cmdb-create`	职位	`/{appId}/cmdb`	创建新CI
`tdx-cmdb-get`	得到	`/{appId}/cmdb/{id}`	按ID获取CI
`tdx-cmdb-update`	PUT	`/{appId}/cmdb/{id}`	CI的完整更新
`tdx-cmdb-delete`	删除	`/{appId}/cmdb/{id}`	删除CI
`tdx-cmdb-search`	职位	`/{appId}/cmdb/search`	使用筛选器搜索CI
`tdx-cmdb-feed-add`	职位	`/{appId}/cmdb/{id}/feed`	向CI添加注释
`tdx-cmdb-add-relationship`	PUT	`/{appId}/cmdb/{id}/relationships`	添加CI之间的关系

知识库（5个工具）

工具	方法	端点	描述
`tdx-kb-create`	职位	`/{appId}/knowledgebase`	创建知识库文章
`tdx-kb-get`	得到	`/{appId}/knowledgebase/{id}`	按ID获取知识库文章
`tdx-kb-update`	PUT	`/{appId}/knowledgebase/{id}`	更新知识库文章
`tdx-kb-delete`	删除	`/{appId}/knowledgebase/{id}`	删除知识库文章
`tdx-kb-search`	职位	`/{appId}/knowledgebase/search`	搜索知识库文章

人员（4个工具）

这些工具不需要 appId.

工具	方法	端点	描述
`tdx-people-get`	得到	`/people/{uid}`	通过UID获取人员
`tdx-people-search`	职位	`/people/search`	使用筛选器搜索人员
`tdx-people-lookup`	得到	`/people/lookup`	按姓名/电子邮件/用户名快速查找
`tdx-people-update`	职位	`/people/{uid}`	更新一个人

项目（4个工具）

这些工具不需要 appId.

工具	方法	端点	描述
`tdx-project-create`	职位	`/projects`	创建新项目
`tdx-project-get`	得到	`/projects/{id}`	按ID获取项目
`tdx-project-update`	职位	`/projects/{id}`	更新项目
`tdx-project-search`	职位	`/projects/search`	使用筛选器搜索项目

账户（2个工具）

工具	方法	端点	描述
`tdx-account-get`	得到	`/accounts/{id}`	通过ID获取帐户/部门
`tdx-account-search`	职位	`/accounts/search`	搜索帐户/部门

组（2个工具）

工具	方法	端点	描述
`tdx-group-get`	得到	`/groups/{id}`	按ID获取组
`tdx-group-search`	职位	`/groups/search`	搜索组

自定义属性（1个工具）

工具	方法	端点	描述
`tdx-attributes-get`	得到	`/attributes/custom`	获取组件类型的自定义属性定义

共同 componentId 价值观 tdx-attributes-get: 9 =门票， 27 =资产， 63 =CI， 39 =KB文章， 2 =项目。

示例用法

配置后，您可以在Claude Desktop或Claude Code中使用自然语言：

“搜索分配给我的未结门票”
“获取12345号票并向我显示评论”
查找john.doe@example.com在TDX”
“在知识库中搜索VPN设置说明”
“查找IT部门的所有资产”
“为新软件请求创建票证”

TDX API文档

项目结构

TDX-MCP/
  package.json
  tsconfig.json
  .env.example
  setup-mac.command        # macOS setup wizard
  setup-windows.bat        # Windows setup launcher
  setup-windows.ps1        # Windows setup wizard
  src/
    index.ts               # Entry point
    config.ts              # Environment variable loading
    auth.ts                # Admin token auth with auto-refresh
    tdx-client.ts          # Shared HTTP client
    tools/
      tickets.ts           # 9 ticket tools
      assets.ts            # 7 asset tools
      cmdb.ts              # 7 CMDB/CI tools
      kb.ts                # 5 knowledge base tools
      people.ts            # 4 people tools
      projects.ts          # 4 project tools
      accounts.ts          # 2 account tools
      groups.ts            # 2 group tools
      attributes.ts        # 1 custom attributes tool

由...创建蒙大拿大学IT 和克劳德