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.

Related MCP server: Dataverse MCP Server

Lista de herramientas 🛠️

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

• 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:

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