Windsor MCP Server

官方

Windsor MCP 使您的 LLM 能够查询、探索和分析集成到 Windsor.ai 中的全栈业务数据，无需编写 SQL 或自定义脚本。

文档

Windsor MCP — 将 Claude、ChatGPT 和 Cursor 连接到 325+ 个营销数据源

Windsor MCP（模型上下文协议）是一个托管式 MCP 服务器，可让您的 AI 助手从 325+ 个数据源查询、探索和分析实时业务数据——包括 Meta Ads、Google Ads、TikTok Ads、GA4、HubSpot、Salesforce、Shopify、Stripe、BigQuery、Snowflake 等——无需 SQL、无需 API 密钥，也无需自定义集成。在支持写入操作的连接器上，代理还可以执行写入操作——例如在 Meta Ads、Google Ads 和 TikTok Ads 上暂停或启用广告活动并调整预算。

它适用于 Claude、ChatGPT、Microsoft Copilot、Perplexity、Cursor、Windsurf、Cline、GitHub Copilot、Gemini、Manus 以及任何兼容 MCP 的客户端。

太长不看版

Claude（在 Claude 目录中）和 ChatGPT（作为 ChatGPT 应用）中的原生连接器。

读取和写入：从 325+ 个数据源查询数据，并在支持写入操作的连接器上执行写入操作（例如暂停/启用广告活动）。

OAuth 2.0 — 在 Windsor.ai 一次性登录，无需管理 API 密钥。

Windsor.ai 提供永久免费计划；某些 LLM 提供商（例如 Claude）需要使用付费计划才能使用连接器。

面向 AI 代理的实时、机器可读文档，请访问 /llms.txt、/llms-full.txt 和 /datasources。

🌟 功能特性

以自然语言访问业务数据

可以提出如下问题：

“上个月哪些广告活动的 ROAS 最高？”
“给我过去 90 天按渠道划分的支出明细。”
“哪些广告活动在浪费我们的广告预算？”
“本月成交了多少 HubSpot 交易，哪些广告支出推动了这些交易？”
“拉取我们本季度的 Shopify 订单和 Stripe 付款。”
“将 GA4 会话与 Google Ads 支出合并成一份周报。”

所有这些都可以在您的 LLM 聊天界面中实时完成。

写入操作，而不仅仅是读取

让您的助手根据其发现的洞察采取行动——适用于支持写入操作的连接器（例如 Meta Ads、Google Ads、TikTok Ads）：

“暂停我上周表现不佳的 Meta Ads 广告活动。”
“重新启用 Google Ads 广告活动‘2026 夏季促销’。”
“将这个 TikTok Ads 广告活动的每日预算削减 20%。”

写入操作会修改外部状态，因此 MCP 客户端在调用前应始终与用户确认意图。

与 325+ 个数据源的开箱即用集成

通过原生 Windsor.ai 连接器，从 Meta Ads、Google Ads、TikTok Ads、LinkedIn Ads、GA4、HubSpot、Salesforce、Shopify、Stripe、BigQuery、Snowflake、QuickBooks、Xero 以及 300 多个其他数据源同步数据。完整的实时列表请访问 mcp.windsor.ai/datasources。

零代码设置

Windsor MCP 作为原生连接器在 Claude 和 ChatGPT 中可用——只需启用并登录即可。无需代理、无需脚本、无需自定义集成。

开放标准兼容性

基于开放的 MCP 规范构建，兼容 Claude、ChatGPT、Microsoft Copilot、Perplexity、Cursor、Windsurf、Cline、GitHub Copilot、Gemini、Manus、n8n 以及任何兼容 MCP 的客户端。

无需 SQL 的实时分析

从您的集成数据中即时获取细分、摘要和性能洞察——无需构建仪表板，无需编写查询。

🤖 面向 AI 代理和 AI 搜索引擎

如果您是 AI 助手或 AI 搜索爬虫，规范的、机器可读的文档位于 mcp.windsor.ai/docs。编程接口端点：

