Sherweb Platform MCP 服务器(预览版)

Sherweb Cumulus MCP 服务器允许 AI 助手通过模型上下文协议安全地访问 Cumulus。 经授权的 MSP 合作伙伴可以使用自然语言来检索组织、订阅、目录、计费和审核数据,将其合并为有用的答案,并在其 Cumulus 权限中执行受支持的操作,例如下订单和修改订阅。

此连接器在以下产品和区域中可用:

Service Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 :
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人
Name Sherweb 支持
URL https://www.sherweb.com
Email support@sherweb.com
连接器元数据
Publisher Sherweb 的 AI
网站 https://www.sherweb.com
隐私策略 https://www.sherweb.com/legal/privacy-policy/
Categories IT作;业务管理

Sherweb Cumulus

Sherweb 是一个云解决方案提供商,它使托管服务提供商(MSP)能够通过 Cumulus 平台管理其客户、订阅、计费和目录。 Cumulus MCP(模型上下文协议)连接器直接向 AI 助手(如Microsoft Copilot Studio代理)公开 Cumulus 数据,以便你可以以自然语言查询和处理 MSP 业务。

使用此连接器,可以提出 AI 助手问题,例如:

  • “列出未来 60 天内续订的所有订阅。
  • “我的哪些组织没有备份产品?
  • “通过定期收入,我的前 10 大组织是什么?
  • “下达组织 Contoso 的订单。

Prerequisites

  • 具有服务提供商角色的活动 Cumulus 帐户。
  • 具有和mcp:toolsservice-provider作用域的特定于经销商的 Cumulus API 密钥。
  • 安装了 Sherweb Platform 连接器解决方案的Microsoft Power Platform环境。

创建经销商凭据

每个经销商在创建连接器连接时使用自己的现有 OAuth 客户端凭据;此流不使用动态客户端注册(DCR)或共享客户端 ID 和客户端密码。

https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021

  1. 登录到 Cumulus。
  2. 导航到 平台设置 → API。
  3. 为经销商创建单独的 API 密钥,或选择该经销商的现有密钥。
  4. 确保密钥具有和mcp:toolsservice-provider作用域。 复制其客户端 ID 和客户端密码;仅当创建机密时,才会显示机密。
  5. 将为已安装的 Sherweb 平台连接器显示的重定向 URI 添加到 API 密钥。

OAuth 终结点

领域 Value
授权 URL https://cumulus.sherweb.com/oidc/connect/authorize
令牌 URL https://cumulus.sherweb.com/oidc/connect/token
刷新 URL https://cumulus.sherweb.com/oidc/connect/token
Scopes mcp:tools service-provider

创建连接

https://helpdesk.sherweb.com/en-us/knowledge-base/articles/KA-05021

  1. 在 Power Platform 中,选择已安装的 Sherweb Platform 连接器并创建连接。
  2. 出现提示时,输入经销商的 客户端 ID 和 客户端密码 。 这些凭据由连接安全地存储,用于该经销商的 OAuth 授权和令牌刷新。
  3. 使用授权该经销商的用户帐户登录到 Cumulus。
  4. 如果连接无法完成授权,请验证连接器重定向 URI 是否已在该经销商的 API 密钥上注册,以及是否启用了这两个所需范围。

为每个经销商创建单独的连接。 客户端 ID 和客户端密码标识经销商的 OAuth 应用程序;交互式登录确定有权使用该连接的用户帐户。

令牌续订使用 OAuth 刷新令牌授予和为该连接提供的凭据,而不是重复授权代码交换。

对于直接 MCP 客户端(而不是经过认证的 Power Platform 连接器),请使用上述终结点和范围配置 OAuth https://mcp.sherweb.com 。 直接 MCP 客户端身份验证设置独立于 Power Platform 连接器中特定于经销商的凭据字段。

支持的操作

Read-Only 工具

工具 Description
QueryOrganizations 使用 GraphQL 查询服务提供商管理的组织。
QuerySubscriptions 使用 GraphQL 跨组织查询订阅。
QueryOrganizationConsumptions 使用 GraphQL 的组织的查询消耗数据(使用情况和费用)。
QueryCatalog 使用 GraphQL 查询服务提供商可用的产品目录。
QueryAuditLogs 使用 GraphQL 查询平台上执行的操作的审核日志。
GetGraphQLSchema 检索完整的 GraphQL 架构,以帮助构造有效的查询。
GetCopilotSkus 获取Microsoft Copilot产品/服务的 Sherweb SKU 列表。

