MCP Dynamics CRM Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Dynamics CRM Server Generate a C# plugin to update contact status when an account is deactivated"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Node.js >= 18
Azure AD App Registration com permissões para Dynamics 365:
user_impersonationno Dynamics CRM (delegated) ouApplication permissions configuradas
Variáveis de Ambiente
cp .env.example .envConfigure no .env:
Variável | Descrição | Obrigatório |
| Azure AD Tenant ID | Sim |
| App Registration Client ID | Sim |
| Client Secret | Sim* |
| URL do ambiente (ex: | Sim |
| Username (auth delegada) | Não |
| Password (auth delegada) | Não |
*Obrigatório para autenticação app-only (recomendado).
Instalação
npm install
npm run buildUso 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 |
| Gera código C# de plugin |
| Lista assemblies registrados |
| Lista tipos (classes) de um assembly |
| Lista steps registrados |
| Registra novo step |
| Ativa/desativa step |
| Remove step |
| Consulta logs de trace |
| Gera projeto completo |
Web Resources
Tool | Descrição |
| Cria web resource |
| Atualiza conteúdo |
| Lista com filtros |
| Publica web resources |
| Lê conteúdo decodificado |
| Gera código template |
| Remove web resource |
Schema
Tool | Descrição |
| Cria tabela (entidade) |
| Cria coluna (atributo) |
| Lista tabelas |
| Lista colunas |
| Recupera formulários |
| Atualiza formulário |
| Recupera views |
| Cria view |
| Atualiza coluna |
| Remove coluna |
| Cria relacionamento |
| Publica customizações |
| Gera FetchXML |
Soluções
Tool | Descrição |
| Cria solução |
| Lista soluções |
| Adiciona componente |
| Remove componente |
| Lista componentes |
| Exporta solução |
| Importa solução |
| Status de importação |
| Clona/patch solução |
| Lista publicadores |
| Cria publicador |
| Remove solução |
| Verifica dependências |
Telemetria
Tool | Descrição |
| Performance de plugins |
| Performance de workflows |
| Processos ativos |
| Jobs do sistema |
| Análise por entidade |
| Histórico de auditoria |
| Plugins lentos |
| Operações em massa |
| 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 toolsdynamics_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
Scored across 51 tools
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.
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.
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.
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
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.