Sherweb Platform MCP Server (預覽版)

Sherweb Cumulus MCP 伺服器透過模型上下文協定(Model Context Protocol)讓 AI 助理能安全存取 Cumulus。 授權的 MSP 合作夥伴可利用自然語言檢索組織、訂閱、目錄、帳單及稽核資料,將其組合成有用的答案,並在其 Cumulus 權限內執行支援操作,如下訂單與修訂訂閱。

此連接器適用於以下產品和區域:

Service Class Regions
Copilot Studio 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域 :
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人
Name Sherweb 支援
URL https://www.sherweb.com
Email support@sherweb.com
連接器中繼資料
Publisher Sherweb 的人工智慧
Website https://www.sherweb.com
隱私權原則 https://www.sherweb.com/legal/privacy-policy/
Categories IT運營;企業管理

雪網積雲

Sherweb 是一家雲端解決方案供應商,協助託管服務供應商(MSP)透過 Cumulus 平台管理客戶、訂閱、帳單及目錄管理。 Cumulus MCP(模型上下文協定)連接器直接將您的 Cumulus 資料暴露給 AI 助理,例如 Microsoft Copilot Studio 代理,讓您能以自然語言查詢並處理您的 MSP 業務。

透過這個連接器,你可以問你的 AI 助理以下問題:

  • 「列出所有未來60天內可續約的訂閱。」
  • 「我哪個組織沒有備用產品?」
  • 「我以經常性收入排名前十的組織是什麼?」
  • 「訂購組織,Contoso。」

Prerequisites

  • 一個啟用的 Cumulus 帳戶,服務 提供者 角色。
  • 一個專屬經銷商的 Cumulus API 金鑰,裡面有 mcp:tools 和 service-provider 範圍。
  • 一個安裝 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 Platform 連接器顯示的重定向 URI 加入 API 金鑰。

OAuth 端點

Field 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
範圍 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 工具

Tool Description
QueryOrganizations 查詢由服務提供者使用 GraphQL 管理的組織。
QuerySubscriptions 使用 GraphQL 查詢跨組織的訂閱。
QueryOrganizationConsumptions 查詢使用 GraphQL 組織的用電量資料(使用量與收費)。
QueryCatalog 使用 GraphQL 查詢服務提供者可用的產品目錄。
QueryAuditLogs 查詢使用 GraphQL 在平台上執行的行為的稽核日誌。
GetGraphQLSchema 檢索完整的 GraphQL 架構以協助構建有效查詢。
GetCopilotSkus 取得 Microsoft Copilot 的 Sherweb SKU 優惠清單。

書寫工具

註: 寫入操作需要在已認證的 Cumulus 帳號上取得適當的權限。

Tool Description
PlaceOrder 為客戶組織下訂單。
ValidateQuote 驗證擬訂訂單並取得價格細節,無需下訂單即可。
CreateSubscriptionsAmendment 調整一個或多個現有訂閱的座位或執照數量。
CancelSubscriptions 取消一個或多個客戶組織的訂閱。
ConfigurePlatform 為客戶配置一個平台(例如 Microsoft 365 租戶)。

範例提示

以下是你可以用連接到這個 MCP 伺服器的 AI 助理使用的自然語言提示範例:

續約與帳單

  • 「列出所有未來60天內可續約的訂閱。」
  • 「告訴我過去三個月Contoso組織所有指控的細數。」
  • 「所有組織的訂閱期限在30天內到期?」

庫存與投資組合

  • 「我哪個組織沒有備用產品?」
  • 「我以經常性收入排名前十的組織是什麼?」
  • 「給我看所有最近取消的訂閱。」
  • 「列出包含 Copilot SKU 的產品供應。」

Actions

  • 「訂購 5 個 Microsoft 365 商務進階版 給 Contoso 組織。」
  • 「驗證Fabrikam組織Azure計畫10席的報價。」
  • 「將Contoso組織的Exchange Online座位數量從20個減少到15個。」