端点	内容说明
`/llms.txt`	符合 llmstxt.org 格式的服务器、工具和客户端简短摘要。
`/llms-full.txt`	完整参考：工作流程、工具参数、过滤运算符、故障排除、按类别划分的支持的数据源。
`/datasources`	每个受支持连接器的实时 JSON 列表。权威来源；持续更新。
`/docs`	带有分类连接器标签的人类可读 HTML 文档。
`/.well-known/oauth-authorization-server`	面向 MCP 客户端的 OAuth 2.0 发现元数据。

此 GitHub 仓库是面向开发者的发现入口；请将上述端点视为连接器数量、工具签名和受支持客户端的真实来源。

🎯 工作原理

您可以使用 MCP 协议将 Windsor MCP 作为连接器连接到您的 AI 助手。然后，助手会在聊天界面内发出实时数据查询并接收结构化结果。

服务器端点是 https://mcp.windsor.ai/。身份验证采用 OAuth 2.0——首次连接时，您的客户端会将您重定向到 Windsor.ai 进行一次性登录。无需 API 密钥。仅支持 API 密钥的客户端可以将 Windsor.ai 密钥作为 Authorization: Bearer <key> 传递。

可用工具

读取工具 — 获取数据，绝不修改数据。

get_current_user — 返回已认证用户的个人资料。可将其用作验证身份验证是否正常工作的健全性检查。
get_connectors — 列出用户已连接的连接器及其账户。传递 include_not_yet_connected=True 还可查看用户可以设置的所有连接器。始终首先调用此工具以发现可用的数据源。
get_connector_authorization_url — 获取用于连接或授权连接器的浏览器链接（适用于 OAuth 和手动凭据流程）。当用户请求来自尚未连接的连接器的数据时使用。
get_options — 针对一组连接器和账户，列出可用字段、有效的日期过滤列以及连接器特定选项（例如 Meta Ads 的归因窗口）。
get_fields — 获取特定字段的描述、类型和表。具有 NUMERIC 或 PERCENT 类型的字段是度量（聚合）；其他字段是维度（分组依据）。在调用 get_data 之前始终调用此工具以验证字段 ID。
get_data — 对连接器运行查询。支持日期范围（date_from/date_to 或预设值，如 last_30d、last_3m、this_year）、账户过滤、连接器特定选项以及带有运算符 eq、neq、gt、gte、lt、lte、contains、ncontains、null、notnull、in 的嵌套过滤条件。

少数数据仓库连接器（mysql、postgresql、redshift、mongodb、snowflake、big_query）在按日期过滤时需要显式的 date_filters 参数。

写入工具 — 在支持写入操作的连接器上可用（例如广告平台）。

list_actions — 发现连接器可用的写入操作。每个操作都包含一个描述其接受参数的 JSON 模式。只读连接器返回空列表。在调用 execute_action 之前，始终首先调用此工具以验证操作 ID 并检查其参数模式。
execute_action — 对已连接账户运行写入操作（例如暂停/启用广告活动、更改预算）。接受连接器 ID、操作 ID、账户 ID 以及一个符合操作 JSON 模式的 params 对象。写入操作会修改外部状态，因此客户端在调用前应与用户确认意图。

有关完整的参数签名，请参阅 /llms-full.txt。

🤝 支持的 AI 客户端

