TeamDynamix MCP
@selfagency
关于 TeamDynamix MCP
🎟️ TeamDynamix MCP Server (unofficial)
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@selfagency/teamdynamix-mcp"
],
"env": {
"TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
"TEAMDYNAMIX_AUTH_MODE": "standard",
"TEAMDYNAMIX_USERNAME": "your-username",
"TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
}
}
}
}工具
11Gateway for discovery operations: server status, current user, applications, and ticket status lookup.
Gateway for ticket metadata, read/search, create/update, comments, and feed operations.
Gateway for ticket tasks, linked assets, and linked contacts operations.
Gateway for user and group retrieval/search operations.
Gateway for TeamDynamix Knowledge Base retrieval, search, and write operations.
Gateway for TeamDynamix asset retrieval, search, and lookup enumerations.
Gateway for CI/CMDB retrieval, search, types, relationship types, and vendors.
Gateway for TeamDynamix service catalog list/get/search/category operations.
Gateway for TeamDynamix projects retrieval/search and project issue/risk operations.
Gateway for TeamDynamix time type lookup and authenticated user time entries.
Gateway for TeamDynamix reference/enumeration lookups such as accounts, locations, roles, and custom attributes.
概览
What is TeamDynamix MCP?
An unofficial TypeScript Model Context Protocol (MCP) server that exposes TeamDynamix ITSM capabilities as agent-callable tools. It provides structured, safety-gated access to TeamDynamix operations for AI agents and MCP clients.
How to use TeamDynamix MCP?
Install via npm (npx -y @selfagency/teamdynamix-mcp) and configure with environment variables: TEAMDYNAMIX_BASE_URL, TEAMDYNAMIX_AUTH_MODE (standard or admin), and credentials. Then call domain gateway tools (e.g., teamdynamix_discovery, teamdynamix_tickets) with an action, payload, and response format ("markdown" or "json").
Key features of TeamDynamix MCP
- 11 domain gateway tools covering tickets, assets, KB, CMDB, and more
- Safe by default: write, delete, and admin tools disabled until opted in
- Two authentication modes: standard (username/password) and admin (BEID/WebServicesKey)
- Covers 207 API endpoints across all TeamDynamix domains
- Rate-limit aware with built-in retry and exponential backoff
- Zod-validated inputs enforce schema before any API call
Use cases of TeamDynamix MCP
- Automate ticket creation, updates, and relationship management via AI agents
- Query and manage assets, CMDB CIs, and knowledge base articles
- Retrieve people, services, projects, time entries, and reference data
- Build safety-gated ITSM workflows with destructive operations requiring explicit confirmation
FAQ from TeamDynamix MCP
What authentication modes are supported and what credentials are required?
Standard mode requires a username and password. Admin mode requires a BEID and WebServicesKey. Set TEAMDYNAMIX_AUTH_MODE accordingly.
Are write, delete, and admin tools enabled by default?
No. They are disabled by default and must be explicitly enabled via environment flags (TEAMDYNAMIX_ENABLE_WRITE_TOOLS, TEAMDYNAMIX_ENABLE_DELETE_TOOLS, TEAMDYNAMIX_ENABLE_ADMIN_TOOLS). Destructive operations also require confirm: true in the tool call.
How does the server handle rate limiting?
The SDK has built-in retry with exponential backoff on HTTP 429 and 5xx responses, making it rate-limit aware.
Where does the data live? Is data stored locally?
The server acts as a gateway to TeamDynamix’s API; no data is persisted locally beyond configuration environment variables. All operations are performed against your TeamDynamix tenant.
What transports and authentication methods are supported?
The server uses the stdio transport (MCP standard). Authentication is via the two modes described above; credentials are passed as environment variables at runtime.
评论