写入工具

注意: 写入操作需要对经过身份验证的 Cumulus 帐户具有适当的权限。

工具 Description
PlaceOrder 为客户组织下订单。
ValidateQuote 验证建议的订单并获取定价详细信息,而无需下单。
CreateSubscriptionsAmendment 修改一个或多个现有订阅的席位或许可证数量。
CancelSubscriptions 取消客户组织的一个或多个订阅。
ConfigurePlatform 为客户配置平台(例如,Microsoft 365租户)。

示例提示

下面是可与连接到此 MCP 服务器的 AI 助手一起使用的自然语言提示示例:

续订和计费

  • “列出未来 60 天内续订的所有订阅。
  • “给我过去 3 个月组织 Contoso 的所有费用的细分。
  • “所有组织的订阅在 30 天内到期?”

库存和项目组合

  • “我的哪些组织没有备份产品?
  • “通过定期收入,我的前 10 大组织是什么?
  • “显示最近取消的所有订阅。
  • “列出包含Copilot SKU 的所有产品/服务。

Actions

  • “为组织 Contoso 订购了 5 个Microsoft 365 商业高级版席位。
  • “验证Azure计划组织 Fabrikam 的 10 个席位的报价。
  • “将 Contoso 组织的Exchange Online席位数量从 20 个减少到 15 个。

已知问题和限制

  • GraphQL 查询深度:非常深层嵌套的 GraphQL 查询可能会超时。如果查询超时,请通过减少嵌套深度或请求的字段数来简化查询。
  • 需要分页:列出查询(QueryOrganizations等QuerySubscriptions)需要分页参数(after/first或)。last/before 没有分页的查询将返回错误。
  • 范围:确保在创建 API 密钥时同时mcp:toolsservice-provider包含在 OAuth 范围中;缺少任一范围将导致身份验证错误。

正在创建连接

连接器支持以下身份验证类型:

默认 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description Required
经销商客户端 ID 字符串 输入为此经销商颁发的客户端 ID。 是
经销商客户端密码 安全字符串 输入为此经销商颁发的客户端密码。 是

操作

为客户下单

为客户下订单。

为客户配置平台

为客户配置平台。

使用 GraphQL 查询审核日志

使用 GraphQL 查询审核日志。

使用 GraphQL 查询目录项

使用 GraphQL 查询目录项。

使用 GraphQL 查询组织

使用 GraphQL 查询组织。

使用 GraphQL 查询组织使用情况

使用 GraphQL 查询组织使用情况。

使用 GraphQL 查询订阅

使用 GraphQL 查询订阅。

修改订阅数量

修改订阅数量。

取消组织的订阅

取消组织的订阅。

在不下订单的情况下验证报价

在不下订单的情况下验证报价。

获取 SDL 格式的 GraphQL 架构

获取 SDL 格式的 GraphQL 架构。

获取映射到Microsoft Copilot产品/服务的 Sherweb SKU

获取映射到Microsoft Copilot产品/服务的 Sherweb SKU。

为客户下单

为客户下订单。

参数

名称 密钥 必需 类型 说明
customerId
customerId True uuid
sku
sku True string
数量
quantity integer
purchaseOrderNumber
purchaseOrderNumber string
orderedBy
orderedBy True string

返回

为客户配置平台

为客户配置平台。

参数

名称 密钥 必需 类型 说明
customerId
customerId True uuid
platformId
platformId True uuid
标识符
identifier True string
value
value string

返回

响应
string

使用 GraphQL 查询审核日志

使用 GraphQL 查询审核日志。

参数

名称 密钥 必需 类型 说明
graphqlQuery
graphqlQuery True string

返回

基于游标的分页的泛型连接类型,“T”连接中的项类型

使用 GraphQL 查询目录项

使用 GraphQL 查询目录项。

参数

名称 密钥 必需 类型 说明
graphqlQuery
graphqlQuery True string

返回

基于游标的分页的泛型连接类型,“T”连接中的项类型

使用 GraphQL 查询组织

使用 GraphQL 查询组织。

参数

名称 密钥 必需 类型 说明
graphqlQuery
graphqlQuery True string

返回

基于游标的分页的泛型连接类型,“T”连接中的项类型

使用 GraphQL 查询组织使用情况

使用 GraphQL 查询组织使用情况。

参数

