Windsor.ai

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

Windsor MCP（Model Context Protocol）是托管式 MCP 服务，可让你的 AI 助手查询、探索和分析来自 350 多个来源的实时业务数据，包括 Meta Ads、Google Ads、TikTok Ads、GA4、HubSpot、Salesforce、Shopify、Stripe、BigQuery、Snowflake 等，无需 SQL、API 密钥或自定义集成。在支持此功能的连接器上，Agent 还可以执行写入操作，例如在 Meta Ads、Google Ads、TikTok Ads、LinkedIn Ads 和 Microsoft Ads（Bing）上创建和管理广告系列及预算；发布 Instagram 帖子；管理 Google Business Profile 商家信息和评论；更新 Klaviyo 流程和 Salesforce 记录等。

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

简而言之

• Claude（在 Claude 目录中）和 ChatGPT（作为 ChatGPT 应用）均提供原生连接器。
• 读取和写入：查询来自 350 多个来源的数据，并在提供写入操作的连接器上执行写入操作（例如暂停／启用广告系列）。
• OAuth 2.0——只需在 Windsor.ai 登录一次，无需管理 API 密钥。
• Windsor.ai 提供永久免费套餐；部分 LLM 提供商（例如 Claude）要求使用付费套餐才能使用连接器。
• 面向 AI Agent 的实时机器可读文档：/llms.txt、/llms-full.txt 和 /datasources。

---

🌟 功能

以自然语言访问业务数据

可以提出如下问题：

• “上个月哪些广告系列的 ROAS 最好？”
• “按渠道汇总过去 90 天的支出。”
• “哪些广告系列浪费了我们的广告预算？”
• “本月有多少 HubSpot 交易已成交？哪些广告支出促成了这些交易？”
• “调取本季度的 Shopify 订单和 Stripe 付款。”
• “将 GA4 会话数与 Google Ads 支出合并成每周报告。”

所有操作都在你的 LLM 聊天界面中直接实时完成。

不只是读取，还能执行写入操作

对于提供写入操作的连接器，可以让助手根据其发现的洞察采取行动：

• “暂停我上周表现不佳的 Meta Ads 广告系列。”
• “重新启用名为 ‘Summer Sale 2026’ 的 Google Ads 广告系列。”
• “将这个 TikTok Ads 广告系列的每日预算削减 20%。”
• “将这些词设为该 Google Ads 广告系列的否定关键字。”
• “暂停本月 CTR 最低的 LinkedIn Ads 广告系列。”
• “回复我们最新的一星 Google Business Profile 评论，但要先让我批准。”
• “启用这个 Klaviyo 流程。”
• “将这张图片发布到我们的 Instagram 账号。”

目前支持实时写入操作的连接器：Meta Ads（Facebook 和 Instagram Ads——创建／暂停／启用广告系列、广告组和广告，设置预算，推广帖子）、Google Ads（创建广告系列／广告组／广告，暂停／启用，设置预算、出价策略、广告时段、语言定向、关键字和 Customer Match 受众）、TikTok Ads（暂停／启用，设置广告系列和广告组预算）、LinkedIn Ads（暂停／启用广告系列组／广告系列／创意，设置预算）、Microsoft Ads / Bing（暂停／启用，设置广告系列预算）、Instagram（创建图片／视频／轮播／快拍帖子和评论）、Google Business Profile（本地帖子、评论回复、照片、营业时间和营业状态）、Klaviyo（创建流程、设置流程状态）、Salesforce（更新对象字段）、Amazon DSP（创建／更新广告系列）、Amazon Seller Central（更新商品信息）以及 WordPress（帖子、页面、分类、标签）。其他连接器仅支持读取；list_actions 始终会反映指定连接器当前权威的操作列表。

写入操作会修改外部状态，因此 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 Agent 和 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 密钥的客户端可以通过 Authorization: Bearer <key> 传入 Windsor.ai 密钥。

可用工具

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

• 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 参数。

写入工具 — 适用于提供操作的连接器（例如广告平台、Google Business Profile、Klaviyo、Salesforce、WordPress — 当前列表请参阅上文的 写入操作（不只是读取） 部分）。