已知問題和限制

  • GraphQL 查詢深度:非常深度巢狀的 GraphQL 查詢可能會逾時。如果查詢逾時,透過減少巢狀深度或請求欄位數量來簡化。
  • 需要分頁:列表查詢(QueryOrganizations、 QuerySubscriptions等)需要分頁參數(after/first或 )。last/before 沒有分頁的查詢會回傳錯誤。
  • 範圍:建立 API 金鑰時,確保 mcp:tools 和 service-provider 都包含在 OAuth 範圍內;缺少任一範圍將導致認證錯誤。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有地區 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

Name 類型 Description Required
經銷商客戶識別碼 字串 輸入為該經銷商所發出的客戶識別碼。 True
經銷商客戶秘密 安全字串 請輸入為該經銷商發出的客戶秘密。 True

動作

使用 GraphQL 查詢目錄項目

使用 GraphQL 查詢目錄項目。

使用 GraphQL 查詢稽核日誌

使用 GraphQL 查詢稽核日誌。

使用 GraphQL 查詢組織消耗

使用 GraphQL 查詢組織消耗。

使用 GraphQL 查詢訂閱

使用 GraphQL 查詢訂閱。

使用 GraphQL 的查詢組織

使用 GraphQL 查詢組織。

修訂訂閱數量

調整訂閱數量。

取得 SDL 格式的 GraphQL 架構

取得 SDL 格式的 GraphQL 架構。

取消組織訂閱

取消組織的訂閱。

在不下訂單的情況下驗證報價

在不下訂單的情況下驗證報價。

將 Sherweb SKU 對應到 Microsoft Copilot 的優惠

讓 Sherweb SKU 對應到 Microsoft Copilot 優惠。

為客戶下單

為顧客下單。

為客戶配置平台

為客戶設定一個平台。

使用 GraphQL 查詢目錄項目

使用 GraphQL 查詢目錄項目。

參數

名稱 機碼 必要 類型 Description
graphqlQuery
graphqlQuery True string

傳回

游標分頁的通用連接類型,「T」連接中項目的類型

使用 GraphQL 查詢稽核日誌

使用 GraphQL 查詢稽核日誌。

參數

名稱 機碼 必要 類型 Description
graphqlQuery
graphqlQuery True string

傳回

游標分頁的通用連接類型,「T」連接中項目的類型

使用 GraphQL 查詢組織消耗

使用 GraphQL 查詢組織消耗。

參數

名稱 機碼 必要 類型 Description
graphqlQuery
graphqlQuery True string

傳回

游標分頁的通用連接類型,「T」連接中項目的類型

使用 GraphQL 查詢訂閱

使用 GraphQL 查詢訂閱。

參數

名稱 機碼 必要 類型 Description
graphqlQuery
graphqlQuery True string

傳回

游標分頁的通用連接類型,「T」連接中項目的類型

使用 GraphQL 的查詢組織

使用 GraphQL 查詢組織。

參數

名稱 機碼 必要 類型 Description
graphqlQuery
graphqlQuery True string

傳回

游標分頁的通用連接類型,「T」連接中項目的類型

修訂訂閱數量

調整訂閱數量。

參數

名稱 機碼 必要 類型 Description
組織ID
organizationId True uuid
subscriptionId
subscriptionId True uuid
新數量
newQuantity integer

傳回

取得 SDL 格式的 GraphQL 架構

取得 SDL 格式的 GraphQL 架構。

傳回

response
string

取消組織訂閱

取消組織的訂閱。

參數

名稱 機碼 必要 類型 Description
組織ID
organizationId True uuid
subscriptionIds
subscriptionIds True array of uuid

傳回

在不下訂單的情況下驗證報價

在不下訂單的情況下驗證報價。

參數

名稱 機碼 必要 類型 Description
客戶ID
customerId True uuid
sku
sku True string
數量
quantity integer
購買訂單號
purchaseOrderNumber string
命令者
orderedBy True string

傳回

將 Sherweb SKU 對應到 Microsoft Copilot 的優惠

