Dynamics 365 MCP サーバー 🚀

Node.js タイプスクリプト MCP ライセンス

概要

Microsoft Dynamics 365 MCP サーバーは、Anthorpic の**Model Context Protocol (MCP)**を使用して Microsoft Dynamics 365 と連携するためのツールを提供する MCP サーバーです。ユーザーは、 Claude Desktopからユーザー情報、アカウント、アカウントに関連付けられた商談の取得、アカウントの作成と更新など、さまざまな操作を実行できます。

このプロジェクトでは@modelcontextprotocol/sdkライブラリを使用して MCP サーバーとツールを実装し、データ操作のために Dynamics 365 API と統合します。

Related MCP server: Calculator MCP Server

ツールのリスト 🛠️

ツール名	説明	入力	出力
`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. リポジトリのクローンを作成する

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

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" } } } }