Skip to main content
Glama
MCP Dynamics CRM Server

MCP Dynamics CRM Server

by rafteles2016

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:

Variável

Descrição

Obrigatório

DYNAMICS_TENANT_ID

Azure AD Tenant ID

Sim

DYNAMICS_CLIENT_ID

App Registration Client ID

Sim

DYNAMICS_CLIENT_SECRET

Client Secret

Sim*

DYNAMICS_ENVIRONMENT_URL

URL do ambiente (ex: https://org.crm.dynamics.com)

Sim

DYNAMICS_USERNAME

Username (auth delegada)

Não

DYNAMICS_PASSWORD

Password (auth delegada)

Não

*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

Tool

Descrição

dynamics_generate_plugin_code

Gera código C# de plugin

dynamics_list_plugin_assemblies

Lista assemblies registrados

dynamics_list_plugin_types

Lista tipos (classes) de um assembly

dynamics_list_plugin_steps

Lista steps registrados

dynamics_register_plugin_step

Registra novo step

dynamics_toggle_plugin_step

Ativa/desativa step

dynamics_delete_plugin_step

Remove step

dynamics_get_plugin_trace_logs

Consulta logs de trace

dynamics_generate_plugin_project

Gera projeto completo

Web Resources

Tool

Descrição

dynamics_create_web_resource

Cria web resource

dynamics_update_web_resource

Atualiza conteúdo

dynamics_list_web_resources

Lista com filtros

dynamics_publish_web_resources

Publica web resources

dynamics_get_web_resource_content

Lê conteúdo decodificado

dynamics_generate_web_resource_code

Gera código template

dynamics_delete_web_resource

Remove web resource

Schema

Tool

Descrição

dynamics_create_table

Cria tabela (entidade)

dynamics_create_column

Cria coluna (atributo)

dynamics_list_tables

Lista tabelas

dynamics_list_columns

Lista colunas

dynamics_get_forms

Recupera formulários

dynamics_update_form

Atualiza formulário

dynamics_get_views

Recupera views

dynamics_create_view

Cria view

dynamics_update_column

Atualiza coluna

dynamics_delete_column

Remove coluna

dynamics_create_relationship

Cria relacionamento

dynamics_publish_customizations

Publica customizações

dynamics_generate_fetchxml

Gera FetchXML

Soluções

Tool

Descrição

dynamics_create_solution

Cria solução

dynamics_list_solutions

Lista soluções

dynamics_add_solution_component

Adiciona componente

dynamics_remove_solution_component

Remove componente

dynamics_list_solution_components

Lista componentes

dynamics_export_solution

Exporta solução

dynamics_import_solution

Importa solução

dynamics_get_import_job_status

Status de importação

dynamics_clone_solution

Clona/patch solução

dynamics_list_publishers

Lista publicadores

dynamics_create_publisher

Cria publicador

dynamics_delete_solution

Remove solução

dynamics_check_solution_dependencies

Verifica dependências

Telemetria

Tool

Descrição

dynamics_get_plugin_performance

Performance de plugins

dynamics_get_workflow_performance

Performance de workflows

dynamics_get_active_processes

Processos ativos

dynamics_get_system_jobs

Jobs do sistema

dynamics_get_entity_analytics

Análise por entidade

dynamics_get_audit_history

Histórico de auditoria

dynamics_get_slow_plugins

Plugins lentos

dynamics_get_bulk_operations

Operações em massa

dynamics_system_health

Dashboard de saúde

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

Available Tools

51 tools
dynamics_add_solution_componentC

Adiciona um componente a uma solução

Inputs: solutionUniqueName (required), componentId (required), componentType (required), addRequiredComponents, +1 more.

dynamics_check_solution_dependenciesB

Verifica dependências de uma solução antes de remover

Inputs: solutionUniqueName (required).

dynamics_clone_solutionC

Cria um clone/patch de uma solução com nova versão

Inputs: solutionUniqueName (required), versionNumber (required).

dynamics_create_columnC

Cria uma nova coluna (campo/atributo) em uma tabela do Dynamics CRM

Inputs: entityLogicalName (required), schemaName (required), displayName (required), attributeType (required), +9 more.

dynamics_create_publisherC

Cria um novo publicador de soluções

Inputs: uniqueName (required), friendlyName (required), customizationPrefix (required), customizationOptionValuePrefix (required), +1 more.

dynamics_create_relationshipC

Cria um relacionamento entre duas tabelas

Inputs: schemaName (required), referencingEntity (required), referencedEntity (required), referencingAttribute (required), +4 more.

dynamics_create_solutionC

Cria uma nova solução no Dynamics CRM

Inputs: uniqueName (required), displayName (required), publisherId (required), version, +1 more.

dynamics_create_tableC

Cria uma nova tabela (entidade) no Dynamics CRM

Inputs: schemaName (required), displayName (required), displayCollectionName (required), description, +6 more.

dynamics_create_viewC

Cria uma nova view para uma entidade

Inputs: entityLogicalName (required), name (required), fetchXml (required), layoutXml (required), +2 more.

dynamics_create_web_resourceC

Cria um novo web resource no Dynamics CRM

Inputs: name (required), displayName (required), type (required), content, +3 more.

dynamics_delete_columnC

Remove uma coluna de uma tabela

Inputs: entityLogicalName (required), attributeLogicalName (required).

dynamics_delete_plugin_stepC

Remove um step de plugin registrado

Inputs: stepId (required).

dynamics_delete_solutionC

Remove uma solução unmanaged do Dynamics CRM

Inputs: solutionUniqueName (required).

dynamics_delete_web_resourceC

Remove um web resource do Dynamics CRM

Inputs: webResourceId (required).

dynamics_export_solutionC

Exporta uma solução do Dynamics CRM (retorna Base64 do ZIP)

Inputs: solutionUniqueName (required), managed, exportAutoNumberingSettings, exportCalendarSettings, +8 more.

dynamics_generate_fetchxmlC

Gera FetchXML com base em parâmetros estruturados

Inputs: entityLogicalName (required), columns (required), filters, orders, +2 more.

dynamics_generate_plugin_codeC

Gera código C# para um plugin do Dynamics CRM com base nos parâmetros fornecidos

Inputs: name (required), entityLogicalName (required), message (required), stage (required), +4 more.

dynamics_generate_plugin_projectC

Gera a estrutura completa de um projeto de plugin C# (.csproj, classes, etc.)

Inputs: projectName (required), namespace (required), plugins (required).

dynamics_generate_web_resource_codeC

Gera código template para web resources (JS/HTML/CSS) com helpers do Dynamics

Inputs: name (required), type (required), entityLogicalName, formType, +2 more.

dynamics_get_active_processesC

Lista processos ativos (workflows, actions, BPFs) e seus estados

Inputs: processType, stateFilter.

dynamics_get_audit_historyC

Consulta histórico de auditoria do sistema

Inputs: entityLogicalName, userId, top, operation.

dynamics_get_bulk_operationsC

Monitora operações em massa (bulk delete, imports, etc.)

Inputs: top.

dynamics_get_entity_analyticsC

Analisa métricas de uma entidade (total de registros, usage, etc.)

Inputs: entityLogicalName (required).

dynamics_get_formsC

Recupera formulários de uma entidade

Inputs: entityLogicalName (required), formType, formId.

dynamics_get_import_job_statusC

Verifica o status de uma importação de solução

Inputs: importJobId (required).

dynamics_get_plugin_performanceC

Analisa performance de execução de plugins (duração, erros, frequência)

Inputs: top, minDuration, entityLogicalName.

dynamics_get_plugin_trace_logsC

Recupera logs de rastreamento de plugins para diagnóstico

Inputs: pluginTypeName, top, correlationId.

dynamics_get_slow_pluginsC

Identifica plugins que estão tornando o sistema lento

Inputs: top, minDurationMs.

dynamics_get_system_jobsC

Monitora jobs do sistema (importações, bulk deletes, workflows, etc.)

Inputs: statusFilter, top, operationType.

dynamics_get_viewsC

Recupera views de uma entidade

Inputs: entityLogicalName (required), viewType, viewId.

dynamics_get_web_resource_contentB

Recupera o conteúdo de um web resource (decodificado de Base64)

Inputs: webResourceId (required).

dynamics_get_workflow_performanceC

Analisa performance e status de workflows e processos automáticos

Inputs: top, statusFilter.

dynamics_import_solutionC

Importa uma solução para o Dynamics CRM

Inputs: customizationFile (required), overwriteUnmanagedCustomizations, publishWorkflows, importJobId.

dynamics_list_columnsC

Lista colunas (atributos) de uma tabela

Inputs: entityLogicalName (required), customOnly.

dynamics_list_plugin_assembliesC

Lista os assemblies de plugins registrados no Dynamics CRM

Inputs: assemblyName, entityLogicalName.

dynamics_list_plugin_stepsB

Lista os steps registrados para plugins, opcionalmente filtrados por entidade

Inputs: entityLogicalName, pluginTypeId.

dynamics_list_plugin_typesC

Lista os tipos de plugins (classes) de um assembly

Inputs: assemblyId (required).

dynamics_list_publishersC

Lista publicadores disponíveis

Inputs: customOnly.

dynamics_list_solution_componentsC

Lista componentes de uma solução

Inputs: solutionUniqueName (required), componentType.

dynamics_list_solutionsC

Lista soluções instaladas no Dynamics CRM

Inputs: managedOnly, unmanagedOnly, nameFilter, top.

dynamics_list_tablesC

Lista tabelas (entidades) do Dynamics CRM

Inputs: filter, customOnly, top.

dynamics_list_web_resourcesC

Lista web resources com filtros opcionais

Inputs: nameFilter, type, solutionId, top.

dynamics_publish_customizationsC

Publica todas as customizações ou customizações de uma entidade específica

Inputs: entityLogicalName.

dynamics_publish_web_resourcesC

Publica web resources para torná-los disponíveis no sistema

Inputs: webResourceIds (required).

dynamics_register_plugin_stepC

Registra um novo step de plugin no Dynamics CRM

Inputs: pluginTypeId (required), message (required), entityLogicalName (required), stage (required), +4 more.

dynamics_remove_solution_componentC

Remove um componente de uma solução

Inputs: solutionUniqueName (required), componentId (required), componentType (required).

dynamics_system_healthC

Painel de saúde geral do sistema - visão consolidada de performance

Inputs: timeRange.

dynamics_toggle_plugin_stepC

Ativa ou desativa um step de plugin

Inputs: stepId (required), enabled (required).

dynamics_update_columnC

Atualiza propriedades de uma coluna existente

Inputs: entityLogicalName (required), attributeLogicalName (required), displayName, description, +2 more.

dynamics_update_formC

Atualiza o XML de um formulário

Inputs: formId (required), formXml (required).

dynamics_update_web_resourceC

Atualiza o conteúdo de um web resource existente

Inputs: webResourceId (required), content (required), description.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 51 tools

    Disambiguation4/5

    Most tools have distinct purposes with clear boundaries, such as dynamics_create_table versus dynamics_create_column, or dynamics_get_plugin_performance versus dynamics_get_slow_plugins. However, some overlap exists in monitoring tools like dynamics_get_system_jobs and dynamics_get_bulk_operations, which could cause minor confusion in selection.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a 'dynamics_' prefix and clear verb_noun structure, such as dynamics_create_solution, dynamics_list_tables, and dynamics_update_column. This predictability makes it easy for agents to understand and use the tools effectively.

    Tool Count2/5

    With 51 tools, the count is excessive for a single server, leading to potential overwhelm and inefficiency. While the domain is broad, this many tools suggests poor scoping and could hinder agent performance due to complexity and decision fatigue.

    Completeness5/5

    The tool set provides comprehensive coverage for Dynamics CRM management, including CRUD operations for solutions, tables, columns, web resources, and plugins, along with monitoring, analytics, and system health tools. No significant gaps are apparent, supporting full lifecycle management.

    Related MCP Connectors