Dynamic365 CRM MCP Server

Solyn_dynamics365_mcp_server

概要

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

Solyn.AI は、企業のインテリジェントな変革を支援する、生成AIサービス（AIGS）向けのAIネイティブなアプリケーションプラットフォームです。このプラットフォームは数千億規模の大規模モデルを基盤とし、さまざまな業界やアプリケーションシナリオのお客様に多様な開発方法を提供することで、大規模モデル時代に適応したAIネイティブ製品を作成できるようにします。 Solyn.AI は、数百種類のモデルのサポート、使いやすいプロンプト作成インターフェース、高性能なRAG（検索拡張生成）エンジン、柔軟に構成できるインテリジェントエージェントフレームワークなど、AIネイティブアプリケーションの構築に必要なコア技術を統合しています。さらに、Solyn は使いやすいモバイルソリューションも提供しており、お客様がイノベーションやビジネスニーズへの対応により注力できるようにすることで、企業の発展と成長を促進します。

詳しくはこちら：www.solyn.ai

ツール一覧 🛠️

ツール名	説明	入力	出力
create_lead	Dynamics CRM に新しい見込み顧客レコードを作成します	subject (string, 必須), lastname (string, 必須), [その他の省略可能なフィールド：firstname, jobtitle, mobilephone, emailaddress1, companyname など]	作成された見込み顧客の詳細（JSON 形式）
get_all_leads	すべての見込み顧客の一覧を取得します	top (integer, 省略可能、デフォルト1000)	見込み顧客の一覧（JSON 形式）
get_all_activities	現在のアカウントのすべての顧客アクティビティを取得します	top (integer, 省略可能、デフォルト100、範囲1-1000)	顧客アクティビティの一覧（JSON 形式）
create_contact	新しい連絡先レコードを作成します	lastname (string, 必須), [その他の省略可能なフィールド：firstname, emailaddress1, telephone1, jobtitle などの住所情報]	作成された連絡先の詳細（JSON 形式）
get_all_contacts	連絡先情報を取得します	top (integer, 省略可能、デフォルト1000)	連絡先の一覧（JSON 形式）
create_account	新しい顧客（会社）レコードを作成します	name (string, 必須), [その他の省略可能なフィールド：primarycontactid, industrycode, revenue, telephone1, websiteurl などの会社情報]	作成された顧客の詳細（JSON 形式）
find_entity_id	条件に基づいてエンティティ ID を検索します	entity_name (string, 必須、列挙値：contacts/accounts/leads), search_criteria (object, 必須), exact_match (boolean, 省略可能、デフォルトFalse)	一致するエンティティ ID の一覧（JSON 形式）
get_all_campaigns	現在のアカウントで実行中のキャンペーンを検索します	top (integer, 省略可能、デフォルト1000)	キャンペーンの一覧（JSON 形式）
create_appointment	新しい訪問記録を作成します	subject (string, 必須), scheduledstart (date-time, 必須), scheduledend (date-time, 必須), [その他の省略可能なフィールド：location, description, 関連 ID など]	作成された訪問記録の詳細（JSON 形式）
get_all_accounts	顧客情報を取得します	top (integer, 省略可能、デフォルト1000)	顧客の一覧（JSON 形式）
create_opportunity	新しい商談（プロジェクト）を作成します	name (string, 必須), budgetamount (number, 必須), [その他の省略可能なフィールド：parentcontactid, description]	作成された商談の詳細（JSON 形式）
get_all_opportunities	商談に関連付けられた製品の一覧を取得します	top (integer, 省略可能、デフォルト1000)	商談製品の一覧（JSON 形式）
create_sales_order	新しい注文を作成します	name (string, 必須), customerid (string, 必須), [省略可能なフィールド：description]	作成された注文の詳細（JSON 形式）
get_all_sales_orders	注文明細項目を取得します	top (integer, 省略可能、デフォルト1000)	注文の一覧（JSON 形式）
create_incident	新しいサービスケースを作成します	title (string, 必須), customerid (string, 必須), [省略可能なフィールド：description]	作成されたサービスケースの詳細（JSON 形式）
get_all_incidents	現在のアカウントのすべてのサービスケースを取得します	top (integer, 省略可能、デフォルト1000)	サービスケースの一覧（JSON 形式）
get_all_products	すべての製品情報を取得します	filter (string, 省略可能、OData 形式), top (integer, 省略可能、デフォルト1000)	製品の一覧（JSON 形式）
get_all_product_pricelevels	価格表項目（価格体系）を取得します	top (integer, 省略可能、デフォルト1000)	価格表項目の一覧（JSON 形式）
get_all_emails	現在のアカウントのメール記録を取得します	top (integer, 省略可能、デフォルト1000)	メール記録の一覧（JSON 形式）
query_entity	汎用エンティティ検索メソッド	entity_name (string, 必須), [省略可能なパラメーター：filter (OData 形式), select, expand, top, orderby]	検索結果セット（JSON 形式）

Dynamics 365 MCP サーバーの統合

前提条件 📝

プロジェクトをセットアップする前に、以下が揃っていることを確認してください。

• Python 3.10 以降
• API 権限を持つ Dynamics 365 インスタンスへのアクセス
• Dynamics 365 API へのアクセスが設定された Azure Active Directory (AAD) アプリケーション
  • アプリケーションには以下の権限が必要です。
    • Dynamics CRM user_impersonation
    • Office 365 Exchange Online

セットアップとインストール ⚙️

1. リポジトリをクローンする

git clone https://github.com/your-repo/Dynamic_CRM_MCP_Server.git
cd Dynamic_CRM_MCP_Server

2. 依存関係をインストールする

pip install -r requirements.txt

Claude for Desktop との統合 🖥️

この設定を Claude の設定ファイル（settings.json）に追加します。

{
    "mcpServers": {
        "Dynamic_CRM_MCP_Server": {
            "command": "python",
            "args": ["Dynamic_CRM_MCP_Server/server.py"],
            "env": {
                "CLIENT_ID": "<your_client_id>",
                "CLIENT_SECRET": "<your_client_secret>",
                "TENANT_ID": "<your_tenant_id>",
                "RESOURCE": "<your_dynamics365_resource_url>"
            }
        }
    }
}

注意

<angle_brackets> 内の値を実際の認証情報に置き換えてください。

CLIENT_ID：Azure AD アプリケーション ID

CLIENT_SECRET：Azure AD クライアントシークレット

TENANT_ID：Azure ディレクトリ（テナント）ID

RESOURCE：Dynamics 365 インスタンスの URL（例：https://orgname.crm.dynamics.com）