Windsor
官方Windsor MCP 使您的 LLM 能够查询、探索和分析集成到 Windsor.ai 中的全栈业务数据，无需编写 SQL 或自定义脚本。
你可以用 Windsor MCP 做什么？
- 查询营销数据 — 使用自然语言通过
get_data查询超过 350 个数据源的活动表现、ROAS 或支出明细。 - 发现可用连接器 — 使用
get_connectors列出已连接的账户，或通过include_not_yet_connected=True探索所有设置选项。 - 执行写入操作 — 通过
execute_action在 Meta Ads 或 Google Ads 等支持的平台上暂停表现不佳的广告活动或调整预算。 - 检查可查询字段 — 在运行报告前使用
get_fields验证字段 ID 和类型，确保数据拉取准确。 - 安排定期导出 — 使用
create_destination_task设置自动数据导出到 BigQuery 或 Google Sheets 等目标位置。 - 管理连接 — 使用
get_connector_authorization_url生成授权链接，或通过get_windsor_login_url获取仪表盘访问权限。
托管 MCP 服务器
npx add-mcp 'https://mcp.windsor.ai'可安装到 Claude Code、Codex、Cursor 等客户端
文档
Windsor MCP — 将 Claude、ChatGPT 和 Cursor 连接到 350+ 营销数据源
Windsor MCP（模型上下文协议）是一个托管的 MCP 服务器，可让您的 AI 助手查询、探索和分析来自 350+ 数据源的实时业务数据——包括 Meta Ads、Google Ads、TikTok Ads、GA4、HubSpot、Salesforce、Shopify、Stripe、BigQuery、Snowflake 等——无需 SQL、无需 API 密钥、无需自定义集成。在支持写操作的连接器上，代理还可以执行写操作——例如在 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 的客户端。
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 广告系列 'Summer Sale 2026'。"
- "将这个 TikTok Ads 广告系列的每日预算削减 20%。"
- "将这些作为否定关键词推送到那个 Google Ads 广告系列。"
- "暂停本月点击率最低的 LinkedIn Ads 广告系列。"
- "在我批准后，回复我们最新的 1 星 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 代理和 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 参数。
写入工具 — 适用于暴露操作的连接器（例如广告平台、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 — 来源，带斜杠命令和分析代理 | 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> 传入。
📦 受支持的数据源
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/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 账户
步骤
- 打开上面的安装链接（或前往 Claude 中的 设置 → 连接器 并搜索“Windsor.ai”）。
- 你将被重定向到 Windsor.ai 通过 OAuth 授权 — 登录一次即可。
- 开启新对话并开始询问你的数据，例如：
上个月我的 Meta Ads 中 ROAS 排名前 5 的广告系列是哪些？
对于 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（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 支持因客户端而异，正在逐步推出。
我在哪里可以获得帮助？
如需支持或反馈，请联系 support@windsor.ai。对于与此仓库相关的错误报告，请提交 issue。
🧠 立即尝试
通过 Windsor MCP 开始查询你的业务数据 — 最快路径是 Claude 一键安装：
👉 在 Claude 上安装 — 30 秒，无需 API 密钥。
其他入口：
- 👉 在 ChatGPT 上安装
- 👉 Microsoft Copilot 连接器（集成指南）
- 👉 Manus 集成指南
- 👉 Claude Code 插件
- 👉 Cursor 插件
- 👉 获取 Windsor.ai API 密钥
- 👉 观看演示
- 👉 实时 AI 定向文档
如需支持或反馈，请联系我们 support@windsor.ai。