Servidor Dynamics 365 MCP

Servidor Dynamics 365 MCP 🚀

Node.js Mecanografiado MCP Licencia

Descripción general

El servidor MCP de Microsoft Dynamics 365 proporciona herramientas para interactuar con Microsoft Dynamics 365 mediante el Protocolo de Contexto de Modelo (MCP) de Anthorpic. Permite a los usuarios realizar diversas operaciones, como recuperar información de usuarios, cuentas y oportunidades asociadas a una cuenta, así como crear y actualizar cuentas desde Claude Desktop .

Este proyecto utiliza la biblioteca @modelcontextprotocol/sdk para implementar el servidor y las herramientas de MCP, y se integra con las API de Dynamics 365 para operaciones de datos.

Lista de herramientas 🛠️

Nombre de la herramienta	Descripción	Aporte	Producción
`get-user-info`	Obtiene información sobre el usuario autenticado actualmente.	Ninguno	Detalles del usuario, incluido nombre, ID de usuario e ID de unidad comercial.
`fetch-accounts`	Obtiene todas las cuentas de Dynamics 365.	Ninguno	Listado de cuentas en formato JSON.
`get-associated-opportunities`	Obtiene oportunidades asociadas con una cuenta determinada.	`accountId` (cadena, obligatoria)	Listado de oportunidades en formato JSON.
`create-account`	Crea una nueva cuenta en Dynamics 365.	`accountData` (objeto, obligatorio) que contiene detalles de la cuenta.	Detalles de la cuenta creada en formato JSON.
`update-account`	Actualiza una cuenta existente en Dynamics 365.	`accountId` (cadena, obligatorio), `accountData` (objeto, obligatorio) que contiene detalles actualizados.	Detalles de la cuenta actualizada en formato JSON.

Prerrequisitos 📝

Antes de configurar el proyecto, asegúrese de tener instalado lo siguiente:

Node.js (v16 o superior)
NPM (Administrador de paquetes de nodos)
Una instancia de Dynamics 365 con acceso a API
Aplicación de Azure Active Directory (AAD) configurada para el acceso a la API de Dynamics 365

Pasos de configuración ⚙️

Siga estos pasos para configurar y ejecutar el proyecto localmente:

1. Clonar el repositorio

git clone https://github.com/your-repo/dynamics365-mcp-server.git
cd dynamics365-mcp-server

2. Instalar dependencias

npm install

3. Configurar variables de entorno

Cree un archivo .env en la raíz del proyecto y agregue las siguientes variables:

CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
TENANT_ID=your-tenant-id
D365_URL=https://your-org.crm.dynamics.com

4. Compilar archivos TypeScript

npm run build

4. Ejecutar el servidor MCP

node build\index.js

Debería ver el siguiente resultado:

Dynamics365 MCP server running on stdio...

5. (Opcional) Registre su servidor MCP con Claude Desktop

Instalar Claude Desktop
Vaya a Configuración > Desarrollador > Editar configuración
Editar claude_desktop_config.json

{
    "mcpServers": {
        "Dynamics365": {
            "command": "node",
            "args": [
                "<Path to your MCP server build file ex: rootfolder/build/index.js>"
            ],
            "env": {
                "CLIENT_ID": "<D365 Client Id>",
                "CLIENT_SECRET": "<D365 Client Secret>",
                "TENANT_ID": "<D365 Tenant ID>",
                "D365_URL": "Dynamics 365 url"
            }
        }
    }
}

Reiniciar Claude Desktop
Ahora debería poder ver las herramientas del servidor en la ventana de solicitud.
Probemos un mensaje invocando la herramienta: get-user-info

6. (Opcional) Herramientas de prueba usando MCP Interceptor

Ejecute el siguiente comando en la terminal

npx @modelcontextprotocol/inspector node build/index.js

Comando del interceptor

Vaya a 🔍 http://localhost:5173 🚀
¡Ahora puedes conectarte al servidor y probar todas las herramientas!

Depuración 🐛

Si encuentra problemas, asegúrese de lo siguiente:

El archivo .env está configurado correctamente.
La aplicación Azure AD tiene los permisos necesarios para las API de Dynamics 365.
Se puede acceder a la instancia de Dynamics 365 desde: su entorno.
También puedes agregar registros de depuración al código para rastrear problemas. Por ejemplo:

console.error("Debugging: Loaded environment variables:", process.env);

Contribuyendo 🤝

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios o abrir un problema para solucionar cualquier error o solicitud de funcionalidad.

Para contribuir:

Bifurcar el repositorio.
Crea una nueva rama para tu característica o corrección de error.
Confirme sus cambios y envíe una solicitud de extracción.
¡Agradecemos tus contribuciones! 😊

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que permite a Claude Desktop interactuar con Microsoft Dynamics 365, permitiendo a los usuarios recuperar información, crear y actualizar cuentas y administrar oportunidades a través del lenguaje natural.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Linear MCP Server
cpropster
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
Last updated -
13
1
TypeScript
MIT License
ConnectWise Manage MCP Server
ethangillani
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
Last updated -
JavaScript
MIT License
Zulip MCP Server
Monadical-SAS
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
Last updated -
JavaScript
Apache 2.0
Claude Document MCP Server
alejandroBallesterosC
-
security
F
license
-
quality
A Model Context Protocol server that allows Claude Desktop to perform document operations on Microsoft Word, Excel, and PDF files including creation, editing, and format conversion.
Last updated -
9
Python

View all related MCP servers

Dynamics 365 MCP Server