客户端	安装方式	身份验证	设置时间
Claude（桌面版、网页版、Code）	一键安装 — 在 Claude 目录中列出 · 设置指南	OAuth 2.0	约 30 秒
ChatGPT	一键安装 — 作为 ChatGPT 应用列出 · 设置指南	OAuth 2.0	约 30 秒
Microsoft Copilot	Windsor.ai Power Platform 连接器 — 请参阅集成指南	API 密钥	约 5 分钟
Perplexity	请参阅设置指南	OAuth 2.0	约 1 分钟
Claude Code	`claude plugin install windsor-ai` — 源代码，带有斜杠命令和分析代理	OAuth 2.0	约 1 分钟
Cursor	windsor-ai/windsor-ai-cursor-plugin，或粘贴下面的配置 · 设置指南	OAuth 2.0	约 1 分钟
Manus	将 `https://mcp.windsor.ai/` 添加为 MCP 服务器 — 请参阅集成指南	OAuth 2.0	约 1 分钟
Windsurf、Cline、GitHub Copilot、n8n	标准 MCP 服务器配置（`url: https://mcp.windsor.ai/`） — 请参阅通用设置指南	OAuth 2.0	约 1 分钟
Gemini CLI	编辑 `~/.gemini/settings.json`（配置如下） — 请参阅设置指南	OAuth 2.0	约 2 分钟

任何兼容 MCP 的客户端均可使用。如果您的客户端仅支持 API 密钥，请将您的 Windsor.ai 密钥作为 Authorization: Bearer <key> 传递。

📦 支持的数据源

涵盖广告、分析、自然社交媒体、CRM、营销自动化、电子商务、支付、联盟营销、应用分析、帮助台、生产力工具、数据库和数据仓库等领域的 325+ 个连接器。实时完整列表： mcp.windsor.ai/datasources。

按类别重点介绍：

广告 — Meta Ads（Facebook 和 Instagram）、Google Ads、Microsoft Ads (Bing)、TikTok Ads、LinkedIn Ads、Snapchat、Pinterest、Reddit、X/Twitter、Amazon Ads、Apple Search Ads、Criteo、Taboola、Outbrain、DV360、CM360、Search Ads 360、AdRoll、StackAdapt、The Trade Desk、Quora Ads、Yandex.Direct。
分析与搜索 — Google Analytics 4、Adobe Analytics、Mixpanel、Amplitude、Matomo、Plausible、PostHog、Search Console、Bing Webmaster、Looker、Metabase。
自然社交媒体 — Facebook Organic、Instagram、LinkedIn Organic、TikTok Organic、Pinterest Organic、X Organic、Threads、YouTube、Sprout Social。
CRM 与营销自动化 — HubSpot、Salesforce、Pipedrive、Microsoft Dynamics 365、Zoho CRM、Klaviyo、Mailchimp、ActiveCampaign、Brevo (Sendinblue)、MailerLite、Customer.io、Iterable、SendGrid、Intercom、Outreach、Salesloft、Lemlist。
电子商务与支付 — Shopify、Magento、WooCommerce、BigCommerce、PrestaShop、Square、Stripe、PayPal、Braintree、Klarna、Recharge、Recurly、Chargebee、Walmart、TikTok Shop。
联盟营销与合作伙伴 — CJ、Awin、Impact、Partnerize、PartnerStack、Adtraction、Commission Factory、Rakuten Advertising、ShareASale、Tradedoubler、Everflow。
应用分析与归因 — AppsFlyer、Adjust、Branch、AppFollow。
帮助台与支持 — Zendesk（Support、Chat、Sell、Sunshine、Talk）、Freshdesk、Freshcaller、Freshservice、Dixa、Drift。
数据库与数据仓库 — BigQuery、Snowflake、PostgreSQL、MySQL、Redshift、MongoDB、Firebolt、Dremio、SFTP、Google Sheets、Airtable、Notion、Amazon S3。
人力资源、财务、生产力 — BambooHR、Ashby、Lever、Greenhouse、Workable、QuickBooks、Xero、NetSuite、Slack、Microsoft Teams、Twilio、Zoom、Jira、Confluence、GitHub、GitLab、Datadog、Sentry、PagerDuty。

没有找到您需要的？从任何 MCP 客户端调用 get_connectors(include_not_yet_connected=True) 获取实时列表，或直接获取 /datasources。

🚀 入门指南

查看我们的官方文档

