teamdynamix-mcp

Servidor MCP TeamDynamix (não oficial)

Ver em self.agency

Documentação

Neste tutorial, você configurará teamdynamix-mcp em um cliente MCP, conectará usando o pacote publicado e verificará a conectividade com ferramentas somente leitura.

Se você quiser executar a partir do código-fonte como contribuidor, use o guia de desenvolvimento: docs/development/contributing.md.

Pré-requisitos

  • Node.js 20+
  • Um cliente MCP (por exemplo: VS Code ou Claude Desktop)
  • Credenciais do TeamDynamix

Etapa 1: adicionar configuração do servidor

Adicione uma entrada de servidor TeamDynamix à configuração do seu cliente MCP:

  • comando: npx
  • argumentos: -y, @selfagency/teamdynamix-mcp
  • env:
    • TEAMDYNAMIX_BASE_URL
      • TEAMDYNAMIX_AUTH_MODE
      • modo padrão: TEAMDYNAMIX_USERNAME, TEAMDYNAMIX_PASSWORD
      • modo administrador: TEAMDYNAMIX_BEID, TEAMDYNAMIX_WEB_SERVICES_KEY

Etapa 2: iniciar seu cliente MCP

Inicie ou recarregue seu cliente MCP para que ele inicie o servidor MCP do TeamDynamix.

Esperado: seu cliente mostra um servidor TeamDynamix ativo usando transporte stdio.

Etapa 3: verificar conectividade das ferramentas

Chame estas ferramentas em ordem:

  1. teamdynamix_server_status — confirma que as credenciais e a URL base estão configuradas
  2. teamdynamix_get_current_user — retorna seu registro de usuário autenticado
  3. teamdynamix_list_applications — lista os aplicativos TeamDynamix acessíveis

Esperado: as respostas chegam sem erros, e teamdynamix_server_status mostra configured: true.

Etapa 4: verificar um ID de aplicativo de chamado

Chame teamdynamix_list_applications, selecione o aplicativo de chamados e depois chame:

  • teamdynamix_list_ticket_statuses com app_id

Se isso funcionar, seu ambiente de base está pronto para fluxos de trabalho de chamados e base de conhecimento.

Próximo tutorial