Windsor

官方

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

你可以用 Windsor MCP 做什么?

  • 查询实时营销数据 — 使用 get_data 通过自然语言询问 ROAS、支出或 350 多个来源的广告活动表现,无需 SQL。
  • 发现可用连接器 — 调用 get_connectors 列出已连接的账户,或使用 include_not_yet_connected=True 查看所有设置选项。
  • 查询前验证字段 — 在运行 get_data 之前,使用 get_fieldsget_options 检查字段 ID、类型和日期筛选器。
  • 执行写入操作 — 通过 execute_action 在 Meta Ads、Google Ads 和 TikTok Ads 等受支持的平台上暂停或启用广告活动并调整预算。
  • 探索操作架构 — 调用 list_actions 查看某个连接器可用的写入操作及其 JSON 参数架构。
  • 授权新数据源 — 使用 get_connector_authorization_url 获取浏览器链接以连接其他连接器。

文档

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

Windsor MCP(Model Context Protocol)是一个托管的 MCP 服务器,让您的 AI 助手无需 SQL、无需 API 密钥、无需自定义集成,即可查询、探索和分析来自 350+ 数据源的实时业务数据——包括 Meta Ads、Google Ads、TikTok Ads、GA4、HubSpot、Salesforce、Shopify、Stripe、BigQuery、Snowflake 等。在支持写操作的连接器上,代理还可以执行写操作——例如在 Meta Ads、Google Ads 和 TikTok Ads 上暂停或启用广告系列以及调整预算。

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

TL;DR

  • Claude(在 Claude 目录中)和 ChatGPT(作为 ChatGPT 应用)中的原生连接器。
  • 读写:查询 350+ 数据源的数据,并在暴露写操作的连接器上执行写操作(例如暂停/启用广告系列)。
  • 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 广告系列'Summer Sale 2026'。"
  • "将此 TikTok Ads 广告系列的每日预算削减 20%。"

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

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

通过原生 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.txtllmstxt.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 — 获取特定字段的描述、类型和表。具有 NUMERICPERCENT 类型的字段是指标(聚合);其他是维度(分组依据)。始终在调用 get_data 之前调用以验证字段 ID。
  • get_data — 对连接器运行查询。支持日期范围(date_from/date_to 或预设值如 last_30dlast_3mthis_year)、账户筛选、连接器特定选项以及带有运算符 eqneqgtgteltltecontainsncontainsnullnotnullin 的嵌套筛选条件。

少数仓库连接器(mysqlpostgresqlredshiftmongodbsnowflakebig_query)在按日期筛选时需要显式的 date_filters 参数。

写入工具 — 在暴露操作的连接器上可用(例如广告平台)。

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

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


🤝 受支持的 AI 客户端

客户端安装方式认证设置时间
Claude(桌面版、网页版、Code)一键安装 — 列于 Claude 目录中 · 设置指南OAuth 2.0约 30 秒
ChatGPT一键安装 — 列为 ChatGPT 应用 · 设置指南OAuth 2.0约 30 秒
Microsoft CopilotWindsor.ai Power Platform 连接器 — 参见集成指南API 密钥约 5 分钟
Perplexity参见设置指南OAuth 2.0约 1 分钟
Claude Codeclaude plugin install windsor-ai来源,带有斜杠命令和分析代理OAuth 2.0约 1 分钟
Cursorwindsor-ai/windsor-ai-cursor-plugin,或粘贴下面的配置 · 设置指南OAuth 2.0约 1 分钟
Manushttps://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> 传递。


📦 受支持的数据源

350+ 连接器,涵盖广告、分析、自然社交、CRM、营销自动化、电子商务、支付、联盟营销、应用分析、帮助台、生产力、数据库和数据仓库。实时完整列表: 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 账户——在 onboard.windsor.ai 注册。


选项 1:Claude(原生连接器 — 推荐)

Windsor.ai 列于 Claude 目录中。

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

前提条件

  • 一个支持连接器的套餐中的 Claude 账户(Claude Desktop、Web 或 Code)
  • 一个 Windsor.ai 账户

步骤

  1. 打开上方的安装链接(或在 Claude 中进入 设置 → 连接器,搜索 "Windsor.ai")。
  2. 你将被重定向到 Windsor.ai 通过 OAuth 授权 — 登录一次即可。
  3. 打开新对话,开始询问你的数据,例如:
    上个月我按 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 账户

步骤

  1. 打开上方的安装链接,将 Windsor.ai 添加到 ChatGPT。
  2. 通过 OAuth 授权 — 你将被重定向到 Windsor.ai 登录。
  3. 开始新对话,询问关于你已连接数据源的问题。

选项 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

步骤

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

选项 4:Cursor

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

前提条件

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

步骤

  1. 打开 Cursor 设置 → 工具与集成 → 新建 MCP 服务器
  2. 将以下内容粘贴到 mcp.json
{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}
  1. Cursor 将在首次使用时引导你完成 OAuth。立即开始查询你的数据。

选项 5:Manus

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

步骤

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

选项 6:Gemini CLI

步骤

  1. 安装 Gemini CLI:
npm install -g @google/gemini-cli
  1. 运行 gemini 一次以生成配置目录,然后编辑 ~/.gemini/settings.json
{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}
  1. 运行 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 支持哪些数据源?

350+ 个连接器,涵盖广告、分析、CRM、电商、支付、数据仓库等。实时完整列表请访问 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_actionsexecute_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 Web/Desktop、ChatGPT Web/Desktop 和 Cursor Desktop 目前完全支持;移动端 MCP 支持因客户端而异,正在逐步推出。

我在哪里可以获得帮助?

如需支持或反馈,请联系 support@windsor.ai。如需针对此仓库的 bug 报告,请提交 issue。


🧠 立即试用

通过 Windsor MCP 开始查询你的业务数据 — 最快的方式是 Claude 一键安装:

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

其他入口:

如需支持或反馈,请联系我们 support@windsor.ai