使用说明
温莎MCP服务器
Cloudflare Worker作为独立的MCP服务器，用于 Windsor.ai，直接调用Windsor REST API。完全绕过温莎的官方MCP服务器及其损坏的OAuth身份验证。
部署一次，您的整个团队将通过以下方式连接 Claude.ai→ 设置→ 集成 --不需要每台机器的配置。
运作原理
Claude.ai (any team member) → Cloudflare Worker → Windsor REST API (connectors.windsor.ai)
Worker是一个包含5个工具的完整MCP服务器。它使用您的常规API密钥直接与Windsor的稳定REST API对话。没有OAuth，没有同意令牌，没有令牌刷新——正是这些东西一直在崩溃。
- 没有持久对象，没有KV——在Cloudflare上运行 免费方案
- 作为远程MCP服务器工作——无需在团队成员的计算机上安装任何东西
可用工具
| 工具 | 说明 |
|---|---|
list_connectors |
列出所有可用的数据连接器（脸书、谷歌广告、GA4等） |
get_fields |
获取特定连接器的可用数据字段 |
get_options |
获取连接器的配置选项 |
get_data |
使用过滤器、日期范围和聚合查询营销/分析数据 |
list_accounts |
列出工作区中所有链接的数据源帐户 |
设置
先决条件
- Node.js （v18+）
- A. Cloudflare帐户 （免费版作品）
- A. Windsor.ai API密钥
1.安装依赖项
cd windsor-mcp-proxy
npm install
2.登录Cloudflare
npx wrangler login
3.将您的Windsor API密钥设置为秘密
npx wrangler secret put WINDSOR_API_KEY
提示时粘贴您的Windsor API密钥。这是由Cloudflare加密存储的，永远不会暴露在您的代码或仓库中。
4.部署
npm run deploy
注意部署后打印的URL——它看起来像：
https://windsor-mcp-proxy.<your-subdomain>.workers.dev
5.测试
curl -X POST https://windsor-mcp-proxy.<your-subdomain>.workers.dev/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
你应该拿回MCP initialize 温莎AI服务器功能的响应。
连接您的团队
部署后，任何团队成员都可以在几秒钟内连接——没有桌面配置文件，也没有本地安装。
Claude.ai（网络版）
- 首选 Claude.ai→ 设置→ 集成
- 点击 添加自定义集成 （或 添加更多)
- 输入您的Worker URL作为MCP服务器端点：
https://windsor-mcp-proxy.<your-subdomain>.workers.dev/mcp - 温莎工具立即出现在聊天中
克劳德团队/组织
如果你在克劳德团队或企业计划中，管理员可以在组织级别添加一次集成，这样所有团队成员都可以自动使用。
查询示例
连接后，您可以问Claude以下问题：
- “上个月哪些竞选活动的ROAS最好？”
- “显示过去90天按渠道消费的情况”
- “列出我所有连接的数据源”
- “google_ads有哪些可用字段？”
- “比较本季度脸书和谷歌广告的表现”
本地开发
npm run dev
这将在以下位置启动本地工人 http://localhost:8787 用于测试。您需要在本地设置密钥：
echo 'WINDSOR_API_KEY = "your-key-here"' > .dev.vars
(.dev.vars 被忽视，从未承诺。)
更新您的API密钥
如果您的Windsor API密钥发生变化：
npx wrangler secret put WINDSOR_API_KEY
Worker立即获取新密钥，无需重新部署。
许可证
麻省理工学院