名称 密钥 必需 类型 说明
graphqlQuery
graphqlQuery True string

返回

基于游标的分页的泛型连接类型,“T”连接中的项类型

使用 GraphQL 查询订阅

使用 GraphQL 查询订阅。

参数

名称 密钥 必需 类型 说明
graphqlQuery
graphqlQuery True string

返回

基于游标的分页的泛型连接类型,“T”连接中的项类型

修改订阅数量

修改订阅数量。

参数

名称 密钥 必需 类型 说明
组织 ID
organizationId True uuid
subscriptionId
subscriptionId True uuid
newQuantity
newQuantity integer

返回

取消组织的订阅

取消组织的订阅。

参数

名称 密钥 必需 类型 说明
组织 ID
organizationId True uuid
subscriptionIds
subscriptionIds True array of uuid

返回

在不下订单的情况下验证报价

在不下订单的情况下验证报价。

参数

名称 密钥 必需 类型 说明
customerId
customerId True uuid
sku
sku True string
数量
quantity integer
purchaseOrderNumber
purchaseOrderNumber string
orderedBy
orderedBy True string

返回

获取 SDL 格式的 GraphQL 架构

获取 SDL 格式的 GraphQL 架构。

返回

响应
string

获取映射到Microsoft Copilot产品/服务的 Sherweb SKU

获取映射到Microsoft Copilot产品/服务的 Sherweb SKU。

返回

定义

选项

名称 路径 类型 说明
parameterChoiceValue
parameterChoiceValue string
parameterChoiceDisplayName
parameterChoiceDisplayName string

ConnectionOfProjectedAuditLog

基于游标的分页的泛型连接类型,“T”连接中的项类型

名称 路径 类型 说明
边缘
edges array of EdgeOfProjectedAuditLog

此页中的边缘列表。 每个边缘都包含节点及其游标。

nodes
nodes array of ProjectedAuditLog

此页面中节点的平展列表(不含游标元数据)。

总计数
totalCount integer

所有页面的项总数(请求时)

pageInfo
pageInfo PageInfo

基于游标的导航的分页元数据。

ConnectionOfProjectedCatalogItem

基于游标的分页的泛型连接类型,“T”连接中的项类型

名称 路径 类型 说明
边缘
edges array of EdgeOfProjectedCatalogItem

此页中的边缘列表。 每个边缘都包含节点及其游标。

nodes
nodes array of ProjectedCatalogItem

此页面中节点的平展列表(不含游标元数据)。

总计数
totalCount integer

所有页面的项总数(请求时)

pageInfo
pageInfo PageInfo

基于游标的导航的分页元数据。

ConnectionOfProjectedConsumptionItem

基于游标的分页的泛型连接类型,“T”连接中的项类型

名称 路径 类型 说明
边缘
edges array of EdgeOfProjectedConsumptionItem

此页中的边缘列表。 每个边缘都包含节点及其游标。

nodes
nodes array of ProjectedConsumptionItem

此页面中节点的平展列表(不含游标元数据)。

总计数
totalCount integer

所有页面的项总数(请求时)

pageInfo
pageInfo PageInfo

基于游标的导航的分页元数据。

ConnectionOfProjectedOrganization

基于游标的分页的泛型连接类型,“T”连接中的项类型

名称 路径 类型 说明
边缘
edges array of EdgeOfProjectedOrganization

此页中的边缘列表。 每个边缘都包含节点及其游标。

nodes
nodes array of ProjectedOrganization

此页面中节点的平展列表(不含游标元数据)。

总计数
totalCount integer

所有页面的项总数(请求时)

pageInfo
pageInfo PageInfo

基于游标的导航的分页元数据。

ConnectionOfProjectedSubscription

基于游标的分页的泛型连接类型,“T”连接中的项类型

名称 路径 类型 说明
边缘
edges array of EdgeOfProjectedSubscription

此页中的边缘列表。 每个边缘都包含节点及其游标。

nodes
nodes array of ProjectedSubscription

此页面中节点的平展列表(不含游标元数据)。

总计数
totalCount integer

所有页面的项总数(请求时)

pageInfo
pageInfo PageInfo

基于游标的导航的分页元数据。

EdgeOfProjectedAuditLog

基于游标的分页连接的边缘,包含节点及其游标。

名称 路径 类型 说明
节点
node ProjectedAuditLog
游标
cursor string

此边缘的游标,用于基于游标的分页。