• list_actions — 发现连接器可用的写入操作。每项操作都包含描述其接受参数的 JSON schema。只读连接器会返回空列表。调用 execute_action 前，请始终先调用此工具以验证操作 ID 并检查其参数 schema。
• execute_action — 对已连接的账户执行写入操作（例如暂停/启用广告系列、更改预算）。需要传入连接器 ID、操作 ID、账户 ID，以及结构符合该操作 JSON schema 的 params 对象。写入操作会修改外部状态，因此客户端在调用前应先向用户确认其意图。

连接与账户工具 — 无需离开聊天即可管理连接和 Windsor.ai 账户。

• get_connector_connect_info — 获取连接器的身份验证类型、连接 URL，以及（对于手动/API 密钥连接器）所需的凭据字段；不会进行连接。
• get_windsor_login_url — 获取用户 Windsor.ai 控制面板的自动登录链接。
• get_subscription_url — 获取指向 Windsor.ai 定价页面或套餐升级页面的 Markdown 链接。只返回链接，不会发起购买或更改套餐。
• contact_windsor — 向 Windsor.ai 发送支持、反馈或功能请求消息，并获取相应的参考 ID。

定时导出工具 — 直接在聊天中设置将连接器数据定期导出到目标位置。

• get_destinations — 列出可接收定时导出的目标位置（例如 BigQuery、Google Sheets、Snowflake、数据库、存储），以及已设置的可复用凭据。
• get_destination_setup_info — 获取新建定时导出所需的设置要求：目标字段、允许的计划、可复用凭据和设置 URL。
• get_destination_tasks — 列出用户现有的定时导出任务，包括目标位置、连接器、计划和状态。
• create_destination_task — 按计划创建将连接器数据定期导出到目标位置的任务。

完整的参数签名请参阅 /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 — 源代码，包含斜杠命令和分析师 Agent	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、营销自动化、电商、支付、联盟营销、应用分析、服务台、生产力工具、数据库和数据仓库的 350 多个连接器。实时完整列表： 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 Desktop、Web 或 Code）
• Windsor.ai 账户

步骤

1. 打开上方的安装链接（或在 Claude 中前往 设置 → 连接器，搜索“Windsor.ai”）。
2. 系统会将你重定向至 Windsor.ai，通过 OAuth 授权 — 登录一次即可。
3. 打开新聊天，开始询问有关你数据的问题，例如：

   上个月 ROAS 最高的 5 个 Meta Ads 广告系列是什么？
   

Claude Code 用户可安装我们的专用插件，其中包含斜杠命令和分析师 Agent：

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 Agent 和 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. 将连接器操作（列出连接器、获取字段、获取数据）映射到 Agent 的流程中。完整操作步骤请参阅集成指南。

---

选项 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/"
    }
  }
}

3. 首次使用时，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

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

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

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

---

❓ 常见问题

Windsor MCP 可以免费使用吗？

可以 — Windsor.ai 提供永久免费计划，MCP 服务也包含在内，无需额外付费。你需要拥有一个已集成数据的 Windsor.ai 账户。某些大模型提供商（例如 Claude）要求使用付费计划才能使用连接器。详情请参阅 windsor.ai/pricing。

Windsor MCP 支持哪些 AI Agent？

任何兼容 MCP 的 AI Agent — 包括 Claude（Desktop、Web、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、LinkedIn Ads、Microsoft Ads/Bing、Instagram、Google Business Profile、Klaviyo、Salesforce、Amazon DSP、Amazon Seller Central、WordPress），你还可以让助手根据查到的内容采取行动，例如“暂停上周消耗预算的广告活动”“将此广告活动的每日预算削减 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_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 Web/Desktop、ChatGPT Web/Desktop 和 Cursor Desktop；各客户端对移动端 MCP 的支持情况不一，相关支持仍在逐步推出。

如何获得帮助？

如需支持或反馈，请联系 [email protected]。若要报告与此代码库相关的错误，请提交 issue。

---

🧠 立即体验

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

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

其他入口：

• 👉 在 ChatGPT 上安装
• 👉 Microsoft Copilot 连接器（集成指南）
• 👉 Manus 集成指南
• 👉 Claude Code 插件
• 👉 Cursor 插件
• 👉 获取 Windsor.ai API 密钥
• 👉 观看演示
• 👉 面向 AI 的实时文档

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