local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Manages environment configuration for Dynamics 365 connection credentials including client ID, client secret, tenant ID, and service URL.
Provides version control for the codebase, allowing collaborative development through clone, branch, and pull request operations.
Hosts the repository for the MCP server code, enabling collaborative development and issue tracking.

Dynamics 365 MCP 서버 🚀

개요

Microsoft Dynamics 365 MCP 서버는 Anthorpic의 모델 컨텍스트 프로토콜(MCP)을 사용하여 Microsoft Dynamics 365와 상호 작용할 수 있는 도구를 제공하는 MCP 서버입니다. 사용자는 Claude Desktop 에서 사용자 정보, 계정, 계정과 관련된 영업 기회 검색, 계정 생성 및 업데이트 등 다양한 작업을 수행할 수 있습니다.

이 프로젝트에서는 @modelcontextprotocol/sdk 라이브러리를 사용하여 MCP 서버와 도구를 구현하고, 데이터 작업을 위해 Dynamics 365 API와 통합합니다.

도구 목록 🛠️

도구 이름	설명	입력	산출
`get-user-info`	현재 인증된 사용자에 대한 정보를 가져옵니다.	없음	이름, 사용자 ID, 사업부 ID를 포함한 사용자 세부 정보입니다.
`fetch-accounts`	Dynamics 365에서 모든 계정을 가져옵니다.	없음	JSON 형식의 계정 목록입니다.
`get-associated-opportunities`	지정된 계정과 관련된 기회를 가져옵니다.	`accountId` (문자열, 필수)	JSON 형식의 기회 목록입니다.
`create-account`	Dynamics 365에 새 계정을 만듭니다.	계정 세부 정보가 포함된 `accountData` (객체, 필수)	JSON 형식으로 생성된 계정의 세부정보입니다.
`update-account`	Dynamics 365에서 기존 계정을 업데이트합니다.	`accountId` (문자열, 필수), 업데이트된 세부 정보가 포함된 `accountData` (객체, 필수).	JSON 형식으로 업데이트된 계정의 세부정보입니다.

필수 조건 📝

프로젝트를 설정하기 전에 다음 사항이 설치되어 있는지 확인하세요.

Node.js (v16 이상)
NPM (노드 패키지 관리자)
API 액세스가 가능한 Dynamics 365 인스턴스
Dynamics 365 API 액세스를 위해 구성된 Azure Active Directory(AAD) 애플리케이션

구성 단계 ⚙️

프로젝트를 로컬로 설정하고 실행하려면 다음 단계를 따르세요.

1. 저장소 복제

지엑스피1

2. 종속성 설치

npm install

3. 환경 변수 구성

프로젝트 루트에 .env 파일을 만들고 다음 변수를 추가합니다.

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

4. TypeScript 파일 컴파일

npm run build

4. MCP 서버 실행

node build\index.js

다음과 같은 출력이 표시됩니다.

Dynamics365 MCP server running on stdio...

5. (선택 사항) Claude Desktop에 MCP 서버 등록

Claude Desktop 설치
설정 > 개발자 > 구성 편집으로 이동합니다.
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"
            }
        }
    }
}

Claude Desktop을 다시 시작하세요
이제 프롬프트 창에서 서버 도구를 볼 수 있어야 합니다.
get-user-info 도구를 호출하여 프롬프트를 테스트해 보겠습니다.

디버깅 🐛

문제가 발생하면 다음 사항을 확인하세요.

.env 파일이 올바르게 구성되었습니다.
Azure AD 애플리케이션에는 Dynamics 365 API에 필요한 권한이 있습니다.
Dynamics 365 인스턴스는 다음 환경에서 액세스할 수 있습니다.
코드에 디버그 로그를 추가하여 문제를 추적할 수도 있습니다. 예:

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

기여하기 🤝

기여를 환영합니다! 버그나 기능 요청이 있으시면 언제든지 풀 리퀘스트를 제출하거나 이슈를 열어주세요.

기여하려면:

저장소를 포크합니다.
기능이나 버그 수정을 위해 새로운 브랜치를 만듭니다.
변경 사항을 커밋하고 풀 리퀘스트를 제출하세요.
귀하의 기여에 감사드립니다! 😊

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

MCP 클라이언트(예: Claude Desktop)에서 Microsoft Dynamics 365/Power Platform과의 상호 작용을 지원하는 모델 컨텍스트 프로토콜 서버로, 사용자가 자연어를 통해 데이터를 검색, 생성 및 업데이트할 수 있도록 지원합니다.

Dynamics 365 MCP Server