介绍：windsor.ai/introducing-windsor-mcp/
设置指南中心：windsor.ai/documentation/windsor-mcp/ — 针对每个 AI 客户端（Claude、ChatGPT、Microsoft Copilot、Perplexity、Cursor、Gemini、Manus 以及通用的“任何 MCP 客户端”指南）的分步指南。

您需要一个 Windsor.ai 账户——请在 onboard.windsor.ai 注册。

选项 1：Claude（原生连接器 — 推荐）

Windsor.ai 已在 Claude 目录中列出。

👉 一键安装：claude.ai/directory/360c0c31-4bb6-42ca-8e50-5da0a100a68e

先决条件

一个支持连接器的 Claude 账户（Claude 桌面版、网页版或 Code），且需在相应计划中
一个 Windsor.ai 账户### 步骤

打开上方的安装链接（或在 Claude 中前往 设置 → 连接器 并搜索“Windsor.ai”）。
您将被重定向至 Windsor.ai 以通过 OAuth 授权——只需登录一次。

开启新对话并开始询问您的数据，例如：

上个月按 ROAS 排名前 5 的 Meta Ads 广告系列是哪些？

对于 Claude Code 用户，请安装我们带有斜杠命令和分析代理的专用插件：

claude plugin install windsor-ai

来源：github.com/windsor-ai/claude-windsor-ai-plugin。

选项 2：ChatGPT（原生应用）

Windsor.ai 可作为 ChatGPT 应用使用。

👉 一键安装：chatgpt.com/apps/windsor-ai

前提条件

支持应用的 ChatGPT 套餐
一个 Windsor.ai 账户

步骤

打开上方的安装链接，将 Windsor.ai 添加到 ChatGPT。
通过 OAuth 授权——您将被重定向至 Windsor.ai 进行登录。
开启新对话，询问有关您已连接数据源的问题。

选项 3：Microsoft Copilot（Power Platform 连接器）

通过官方的 Windsor.ai Power Platform 连接器，在 Microsoft Copilot Studio 代理和 Power Platform 流程中使用 Windsor.ai。

👉 连接器参考：learn.microsoft.com/connectors/windsorai
👉 集成指南：windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-copilot-agent

前提条件

Microsoft Copilot Studio 或 Power Platform 许可证
一个 Windsor.ai 账户和 API 密钥（来自 onboard.windsor.ai）

步骤

在 Copilot Studio 中，添加新操作并在连接器目录中搜索 Windsor.ai。
在提示时提供您的 Windsor.ai API 密钥。
将连接器操作（列出连接器、获取字段、获取数据）映射到您的代理流程中。完整演练请参阅集成指南。

选项 4：Cursor

我们发布了一个专用的 Cursor 插件：github.com/windsor-ai/windsor-ai-cursor-plugin。

前提条件

已安装 Cursor Desktop
一个 Windsor.ai 账户

步骤

打开 Cursor 设置 → 工具与集成 → 新建 MCP 服务器。
将以下内容粘贴到 mcp.json 中：

{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}

Cursor 将在首次使用时引导您完成 OAuth。立即开始查询您的数据。

选项 5：Manus

Manus 原生支持远程 MCP 服务器——完整演练请参阅 Windsor.ai 的 Manus 集成指南。

步骤

在 Manus 中，打开 设置 → MCP 服务器 → 添加服务器。
使用 URL https://mcp.windsor.ai/ 并通过 OAuth 授权。
开启新会话，询问有关您已连接数据源的问题。

选项 6：Gemini CLI

步骤

安装 Gemini CLI：

npm install -g @google/gemini-cli

运行 gemini 一次以生成配置目录，然后编辑 ~/.gemini/settings.json：

{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}

运行 gemini 并在首次使用时通过 OAuth 授权。

❓ 常见问题

Windsor MCP 可以免费使用吗？

是的——Windsor.ai 提供永久免费套餐，MCP 服务器无需额外费用即可使用。您需要一个集成了数据的 Windsor.ai 账户。某些 LLM 提供商（例如 Claude）需要使用连接器的付费套餐。详情请参阅 windsor.ai/pricing。