EdgeOfProjectedCatalogItem

基于游标的分页连接的边缘,包含节点及其游标。

名称 路径 类型 说明
节点
node ProjectedCatalogItem
游标
cursor string

此边缘的游标,用于基于游标的分页。

EdgeOfProjectedConsumptionItem

基于游标的分页连接的边缘,包含节点及其游标。

名称 路径 类型 说明
节点
node ProjectedConsumptionItem
游标
cursor string

此边缘的游标,用于基于游标的分页。

EdgeOfProjectedOrganization

基于游标的分页连接的边缘,包含节点及其游标。

名称 路径 类型 说明
节点
node ProjectedOrganization
游标
cursor string

此边缘的游标,用于基于游标的分页。

EdgeOfProjectedSubscription

基于游标的分页连接的边缘,包含节点及其游标。

名称 路径 类型 说明
节点
node ProjectedSubscription
游标
cursor string

此边缘的游标,用于基于游标的分页。

事件源

InvoiceMetrics

名称 路径 类型 说明
periodRange
periodRange InvoicePeriodRange
accumulatedRecurringCost
accumulatedRecurringCost double

O(1)

invoiceCount
invoiceCount integer

O(1)

compoundMonthlyCostGrowthRate
compoundMonthlyCostGrowthRate double

O(1)

costConcentrationRatio
costConcentrationRatio double

O(1)

costVolatility
costVolatility double

O(1)

InvoicePeriodRange

名称 路径 类型 说明
from
from date

O(1)

to
to date

O(1)

PageInfo

基于游标的导航的分页元数据。

名称 路径 类型 说明
hasNextPage
hasNextPage boolean
hasPreviousPage
hasPreviousPage boolean
startCursor
startCursor string
endCursor
endCursor string

PlaceOrderResponse

名称 路径 类型 说明
requestTrackingId
requestTrackingId uuid
subscriptionIds
subscriptionIds array of uuid

PlatformRequiredParameter

名称 路径 类型 说明
parameterDescription
parameterDescription string
parameterIdentifier
parameterIdentifier string
parameterDefaultValue
parameterDefaultValue string
parameterFormatType
parameterFormatType string
parameterFormatPattern
parameterFormatPattern string
parameterFormatChoices
parameterFormatChoices array of Choice

ProjectedAuditLog

名称 路径 类型 说明
id
id integer
targetName
targetName string
操作
action string
date
date date-time
用户显示名称
userDisplayName string
categoryName
categoryName string
说明
description string
details
details array of ProjectedAuditLogDetail

ProjectedAuditLogDetail

名称 路径 类型 说明
propertyName
propertyName string
oldValue
oldValue string
NewValue
newValue string

ProjectedCatalogItem

名称 路径 类型 说明
sku
sku string

O(1)

name
name string

O(1)

说明
description string

O(1)

billingCycle
billingCycle string

O(1)

commitmentTerm
commitmentTerm string

O(1)

pricingInformation
pricingInformation ProjectedPricingInformation
平台
platforms array of ProjectedPlatforms

O(1) 额外呼叫

ProjectedCommitmentTerm

名称 路径 类型 说明
类型
type ProjectedCommitmentTermType
结束日期
endDate date-time
renewalConfiguration
renewalConfiguration ProjectedRenewalConfiguration

ProjectedCommitmentTermType

ProjectedConsumptionItem

名称 路径 类型 说明
产品
product string

O(1)

vendorName
vendorName string

O(1)

totalQuantities
totalQuantities integer

O(1)

consumedQuantities
consumedQuantities integer

O(1)

availableQuantities
availableQuantities integer

O(1)

ProjectedCurrency

ProjectedFeesDto

名称 路径 类型 说明
recurringFee
recurringFee ProjectedMoney
setupFee
setupFee ProjectedMoney
costRecurringFee
costRecurringFee ProjectedMoney
billingCycle
billingCycle string

ProjectedMoney

名称 路径 类型 说明
value
value double
货币
currency ProjectedCurrency
舍入
rounding integer

ProjectedOrganization

名称 路径 类型 说明
id
id uuid

O(1)

name
name string

O(1)

唯一名称
uniqueName string

O(1)

parentId
parentId uuid

O(1)

parentName (父名称)
parentName string

O(1)

suspendedOn
suspendedOn date-time

O(n)

isSuspended
isSuspended boolean

O(1)

已删除
isDeleted boolean

