Dynamics 365 MCP 서버

Dynamics 365 MCP 서버 🚀

노드.js 타입스크립트 엠씨피

개요

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 도구를 호출하여 프롬프트를 테스트해 보겠습니다.

6. (선택 사항) MCP Interceptor를 사용한 테스트 도구

터미널에서 다음 명령을 실행하세요

npx @modelcontextprotocol/inspector node build/index.js

인터셉터 커맨드

🔍 http://localhost:5173 🚀으로 이동하세요
이제 서버에 연결하여 모든 도구를 테스트할 수 있습니다!!

디버깅 🐛

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

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

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

기여하기 🤝

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

기여하려면:

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

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

Claude Desktop이 Microsoft Dynamics 365와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 사용자는 자연어로 정보를 검색하고, 계정을 만들고 업데이트하고, 기회를 관리할 수 있습니다.

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