Dynamics 365 MCP Server 🚀

Dynamics 365 MCP サーバー 🚀

概要

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

このプロジェクトでは、MCP サーバーとツールの実装に @modelcontextprotocol/sdk ライブラリを使用し、データ操作のために 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（Node Package Manager）
• 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. （任意）MCP サーバーを Claude Desktop に登録する

• Claude Desktop をインストールする
• Settings > Developer > Edit Config に移動する
• 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);

コントリビューション 🤝

コントリビューションを歓迎します！バグや機能リクエストがあれば、プルリクエストを送信するか、Issue を作成してください。

コントリビューションの手順：

• リポジトリをフォークします。
• 機能追加またはバグ修正用の新しいブランチを作成します。
• 変更をコミットし、プルリクエストを送信します。
• コントリビューションに感謝します！ 😊