teamdynamix-mcp

Servidor MCP de TeamDynamix (no oficial)

Ver en self.agency

Documentación

En este tutorial, configurarás teamdynamix-mcp en un cliente MCP, te conectarás usando el paquete publicado y verificarás la conectividad con herramientas de solo lectura.

Si deseas ejecutar desde el código fuente como colaborador, usa la guía de desarrollo: docs/development/contributing.md.

Requisitos previos

  • Node.js 20+
  • Un cliente MCP (por ejemplo: VS Code o Claude Desktop)
  • Credenciales de TeamDynamix

Paso 1: agregar configuración del servidor

Agrega una entrada de servidor TeamDynamix a la configuración de tu cliente MCP:

  • command: npx
  • args: -y, @selfagency/teamdynamix-mcp
  • env:
    • TEAMDYNAMIX_BASE_URL
      • TEAMDYNAMIX_AUTH_MODE
      • modo estándar: TEAMDYNAMIX_USERNAME, TEAMDYNAMIX_PASSWORD
      • modo administrador: TEAMDYNAMIX_BEID, TEAMDYNAMIX_WEB_SERVICES_KEY

Paso 2: inicia tu cliente MCP

Inicia o recarga tu cliente MCP para que lance el servidor MCP de TeamDynamix.

Esperado: tu cliente muestra un servidor TeamDynamix activo usando transporte stdio.

Paso 3: verifica la conectividad de las herramientas

Llama a estas herramientas en orden:

  1. teamdynamix_server_status — confirma que las credenciales y la URL base están configuradas
  2. teamdynamix_get_current_user — devuelve tu registro de usuario autenticado
  3. teamdynamix_list_applications — lista las aplicaciones de TeamDynamix accesibles

Esperado: las respuestas llegan sin errores, y teamdynamix_server_status muestra configured: true.

Paso 4: verifica un ID de aplicación de tickets

Llama a teamdynamix_list_applications, elige la aplicación de tickets, luego llama a:

  • teamdynamix_list_ticket_statuses con app_id

Si esto funciona, tu entorno base está listo para flujos de trabajo de tickets y KB.

Siguiente tutorial