讓 Sherweb SKU 對應到 Microsoft Copilot 優惠。

傳回

為客戶下單

為顧客下單。

參數

名稱 機碼 必要 類型 Description
客戶ID
customerId True uuid
sku
sku True string
數量
quantity integer
購買訂單號
purchaseOrderNumber string
命令者
orderedBy True string

傳回

為客戶配置平台

為客戶設定一個平台。

參數

名稱 機碼 必要 類型 Description
客戶ID
customerId True uuid
platformId
platformId True uuid
識別碼
identifier True string
value
value string

傳回

response
string

定義

選擇

名稱 路徑 類型 Description
參數選擇值
parameterChoiceValue string
parameterChoiceDisplayName
parameterChoiceDisplayName string

ConnectionOfProjectedAuditLog

游標分頁的通用連接類型,「T」連接中項目的類型

名稱 路徑 類型 Description
邊緣
edges array of EdgeOfProjectedAuditLog

本頁的邊列表。 每條邊包含節點及其游標。

nodes
nodes array of ProjectedAuditLog

本頁節點的扁平列表(不含游標元資料)。

總計數量
totalCount integer

所有頁面的總項目數量(如要求時)

頁面資訊
pageInfo PageInfo

用於游標導覽的分頁元資料。

ConnectionOfProjectedCatalogItem

游標分頁的通用連接類型,「T」連接中項目的類型

名稱 路徑 類型 Description
邊緣
edges array of EdgeOfProjectedCatalogItem

本頁的邊列表。 每條邊包含節點及其游標。

nodes
nodes array of ProjectedCatalogItem

本頁節點的扁平列表(不含游標元資料)。

總計數量
totalCount integer

所有頁面的總項目數量(如要求時)

頁面資訊
pageInfo PageInfo

用於游標導覽的分頁元資料。

ConnectionOfProjectedConsumptionItem

游標分頁的通用連接類型,「T」連接中項目的類型

名稱 路徑 類型 Description
邊緣
edges array of EdgeOfProjectedConsumptionItem

本頁的邊列表。 每條邊包含節點及其游標。

nodes
nodes array of ProjectedConsumptionItem

本頁節點的扁平列表(不含游標元資料)。

總計數量
totalCount integer

所有頁面的總項目數量(如要求時)

頁面資訊
pageInfo PageInfo

用於游標導覽的分頁元資料。

規劃組織的連結

游標分頁的通用連接類型,「T」連接中項目的類型

名稱 路徑 類型 Description
邊緣
edges array of EdgeOfProjectedOrganization

本頁的邊列表。 每條邊包含節點及其游標。

nodes
nodes array of ProjectedOrganization

本頁節點的扁平列表(不含游標元資料)。

總計數量
totalCount integer

所有頁面的總項目數量(如要求時)

頁面資訊
pageInfo PageInfo

用於游標導覽的分頁元資料。

ConnectionOfProjectedSubscription

游標分頁的通用連接類型,「T」連接中項目的類型

名稱 路徑 類型 Description
邊緣
edges array of EdgeOfProjectedSubscription

本頁的邊列表。 每條邊包含節點及其游標。

nodes
nodes array of ProjectedSubscription

本頁節點的扁平列表(不含游標元資料)。

總計數量
totalCount integer

所有頁面的總項目數量(如要求時)

頁面資訊
pageInfo PageInfo

用於游標導覽的分頁元資料。

EdgeOfProjectedAuditLog

在游標分頁連接中的一條邊,包含該節點及其游標。

名稱 路徑 類型 Description
節點
node ProjectedAuditLog
資料指標
cursor string

此邊的游標用於游標分頁。

EdgeOfProjectedCatalogItem

在游標分頁連接中的一條邊,包含該節點及其游標。

名稱 路徑 類型 Description
節點
node ProjectedCatalogItem
資料指標
cursor string

此邊的游標用於游標分頁。

EdgeOfProjectedConsumptionItem