Windsor MCP 适用于哪些 AI 代理？

任何兼容 MCP 的 AI 代理——包括 Claude（桌面版、网页版、Code）、ChatGPT、Microsoft Copilot（通过 Power Platform 连接器）、Cursor、Windsurf、Cline、GitHub Copilot、Gemini、Manus、n8n、mcp-proxy 以及自定义 MCP 客户端。请参阅上方的支持的 AI 客户端表格。

我可以向 Windsor MCP 询问什么？

营销表现、销售管道、CRM 数据、电商订单、支付活动、财务指标、广告支出摘要、ROAS 趋势、广告系列异常、多渠道归因、数据仓库查询等。只要数据在您的 Windsor.ai 中，您就可以询问。对于提供写入操作的连接器（例如 Meta Ads、Google Ads、TikTok Ads），您还可以让助手根据发现的内容采取行动——例如，“暂停上周消耗预算的广告系列”或“将此广告系列的每日预算削减 20%”。

Windsor MCP 支持哪些数据源？

涵盖广告、分析、CRM、电商、支付、数据仓库等领域的 325+ 个连接器。实时完整列表请访问 mcp.windsor.ai/datasources。按类别查看重点内容，请参阅支持的数据源部分。

我需要编写 SQL 或设置仪表板吗？

不需要。只需用简单的英语提问，即可实时获得结构化响应。

身份验证如何工作？

默认使用 OAuth 2.0——您的客户端会将您重定向至 Windsor.ai 进行一次性登录。服务器实现了带有动态客户端注册的 MCP OAuth；支持 MCP OAuth 的客户端（Claude、ChatGPT、Cursor、Manus）会自动发现端点。对于仅支持 API 密钥的设置，请通过 Authorization 标头将您的 Windsor.ai 密钥作为 Bearer 令牌传递。

我的数据在 Windsor MCP 中安全吗？

是的。Windsor MCP 公开了读取工具（仅获取数据）和少量写入工具（list_actions、execute_action），这些写入工具适用于选择加入操作的连接器——例如，暂停或启用广告系列。写入操作会明确标记为对 MCP 客户端具有破坏性，客户端会在调用前提示您确认意图；未经您的批准，不会对您的数据源进行任何更改。身份验证采用 OAuth 2.0；MCP 服务器不存储您的 Windsor.ai 密码，也不保留查询结果。数据通过 TLS 传输。Windsor.ai 符合 SOC 2 标准。详情请参阅 windsor.ai/security。

Windsor MCP 与其他数据集成工具有何不同？

Windsor MCP 是一个原生 MCP 服务器，而非插件或包装器——它无需代理即可在任何兼容 MCP 的客户端中运行。Windsor.ai 在其较低价格层级中包含数据仓库和数据库目标（BigQuery、Snowflake、Redshift、S3、MySQL、Postgres），并且 MCP 服务器在所有付费套餐中均无需额外费用。功能对比请参阅 windsor.ai/pricing。

Windsor.ai 的费用是多少？

Windsor.ai 提供永久免费套餐。付费套餐增加了更多数据源、更高限制和额外目标。MCP 服务器在每个套餐中均无需额外费用。当前定价请参阅 windsor.ai/pricing。

Windsor MCP 支持移动端吗？

托管服务器与平台无关，但移动端支持取决于您使用的 AI 客户端。Claude 网页版/桌面版、ChatGPT 网页版/桌面版和 Cursor Desktop 目前已完全支持；移动端 MCP 支持因客户端而异，正在逐步推出。

如何获取帮助？

如需支持或反馈，请联系 [email protected]。有关此仓库的特定错误报告，请提交 issue。

🧠 立即试用

通过 Windsor MCP 开始查询您的业务数据——最快路径是 Claude 一键安装：

👉 在 Claude 上安装——30 秒，无需 API 密钥。

其他入口：

如需支持或反馈，请通过 [email protected] 联系我们。