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 の**Model Context Protocol (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. リポジトリのクローンを作成する

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をインストールする
設定 > 開発者 > 設定の編集に移動します
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デスクトップを再起動します
これで、プロンプトウィンドウにサーバーツールが表示されるはずです。
ツール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