在游標分頁連接中的一條邊,包含該節點及其游標。

名稱 路徑 類型 Description
節點
node ProjectedConsumptionItem
資料指標
cursor string

此邊的游標用於游標分頁。

EdgeOfProjectedOrganization(投影組織邊緣)

在游標分頁連接中的一條邊,包含該節點及其游標。

名稱 路徑 類型 Description
節點
node ProjectedOrganization
資料指標
cursor string

此邊的游標用於游標分頁。

EdgeOfProjectedSubscription

在游標分頁連接中的一條邊,包含該節點及其游標。

名稱 路徑 類型 Description
節點
node ProjectedSubscription
資料指標
cursor string

此邊的游標用於游標分頁。

EventSource

發票度量

名稱 路徑 類型 Description
期間範圍
periodRange InvoicePeriodRange
累積的經常性成本
accumulatedRecurringCost double

O(1)

發票計數
invoiceCount integer

O(1)

複利 月成本 成長率
compoundMonthlyCostGrowthRate double

O(1)

成本濃度比
costConcentrationRatio double

O(1)

成本波動率
costVolatility double

O(1)

發票期間範圍

名稱 路徑 類型 Description
寄件者
from date

O(1)

to
to date

O(1)

頁面資訊

用於游標導覽的分頁元資料。

名稱 路徑 類型 Description
有下一頁
hasNextPage boolean
有上一頁
hasPreviousPage boolean
start游標
startCursor string
結束游標
endCursor string

位置順序回應

名稱 路徑 類型 Description
requestTrackingID
requestTrackingId uuid
subscriptionIds
subscriptionIds array of uuid

PlatformRequiredParameter

名稱 路徑 類型 Description
參數描述
parameterDescription string
參數識別碼
parameterIdentifier string
參數預設值
parameterDefaultValue string
parameterFormatType
parameterFormatType string
參數格式模式
parameterFormatPattern string
parameterFormatChoices
parameterFormatChoices array of Choice

ProjectedAuditLog

名稱 路徑 類型 Description
id
id integer
targetName
targetName string
動作
action string
date
date date-time
使用者顯示名稱
userDisplayName string
類別名稱
categoryName string
說明
description string
details
details array of ProjectedAuditLogDetail

ProjectedAuditLogDetail

名稱 路徑 類型 Description
propertyName
propertyName string
oldValue
oldValue string
newValue
newValue string

預計目錄項目

名稱 路徑 類型 Description
sku
sku string

O(1)

name
name string

O(1)

說明
description string

O(1)

billingCycle
billingCycle string

O(1)

承諾期限
commitmentTerm string

O(1)

價格資訊
pricingInformation ProjectedPricingInformation
平臺
platforms array of ProjectedPlatforms

O(1) 額外呼叫

預計承諾期限

名稱 路徑 類型 Description
型別
type ProjectedCommitmentTermType
結束日期
endDate date-time
renewalConfiguration
renewalConfiguration ProjectedRenewalConfiguration

ProjectedCommitmentTermType

預計消費項目

名稱 路徑 類型 Description
產品
product string

O(1)

vendorName
vendorName string

O(1)

總計數量
totalQuantities integer

O(1)

消費量
consumedQuantities integer

O(1)

可用數量
availableQuantities integer

O(1)

預計貨幣

預計費 Dto

名稱 路徑 類型 Description
固定收費
recurringFee ProjectedMoney
setupFee
setupFee ProjectedMoney
費用:費用:重複收費
costRecurringFee ProjectedMoney
billingCycle
billingCycle string

預估金錢

名稱 路徑 類型 Description
value
value double
貨幣
currency ProjectedCurrency
進位
rounding integer

預計組織

名稱 路徑 類型 Description
id
id uuid

O(1)

name
name string

O(1)

uniqueName (唯一名稱)
uniqueName string

O(1)

parentId
parentId uuid

O(1)

parentName (父名稱)
parentName string

O(1)

暫停
suspendedOn date-time

O(n)

是被暫停的
isSuspended boolean