O(1)

isActive
isActive boolean

O(n)

daysSinceSuspension
daysSinceSuspension integer

O(n)

totalSubscriptionCount
totalSubscriptionCount integer

O(n)

uniqueSkus
uniqueSkus array of string

O(n)

totalMonthlyRecurringFee
totalMonthlyRecurringFee double

O(n)

totalMonthlyCostRecurringFee
totalMonthlyCostRecurringFee double

O(n)

totalYearlyRecurringFee
totalYearlyRecurringFee double

O(n)

totalYearlyCostRecurringFee
totalYearlyCostRecurringFee double

O(n)

totalOtherRecurringFee
totalOtherRecurringFee double

O(n),使用每月或每年以外的计费周期性费用的聚合

totalOtherCostRecurringFee
totalOtherCostRecurringFee double

O(n),使用每月或每年以外的计费周期性成本费用的聚合

invoiceMetrics
invoiceMetrics InvoiceMetrics

ProjectedPlatforms

名称 路径 类型 说明
platformId
platformId uuid
requiredParameters
requiredParameters array of PlatformRequiredParameter

O(1) 额外呼叫

ProjectedPricingInformation

名称 路径 类型 说明
recurringFee
recurringFee double
setupFee
setupFee double
货币
currency ProjectedCurrency
billingCycle
billingCycle string

ProjectedRenewalConfiguration

名称 路径 类型 说明
isConfigurable
isConfigurable boolean
renewSettings
renewSettings ProjectedRenewSettings

ProjectedRenewSettings

名称 路径 类型 说明
renewalDate
renewalDate date-time
scheduledQuantity
scheduledQuantity integer
coTerminationEndDate
coTerminationEndDate date-time

ProjectedSubscription

名称 路径 类型 说明
subscriptionId
subscriptionId uuid

O(1)

组织 ID
organizationId uuid

O(1)

cancelledOn
cancelledOn date-time

O(n)

isActive
isActive boolean

O(n)

daysSinceCreation
daysSinceCreation integer

O(n)

createdOn
createdOn date-time

O(1)

数量
quantity integer

O(1)

commitmentTerm
commitmentTerm ProjectedCommitmentTerm
daysUntilRenewal
daysUntilRenewal integer

O(n)

sherwebSku
sherwebSku string

O(1)

microsoftSkus
microsoftSkus array of string

O(n)

说明
description string

O(1)

expirationDate
expirationDate date-time

O(1)

lastRenewalDate
lastRenewalDate date-time

O(n)

费用
fees ProjectedFeesDto
productName
productName string

O(1)

isCoterminated
isCoterminated boolean

O(n)

历史记录
history array of SubscriptionHistoryEvent

O(n)

RenewedTermEndDateDetail

名称 路径 类型 说明
previousDate
previousDate date
newDate
newDate date

RenewedTermStartDateDetail

名称 路径 类型 说明
previousDate
previousDate date
newDate
newDate date

SkuDetail

名称 路径 类型 说明
sku
sku string
SKU名称
skuName string

SubscriptionHistoryEvent

名称 路径 类型 说明
createdOn
createdOn date-time
许可证数量
licenseCount integer
sku
sku string
优惠名称
offerName string
用户
user string
coTerminationDate
coTerminationDate string
事件源
eventSource EventSource
termEndDateDetail
termEndDateDetail RenewedTermEndDateDetail
termStartDateDetail
termStartDateDetail RenewedTermStartDateDetail

SubscriptionsAmendment

名称 路径 类型 说明
subscriptionsAmendmentId
subscriptionsAmendmentId uuid
trackingId
trackingId TrackingId

SubscriptionsCancellation

名称 路径 类型 说明
subscriptionsCancellationId
subscriptionsCancellationId uuid
trackingId
trackingId TrackingId

跟踪编号

名称 路径 类型 说明
requestTrackingId
requestTrackingId uuid

ValidateOrderLineItem

名称 路径 类型 说明
lineNumber
lineNumber integer
sku
sku string
name
name string
billingCycle
billingCycle string
commitmentTerm
commitmentTerm string
数量
quantity integer
单价
unitPrice double
扩展价格
extendedPrice double
货币
currency string

ValidateOrderResult

名称 路径 类型 说明
消息
message string
lineItems
lineItems array of ValidateOrderLineItem
次 全 切除
subtotal double
货币
currency string

字符串

这是基本数据类型“string”。