ALM XPP MCP

almxppmcp

npx发射器 为了 ALM XPP MCP 云服务器——D365财务与运营人工智能代理，配备34个工具。

需求

• Node.js>=18
• API令牌——在 仪表盘

______________________________________________________________________

快速开始

npx almxppmcp --api-key YOUR_TOKEN

或者设置环境变量：

export ALMXPPMCP_API_KEY=YOUR_TOKEN
npx almxppmcp

______________________________________________________________________

MCP客户端配置

VS代码/GitHub副本-- .vscode/mcp.json

{
  "servers": {
    "almxppmcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
    }
  }
}

光标-- .cursor/mcp.json

{
  "mcpServers": {
    "almxppmcp": {
      "command": "npx",
      "args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
    }
  }
}

克劳德桌面-- claude_desktop_config.json

{
  "mcpServers": {
    "almxppmcp": {
      "command": "npx",
      "args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
    }
  }
}

提示： 替换 YOUR_TOKEN 令牌显示在您的仪表板上。将其设置为env-var以避免硬编码： ``json { "mcpServers": { "almxppmcp": { "command": "npx", "args": ["-y", "almxppmcp"], "env": { "ALMXPPMCP_API_KEY": "YOUR_TOKEN" } } } } ``

______________________________________________________________________

环境变量

______________________________________________________________________

专用D365FO数据环境

使用捆绑的 almxppmcp-d365fo-proxy 当您需要专用于实时D365FO环境数据层的第二台MCP服务器时。

它现在支持两种模式：

• 本地直接模式：您的计算机通过Azure CLI获取D365FO令牌，并直接调用环境
• 云桥模式：启动器调用您托管的ALM XPP端点，该端点在服务器端获取D365FO令牌

这是有意与 almxppmcp:

• almxppmcp：知识库、自定义代码、关系、Azure DevOps、生成
• almxppmcp-d365fo-proxy：通过Azure CLI身份验证的实时D365FO环境MCP端点

它做什么

• 作为Copilot、Cursor或Claude的本地stdio MCP服务器运行
• 获取Azure AD承载令牌 az account get-access-token
• 将JSON-RPC消息转发到D365FO远程MCP端点
• 蜜饯 mcp-session-id 跨请求
• 处理纯JSON和 text/event-stream 回应

本地直接模式

所需的环境变量：

VS代码MCP配置示例：

{
  "servers": {
    "almxppmcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "almxppmcp"],
      "env": {
        "ALMXPPMCP_API_KEY": "YOUR_TOKEN"
      }
    },
    "d365fo-data": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "almxppmcp", "almxppmcp-d365fo-proxy"],
      "env": {
        "D365FO_MCP_URL": "https://YOUR-ENV.sandbox.operations.dynamics.com/mcp",
        "D365FO_RESOURCE": "https://YOUR-ENV.sandbox.operations.dynamics.com"
      }
    }
  }
}

云桥模式

所需的环境变量：

在多用户场景中，将环境URL保存在每个用户的MCP配置中（而不是ACA全局变量中）。 启动器根据请求将这些值转发到云桥。

VS代码MCP配置示例：

{
  "servers": {
    "d365fo-data": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "almxppmcp", "almxppmcp-d365fo-proxy"],
      "env": {
        "D365FO_PROXY_URL": "https://www.almxpp.com/api/d365fo/mcp",
        "D365FO_PROXY_API_KEY": "YOUR_ALMXPP_TOKEN",
        "D365FO_MCP_URL": "https://YOUR-ENV.sandbox.operations.dynamics.com/mcp",
        "D365FO_RESOURCE": "https://YOUR-ENV.sandbox.operations.dynamics.com"
      }
    }
  }
}

D365FO先决条件

1. 安装Azure CLI并运行 az login
2. 在D365FO中，打开 Allowed MCP clients
3. 添加Azure CLI客户端id 04b07795-8ddb-461a-bbee-02f9e1bf7b46
4. 将其标记为目标环境允许

注：

• 此通用客户端id仅在D365中配置
• 不要将此客户端id放入MCP JSON中
• MCP JSON只需要代理命令和相关的URL/env值

推荐使用模式

同时使用两台MCP服务器：

• 问 almxppmcp 识别表、实体、关系、自定义扩展名和相关工作项
• 问 d365fo-data 检查真实环境数据、表单或自定义操作
• 在聊天中交叉显示结果，以连接知识库、自定义代码、工作项和实时数据

看 npm/examples/vscode-mcp.d365fo-data.json, npm/examples/vscode-mcp.d365fo-data.cloud.json，以及 docs/D365FO_DATA_ENVIRONMENT_SETUP.md 用于即用型设置。

______________________________________________________________________

有哪些可用的工具？

该服务器公开了6个类别的34个工具：

看 仪表盘 查看完整的工具列表。

______________________________________________________________________

许可证

麻省理工学院