O(1)

已刪除
isDeleted boolean

O(1)

isActive
isActive boolean

O(n)

停賽後的日子
daysSinceSuspension integer

O(n)

訂閱計數
totalSubscriptionCount integer

O(n)

uniqueSkus
uniqueSkus array of string

O(n)

每月持續收費
totalMonthlyRecurringFee double

O(n)

總額每月成本定期費用
totalMonthlyCostRecurringFee double

O(n)

總額每年定期費用
totalYearlyRecurringFee double

O(n)

總計 年費 定期費
totalYearlyCostRecurringFee double

O(n)

總計其他定期費用
totalOtherRecurringFee double

O(n),非月費或年度計費週期的累積

總計其他成本重複收費
totalOtherCostRecurringFee double

O(n), 以非月或年計費的計費週期彙總

invoiceMetrics
invoiceMetrics InvoiceMetrics

投影平台

名稱 路徑 類型 Description
platformId
platformId uuid
必要參數
requiredParameters array of PlatformRequiredParameter

O(1) 額外呼叫

預計價格資訊

名稱 路徑 類型 Description
固定收費
recurringFee double
setupFee
setupFee double
貨幣
currency ProjectedCurrency
billingCycle
billingCycle string

ProjectedRenewalConfiguration

名稱 路徑 類型 Description
isConfigurable
isConfigurable boolean
renew設定
renewSettings ProjectedRenewSettings

投影更新設定

名稱 路徑 類型 Description
續約日期
renewalDate date-time
排程數量
scheduledQuantity integer
共同終止日期
coTerminationEndDate date-time

預計訂閱

名稱 路徑 類型 Description
subscriptionId
subscriptionId uuid

O(1)

組織ID
organizationId uuid

O(1)

cancelledOn(取消了)
cancelledOn date-time

O(n)

isActive
isActive boolean

O(n)

天自創造以來
daysSinceCreation integer

O(n)

createdOn
createdOn date-time

O(1)

數量
quantity integer

O(1)

承諾期限
commitmentTerm ProjectedCommitmentTerm
直到Renewal
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 date-time

O(n)

學費
fees ProjectedFeesDto
productName
productName string

O(1)

是共終止的
isCoterminated boolean

O(n)

歷程
history array of SubscriptionHistoryEvent

O(n)

RenewedTermEndDateDetail

名稱 路徑 類型 Description
前一日期
previousDate date
新日期
newDate date

重新更新學期起始日期詳情

名稱 路徑 類型 Description
前一日期
previousDate date
新日期
newDate date

SkuDetail

名稱 路徑 類型 Description
sku
sku string
skuName
skuName string

訂閱歷史事件

名稱 路徑 類型 Description
createdOn
createdOn date-time
許可證數量
licenseCount integer
sku
sku string
offerName
offerName string
使用者
user string
共同終止日期
coTerminationDate string
事件源
eventSource EventSource
termEndDateDetail
termEndDateDetail RenewedTermEndDateDetail
termStartDateDetail
termStartDateDetail RenewedTermStartDateDetail

訂閱修正案

名稱 路徑 類型 Description
訂閱修正案ID
subscriptionsAmendmentId uuid
trackingId
trackingId TrackingId

訂閱取消

名稱 路徑 類型 Description
訂閱取消ID
subscriptionsCancellationId uuid
trackingId
trackingId TrackingId

TrackingId

名稱 路徑 類型 Description
requestTrackingID
requestTrackingId uuid

驗證訂單行項目

名稱 路徑 類型 Description
lineNumber
lineNumber integer
sku
sku string
name
name string
billingCycle
billingCycle string
承諾期限
commitmentTerm string
數量
quantity integer
單價
unitPrice double
累計價格
extendedPrice double
貨幣
currency string

驗證排序結果

名稱 路徑 類型 Description
訊息
message string
明細項目
lineItems array of ValidateOrderLineItem
小計
subtotal double
貨幣
currency string

字串

這是基本資料類型「string」。