Teamdynamix MCP Server

TeamDynamix MCP服务器

一 主控程序 将AI助手连接到您的服务器 TeamDynamix 例子通过自然语言搜索和管理工单、知识库文章、人员、资产、项目、时间条目、报告、服务目录和自定义属性。

特性

• 决策树导航 --启动时仅加载2个工具；域工具按需加载
• 9个域名 --票证、知识库、人员、资产、项目、时间、报告、服务目录、属性
• 38工具 所有域的总计
• 互动启发 --当未提供ID时，提示输入票证类型、资产状态/表单、KB类别、时间类型和服务类别
• 克劳德插件 --指导工作流程的技能和命令
• 多个传输 --stdio（默认）和可流式传输HTTP

可用工具

始终加载

门票域名

知识库域

人域

资产域

项目领域

时域

报告域

服务目录域

属性域

先决条件

• Node.js 20+
• 启用API访问的TeamDynamix实例
• 管理服务帐户凭据（BEID+Web服务密钥）

查找您的凭据

1. 登录 Tdadmin 在 https://yourinstance.teamdynamix.com/TDAdmin
2. 首选 组织详情 → 安全 部分
3. 复制 Web服务BEID 和 Web服务密钥
4. 您需要“添加BE管理员”权限才能查看这些值

安装

克劳德插件市场

使用指导技能和工作流程作为Claude Code插件安装：

/plugin marketplace add chatt-state/teamdynamix-mcp-server
/plugin install teamdynamix@teamdynamix-mcp-server

设置所需的环境变量：

export TDX_BASE_URL=https://yourinstance.teamdynamix.com
export TDX_BEID=your-beid-guid
export TDX_WEB_SERVICES_KEY=your-web-services-key

克劳德桌面/克劳德代码

添加到MCP配置(claude_desktop_config.json 或 .mcp.json):

{
  "mcpServers": {
    "teamdynamix": {
      "command": "npx",
      "args": ["-y", "--registry", "https://npm.pkg.github.com", "@chatt-state/teamdynamix-mcp-server"],
      "env": {
        "TDX_BASE_URL": "https://yourinstance.teamdynamix.com",
        "TDX_BEID": "your-beid-guid",
        "TDX_WEB_SERVICES_KEY": "your-web-services-key"
      }
    }
  }
}

码头工人

docker run --rm -i \
  -e TDX_BASE_URL=https://yourinstance.teamdynamix.com \
  -e TDX_BEID=your-beid-guid \
  -e TDX_WEB_SERVICES_KEY=your-web-services-key \
  ghcr.io/chatt-state/teamdynamix-mcp-server:latest

Docker MCP网关

Docker镜像包括用于自动发现的MCP网关元数据：

docker mcp server enable teamdynamix-mcp-server \
  --image ghcr.io/chatt-state/teamdynamix-mcp-server:latest

来源

git clone https://github.com/chatt-state/teamdynamix-mcp-server.git
cd teamdynamix-mcp-server
npm install
npm run build

配置

用法

连接后，询问您的AI助手以下问题：

• “搜索有关VPN问题的未结票证”
• “查找有关密码重置的知识库文章”
• “查找分配给IT部门的所有资产”
• “为新的笔记本电脑请求创建工单”
• “显示所有活动项目”
• “根据12345号票记录2小时”
• “运行月度SLA报告”
• “在服务目录中搜索电子邮件服务”
• “列出门票的自定义属性”

助手将通过以下方式自动加载相关域工具 tdx_navigate 在执行搜索之前。

建筑

服务器使用 决策树延迟加载 图案：

1. 启动时，仅 tdx_navigate 和 tdx_status 已注册
2. 当AI呼叫时 tdx_navigate("tickets")，票证域工具动态加载
3. 服务器通过以下方式通知客户端 tools/list_changed
4. 后续调用使用新注册的域工具

这使得初始工具占用空间很小——对于工具上下文有限的LLM来说很重要。

文档

完整文档请访问

发展

npm run build      # Compile TypeScript
npm run test       # Run tests (vitest)
npm run lint       # ESLint + format checks
npm run typecheck  # TypeScript type checking

许可证

麻省理工学院