MCP Dynamics CRM Server

MCP Dynamics CRM Server

Servidor MCP (Model Context Protocol) para automação do Microsoft Dynamics CRM e Power Platform.

Funcionalidades

1. Plugins (C#)

• Geração de código C# para plugins com templates profissionais
• Registro e gerenciamento de steps de plugins
• Listagem de assemblies, tipos e steps
• Ativar/desativar steps
• Consulta de trace logs para diagnóstico
• Geração de projetos completos (.csproj + classes)

2. Web Resources

• Criação de web resources (JS, HTML, CSS, imagens, etc.)
• Templates com helpers para formulários Dynamics
• Atualização de conteúdo
• Publicação de web resources
• Leitura de conteúdo (decodificação Base64)

3. Schema (Tabelas, Campos, Formulários, Views)

• Criação de tabelas (entidades) customizadas
• Criação de colunas com todos os tipos suportados
• Gerenciamento de formulários (leitura e atualização de FormXML)
• Criação e listagem de views (system e personal)
• Criação de relacionamentos (1:N e N:N)
• Geração de FetchXML
• Publicação de customizações

4. Gestão de Soluções

• Criação de soluções e publicadores
• Adicionar/remover componentes
• Exportação (managed/unmanaged)
• Importação com acompanhamento de status
• Clone/patch de soluções
• Verificação de dependências

5. Telemetria e Performance

• Dashboard de saúde do sistema
• Análise de performance de plugins
• Identificação de plugins lentos
• Monitoramento de workflows e processos
• Análise por entidade
• Histórico de auditoria
• Monitoramento de system jobs
• Operações em massa

Configuração

Pré-requisitos

1. Node.js >= 18
2. Azure AD App Registration com permissões para Dynamics 365:
   • user_impersonation no Dynamics CRM (delegated) ou
   • Application permissions configuradas

Variáveis de Ambiente

cp .env.example .env

Configure no .env:

*Obrigatório para autenticação app-only (recomendado).

Instalação

npm install
npm run build

Uso com Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "dynamics-crm": {
      "command": "node",
      "args": ["/caminho/para/mcp-dynamics-crm/dist/index.js"],
      "env": {
        "DYNAMICS_TENANT_ID": "seu-tenant-id",
        "DYNAMICS_CLIENT_ID": "seu-client-id",
        "DYNAMICS_CLIENT_SECRET": "seu-client-secret",
        "DYNAMICS_ENVIRONMENT_URL": "https://seuorg.crm.dynamics.com"
      }
    }
  }
}

Uso com Claude Code

{
  "mcpServers": {
    "dynamics-crm": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/caminho/para/mcp-dynamics-crm",
      "env": {
        "DYNAMICS_TENANT_ID": "seu-tenant-id",
        "DYNAMICS_CLIENT_ID": "seu-client-id",
        "DYNAMICS_CLIENT_SECRET": "seu-client-secret",
        "DYNAMICS_ENVIRONMENT_URL": "https://seuorg.crm.dynamics.com"
      }
    }
  }
}

Tools Disponíveis

Plugins

Web Resources

Schema

Soluções

Telemetria

Exemplos de Uso

Criar um plugin

"Crie um plugin PreOperation para validar o campo email na entidade contact"

Criar uma tabela com campos

"Crie uma tabela new_projeto com campos nome, data_inicio (DateTime), status (Picklist com Aberto/Em Andamento/Concluído) e valor (Money)"

Verificar saúde do sistema

"Mostre o dashboard de saúde do sistema e identifique plugins lentos"

Gerenciar soluções

"Liste as soluções unmanaged e exporte a solução MinhaSolucao"

Licença

MIT