Servidor Dynamics 365 MCP 🚀

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

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! 😊

Dynamics 365 MCP Server

Integrations