Dynamics MCP

Dynamics 365 CRM MCP服务器

MCP（模型上下文协议）服务器，通过OData API连接到Microsoft Dynamics 365 CRM（MSX）。专为与GitHub Copilot CLI和其他MCP兼容的AI助手一起使用而设计。

特性

账户管理

• my_accounts --列出通过分配给您的所有帐户 msp_accountteams
• account_details --完整的帐户详细信息，包括父/子层次结构
• account_contacts --获取帐户的联系人
• account_team --帐户团队成员（如果子团队没有团队，则自动遍历到父团队）
• account_opportunities --账户机会（包括子账户）

机会和渠道

• my_opportunities --您在交易团队中的机会
• opportunities_not_on_team --在您的账户中打开您没有的机会
• opportunity_detail --与交易团队一起提供完整的机会细节
• opportunity_team --为团队成员提供机会
• search_opportunities --使用过滤器搜索（查询、阶段、值、结束日期）
• pipeline_summary --按账户和阶段汇总管道

里程碑

• my_milestones --交易团队机会中的所有里程碑
• opportunity_milestones --特定机会的里程碑

联系人和帐户查找

• find_contact_by_email --通过父帐户解析的电子邮件地址查找联系人
• find_account_by_domain --按网站/电子邮件域查找帐户（例如“contoso.com”）

注释和注释

• create_note --在任何记录（里程碑、机会等）上创建注释/评论
• search_annotations --搜索记录上的现有笔记（时间线历史、重复检查）

发现与探索

• discover_entities --在Dynamics元数据中搜索实体名称
• discover_fields --获取任何实体的字段/属性
• run_odata_query --运行自定义OData查询以进行即席探索

写入操作

• create_record --在任何实体上创建新记录（通用）
• update_record --更新任何记录上的字段
• assign_to_me --为自己分配一个记录（里程碑、任务等）

先决条件

• Python 3.10+
• 访问Dynamics 365 CRM实例
• Azure AD应用程序注册 user_impersonation Dynamics实例的权限

设置

1.克隆并安装依赖项

git clone 
cd dynamics-mcp
pip install -r requirements.txt

2.创建一个 .env 文件

复制 .env.example 并填写您的值：

cp .env.example .env

3.查找您的用户名

找到你的 systemuserid，在浏览器中运行此OData查询（经过身份验证时）：

https://.crm.dynamics.com/api/data/v9.2/systemusers?$filter=internalemailaddress eq 'your.email@company.com'&$select=systemuserid,fullname

4.配置GitHub Copilot CLI

添加到您的 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "dynamics-crm": {
      "command": "python",
      "args": ["/dynamics-mcp/server.py"],
      "env": {
        "DYNAMICS_CLIENT_ID": "your-client-id",
        "DYNAMICS_TENANT_ID": "your-tenant-id",
        "DYNAMICS_USER_ID": "your-user-id"
      },
      "tools": ["*"]
    }
  }
}

提示： 您还可以在shell配置文件中设置env变量，或者 .env 文件而不是配置中的内联。

5.首轮

首次启动时，服务器将打开浏览器进行交互式Azure AD登录。身份验证后，令牌将在本地缓存在 .token_cache.json.

认证

使用Microsoft身份验证库 公共客户端 流量：

• 令牌缓存在 .token_cache.json （自动刷新）
• 首次登录需要交互式浏览器身份验证
• 后续运行会静默使用缓存/刷新令牌

建筑

┌─────────────────┐     stdio      ┌──────────────────┐     OData v9.2     ┌───────────────┐
│  Copilot CLI /   │◄──────────────►│  FastMCP Server  │◄──────────────────►│  Dynamics 365  │
│  MCP Client      │                │  (server.py)     │     MSAL auth      │  CRM (MSX)     │
└─────────────────┘                └──────────────────┘                    └───────────────┘

实体参考

许可证

仅供内部使用。