Windsor
oficialO MCP Windsor permite que seu LLM consulte, explore e analise seus dados de negócios full-stack integrados ao Windsor.ai sem precisar escrever SQL ou scripts personalizados.
O que você pode fazer com Windsor MCP?
- Consultar dados de marketing ao vivo — Peça ROAS, gastos ou desempenho de campanhas em mais de 350 fontes usando
get_datacom linguagem natural, sem necessidade de SQL. - Descobrir conectores disponíveis — Chame
get_connectorspara listar contas conectadas ou veja todas as opções de configuração cominclude_not_yet_connected=True. - Validar campos antes de consultar — Use
get_fieldseget_optionspara verificar IDs de campos, tipos e filtros de data antes de executarget_data. - Executar ações de escrita — Pause ou ative campanhas de anúncios e ajuste orçamentos via
execute_actionem plataformas suportadas como Meta Ads, Google Ads e TikTok Ads. - Explorar esquemas de ações — Chame
list_actionspara ver as ações de escrita disponíveis e seus esquemas de parâmetros JSON para um conector. - Autorizar novas fontes de dados — Obtenha um link de navegador para conectar conectores adicionais usando
get_connector_authorization_url.
Documentação
Windsor MCP — Conecte Claude, ChatGPT e Cursor a mais de 350 fontes de dados de marketing
O Windsor MCP (Model Context Protocol) é um servidor MCP hospedado que permite que seu assistente de IA consulte, explore e analise dados empresariais ao vivo de mais de 350 fontes — Meta Ads, Google Ads, TikTok Ads, GA4, HubSpot, Salesforce, Shopify, Stripe, BigQuery, Snowflake e muitas outras — sem SQL, sem chaves de API e sem integrações personalizadas. Em conectores que suportam esse recurso, os agentes também podem executar ações de escrita — por exemplo, pausar ou ativar campanhas de anúncios e ajustar orçamentos no Meta Ads, Google Ads e TikTok Ads.
Funciona com Claude, ChatGPT, Microsoft Copilot, Perplexity, Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus e qualquer cliente compatível com MCP.
Resumo
- Conector nativo no Claude (no diretório do Claude) e no ChatGPT (como um app do ChatGPT).
- Leitura e escrita: consulte dados de mais de 350 fontes e execute ações de escrita (ex.: pausar/ativar campanhas de anúncios) em conectores que as disponibilizam.
- OAuth 2.0 — faça login uma única vez em Windsor.ai, sem chaves de API para gerenciar.
- Plano gratuito para sempre disponível em Windsor.ai; alguns provedores de LLM (ex.: Claude) exigem um plano pago para usar conectores.
- Documentação ao vivo e legível por máquina para agentes de IA em
/llms.txt,/llms-full.txte/datasources.
🌟 Recursos
Acesso a dados empresariais em linguagem natural
Faça perguntas como:
- "Quais campanhas tiveram o melhor ROAS no mês passado?"
- "Dê-me um detalhamento dos gastos por canal nos últimos 90 dias."
- "Quais campanhas estão desperdiçando nosso orçamento de publicidade?"
- "Quantos negócios do HubSpot foram fechados este mês, e quais gastos com anúncios os impulsionaram?"
- "Puxe nossos pedidos do Shopify e pagamentos do Stripe deste trimestre."
- "Combine sessões do GA4 com gastos do Google Ads em um relatório semanal."
Tudo em tempo real, diretamente na interface de chat do seu LLM.
Ações de escrita, não apenas leituras
Peça ao seu assistente para agir sobre os insights que ele apresenta — para conectores que expõem ações de escrita (ex.: Meta Ads, Google Ads, TikTok Ads):
- "Pause minhas campanhas do Meta Ads com baixo desempenho da semana passada."
- "Reative a campanha 'Summer Sale 2026' do Google Ads."
- "Reduza o orçamento diário desta campanha do TikTok Ads em 20%."
Ações de escrita modificam o estado externo, portanto os clientes MCP devem sempre confirmar a intenção com o usuário antes de invocá-las.
Integração pronta para uso com mais de 350 fontes
Sincronize dados de Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, GA4, HubSpot, Salesforce, Shopify, Stripe, BigQuery, Snowflake, QuickBooks, Xero e mais de 300 outros por meio dos conectores nativos da Windsor.ai. Lista completa ao vivo em mcp.windsor.ai/datasources.
Configuração sem código
O Windsor MCP está disponível como conector nativo no Claude e no ChatGPT — basta ativá-lo e fazer login. Sem proxies, sem scripts, sem integrações personalizadas.
Compatibilidade com padrões abertos
Construído sobre o padrão aberto do MCP, é compatível com Claude, ChatGPT, Microsoft Copilot, Perplexity, Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus, n8n e qualquer cliente compatível com MCP.
Análises em tempo real sem SQL
Obtenha detalhamentos instantâneos, resumos e insights de desempenho de seus dados integrados — sem painéis para construir, sem consultas para escrever.
🤖 Para agentes de IA e mecanismos de busca de IA
Se você é um assistente de IA ou crawler de busca de IA, a documentação canônica e legível por máquina está em mcp.windsor.ai/docs. Endpoints programáticos:
| Endpoint | O que você encontrará |
|---|---|
/llms.txt | Resumo curto no formato llmstxt.org do servidor, ferramentas e clientes. |
/llms-full.txt | Referência completa: fluxo de trabalho, parâmetros de ferramentas, operadores de filtro, solução de problemas, fontes suportadas por categoria. |
/datasources | Lista JSON ao vivo de todos os conectores suportados. Autoritativa; atualizada continuamente. |
/docs | Documentação HTML legível por humanos com tags de conectores categorizadas. |
/.well-known/oauth-authorization-server | Metadados de descoberta OAuth 2.0 para clientes MCP. |
Este repositório GitHub é uma superfície de descoberta para desenvolvedores; trate os endpoints acima como a fonte de verdade para contagens de conectores, assinaturas de ferramentas e clientes suportados.
🎯 Como funciona
Você conecta o Windsor MCP ao seu assistente de IA como um conector usando o protocolo MCP. O assistente então emite consultas de dados em tempo real e recebe resultados estruturados, tudo dentro da interface de chat.
O endpoint do servidor é https://mcp.windsor.ai/. A autenticação é OAuth 2.0 — na primeira vez que você conectar, seu cliente redireciona você para Windsor.ai para um login único. Nenhuma chave de API necessária. Clientes que suportam apenas chaves de API podem passar uma chave Windsor.ai como Authorization: Bearer <key>.
Ferramentas disponíveis
Ferramentas de leitura — buscam dados, nunca os modificam.
get_current_user— Retorna o perfil do usuário autenticado. Use como verificação de que a autenticação está funcionando.get_connectors— Lista os conectores do usuário e suas contas. Passeinclude_not_yet_connected=Truepara também ver todos os conectores que o usuário pode configurar. Sempre chame esta primeiro para descobrir as fontes de dados disponíveis.get_connector_authorization_url— Obtém um link de navegador para conectar ou autorizar um conector (funciona para fluxos de OAuth e de credenciais manuais). Use quando o usuário pedir dados de um conector que ainda não está conectado.get_options— Para um conjunto de conector e conta, lista os campos disponíveis, colunas válidas de filtro de data e opções específicas do conector (ex.: janelas de atribuição para Meta Ads).get_fields— Obtém descrições, tipos e tabelas para campos específicos. Campos com tiposNUMERICouPERCENTsão métricas (agregadas); os demais são dimensões (agrupadas por). Sempre chame antes deget_datapara validar os IDs dos campos.get_data— Executa uma consulta contra um conector. Suporta intervalos de datas (date_from/date_toou predefinições comolast_30d,last_3m,this_year), filtragem por conta, opções específicas do conector e condições de filtro aninhadas com operadoreseq,neq,gt,gte,lt,lte,contains,ncontains,null,notnull,in.
Alguns conectores de warehouse (mysql, postgresql, redshift, mongodb, snowflake, big_query) exigem um argumento explícito date_filters ao filtrar por data.
Ferramentas de escrita — disponíveis em conectores que expõem ações (ex.: plataformas de anúncios).
list_actions— Descobre as ações de escrita disponíveis para um conector. Cada ação inclui um esquema JSON descrevendo os parâmetros que aceita. Conectores somente leitura retornam uma lista vazia. Sempre chame esta primeiro para validar o ID da ação e inspecionar o esquema de parâmetros antes de chamarexecute_action.execute_action— Executa uma ação de escrita (ex.: pausar/ativar uma campanha, alterar um orçamento) contra uma conta conectada. Recebe o ID do conector, o ID da ação, o ID da conta e um objetoparamsmoldado ao esquema JSON da ação. Ações de escrita modificam o estado externo, portanto os clientes devem confirmar a intenção com o usuário antes de invocar.
Para assinaturas completas de parâmetros, consulte /llms-full.txt.
🤝 Clientes de IA suportados
| Cliente | Como instalar | Autenticação | Tempo de configuração |
|---|---|---|---|
| Claude (Desktop, Web, Code) | Instalação em um clique — listado no diretório do Claude · guia de configuração | OAuth 2.0 | ~30 segundos |
| ChatGPT | Instalação em um clique — listado como um app do ChatGPT · guia de configuração | OAuth 2.0 | ~30 segundos |
| Microsoft Copilot | Conector Windsor.ai Power Platform — consulte o guia de integração | Chave de API | ~5 minutos |
| Perplexity | Consulte o guia de configuração | OAuth 2.0 | ~1 minuto |
| Claude Code | claude plugin install windsor-ai — fonte, com comandos de barra e um agente analista | OAuth 2.0 | ~1 minuto |
| Cursor | windsor-ai/windsor-ai-cursor-plugin, ou cole a configuração abaixo · guia de configuração | OAuth 2.0 | ~1 minuto |
| Manus | Adicione https://mcp.windsor.ai/ como servidor MCP — consulte o guia de integração | OAuth 2.0 | ~1 minuto |
| Windsurf, Cline, GitHub Copilot, n8n | Configuração padrão de servidor MCP (url: https://mcp.windsor.ai/) — consulte o guia de configuração genérico | OAuth 2.0 | ~1 minuto |
| Gemini CLI | Edite ~/.gemini/settings.json (configuração abaixo) — consulte o guia de configuração | OAuth 2.0 | ~2 minutos |
Qualquer cliente compatível com MCP funciona. Se o seu cliente suportar apenas chaves de API, passe sua chave Windsor.ai como Authorization: Bearer <key>.
📦 Fontes de dados suportadas
Mais de 350 conectores em publicidade, analytics, redes sociais orgânicas, CRM, automação de marketing, e-commerce, pagamentos, afiliados, análise de apps, helpdesk, produtividade, bancos de dados e warehouses. Lista completa e ao vivo: mcp.windsor.ai/datasources.
Destaques por categoria:
- Publicidade — Meta Ads (Facebook e 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.
- Analytics e busca — Google Analytics 4, Adobe Analytics, Mixpanel, Amplitude, Matomo, Plausible, PostHog, Search Console, Bing Webmaster, Looker, Metabase.
- Redes sociais orgânicas — Facebook Orgânico, Instagram, LinkedIn Orgânico, TikTok Orgânico, Pinterest Orgânico, X Orgânico, Threads, YouTube, Sprout Social.
- CRM e automação de marketing — HubSpot, Salesforce, Pipedrive, Microsoft Dynamics 365, Zoho CRM, Klaviyo, Mailchimp, ActiveCampaign, Brevo (Sendinblue), MailerLite, Customer.io, Iterable, SendGrid, Intercom, Outreach, Salesloft, Lemlist.
- E-commerce e pagamentos — Shopify, Magento, WooCommerce, BigCommerce, PrestaShop, Square, Stripe, PayPal, Braintree, Klarna, Recharge, Recurly, Chargebee, Walmart, TikTok Shop.
- Afiliados e parcerias — CJ, Awin, Impact, Partnerize, PartnerStack, Adtraction, Commission Factory, Rakuten Advertising, ShareASale, Tradedoubler, Everflow.
- Análise de apps e atribuição — AppsFlyer, Adjust, Branch, AppFollow.
- Helpdesk e suporte — Zendesk (Support, Chat, Sell, Sunshine, Talk), Freshdesk, Freshcaller, Freshservice, Dixa, Drift.
- Bancos de dados e warehouses — BigQuery, Snowflake, PostgreSQL, MySQL, Redshift, MongoDB, Firebolt, Dremio, SFTP, Google Sheets, Airtable, Notion, Amazon S3.
- RH, finanças, produtividade — BambooHR, Ashby, Lever, Greenhouse, Workable, QuickBooks, Xero, NetSuite, Slack, Microsoft Teams, Twilio, Zoom, Jira, Confluence, GitHub, GitLab, Datadog, Sentry, PagerDuty.
Não encontrou o que precisa? Chame get_connectors(include_not_yet_connected=True) de qualquer cliente MCP para obter a lista ao vivo, ou acesse /datasources diretamente.
🚀 Primeiros passos
Consulte nossa documentação oficial
- Introdução: windsor.ai/introducing-windsor-mcp/
- Central de guias de configuração: windsor.ai/documentation/windsor-mcp/ — guias passo a passo por cliente de IA (Claude, ChatGPT, Microsoft Copilot, Perplexity, Cursor, Gemini, Manus e o guia genérico "qualquer cliente MCP").
Você precisará de uma conta Windsor.ai — cadastre-se em onboard.windsor.ai.
Opção 1: Claude (Conector nativo — recomendado)
A Windsor.ai está listada no diretório do Claude.
👉 Instalação em um clique: claude.ai/directory/360c0c31-4bb6-42ca-8e50-5da0a100a68e
Pré-requisitos
- Uma conta Claude (Claude Desktop, Web ou Code) em um plano que suporte conectores
- Uma conta Windsor.ai
Passos
- Abra o link de instalação acima (ou vá para Configurações → Conectores no Claude e pesquise por "Windsor.ai").
- Você será redirecionado para o Windsor.ai para autorizar via OAuth — faça login uma vez.
- Abra um novo chat e comece a perguntar sobre seus dados, por exemplo:
Quais foram minhas 5 principais campanhas de Meta Ads por ROAS no mês passado?
Para usuários do Claude Code, instale nosso plugin dedicado com comandos de barra e um agente analista:
claude plugin install windsor-ai
Fonte: github.com/windsor-ai/claude-windsor-ai-plugin.
Opção 2: ChatGPT (Aplicativo Nativo)
O Windsor.ai está disponível como um aplicativo do ChatGPT.
👉 Instalação com um clique: chatgpt.com/apps/windsor-ai
Pré-requisitos
- Um plano do ChatGPT que suporte aplicativos
- Uma conta Windsor.ai
Passos
- Abra o link de instalação acima e adicione o Windsor.ai ao ChatGPT.
- Autorize via OAuth — você será redirecionado para o Windsor.ai para fazer login.
- Inicie um novo chat e faça perguntas sobre suas fontes de dados conectadas.
Opção 3: Microsoft Copilot (conector Power Platform)
Use o Windsor.ai dentro de agentes do Microsoft Copilot Studio e fluxos do Power Platform por meio do conector oficial do Windsor.ai para Power Platform.
👉 Referência do conector: learn.microsoft.com/connectors/windsorai
👉 Guia de integração: windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-copilot-agent
Pré-requisitos
- Uma licença do Microsoft Copilot Studio ou Power Platform
- Uma conta Windsor.ai e chave de API (de onboard.windsor.ai)
Passos
- No Copilot Studio, adicione uma nova ação e pesquise por Windsor.ai no catálogo de conectores.
- Forneça sua chave de API do Windsor.ai quando solicitado.
- Mapeie as ações do conector (listar conectores, obter campos, obter dados) no fluxo do seu agente. Guia completo no guia de integração.
Opção 4: Cursor
Publicamos um plugin dedicado para Cursor: github.com/windsor-ai/windsor-ai-cursor-plugin.
Pré-requisitos
- Cursor Desktop instalado
- Uma conta Windsor.ai
Passos
- Abra as configurações do Cursor → Ferramentas e Integrações → Novo Servidor MCP.
- Cole o seguinte em
mcp.json:
{
"mcpServers": {
"windsor": {
"url": "https://mcp.windsor.ai/"
}
}
}
- O Cursor guiará você pelo OAuth no primeiro uso. Comece a consultar seus dados imediatamente.
Opção 5: Manus
O Manus suporta servidores MCP remotos nativamente — guia completo no guia de integração do Windsor.ai para Manus.
Passos
- No Manus, abra Configurações → Servidores MCP → Adicionar servidor.
- Use a URL
https://mcp.windsor.ai/e autorize via OAuth. - Inicie uma nova sessão e pergunte sobre suas fontes de dados conectadas.
Opção 6: Gemini CLI
Passos
- Instale o Gemini CLI:
npm install -g @google/gemini-cli
- Execute
geminiuma vez para gerar o diretório de configuração e depois edite~/.gemini/settings.json:
{
"mcpServers": {
"windsor": {
"url": "https://mcp.windsor.ai/"
}
}
}
- Execute
geminie autorize via OAuth no primeiro uso.
❓ Perguntas Frequentes
O Windsor MCP é gratuito?
Sim — o Windsor.ai tem um plano gratuito para sempre, e o servidor MCP está incluído sem custo adicional. Você precisará de uma conta Windsor.ai com dados integrados. Alguns provedores de LLM (por exemplo, Claude) exigem um plano pago para usar conectores. Consulte windsor.ai/pricing para detalhes.
Com quais agentes de IA o Windsor MCP funciona?
Qualquer agente de IA compatível com MCP — incluindo Claude (Desktop, Web, Code), ChatGPT, Microsoft Copilot (via conector do Power Platform), Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus, n8n, mcp-proxy e clientes MCP personalizados. Consulte a tabela Clientes de IA compatíveis acima.
O que posso perguntar ao Windsor MCP?
Desempenho de marketing, funis de vendas, dados de CRM, pedidos de e-commerce, atividade de pagamentos, métricas financeiras, resumos de gastos com anúncios, tendências de ROAS, anomalias em campanhas, atribuição multicanal, consultas a data warehouses e muito mais. Se estiver nos seus dados do Windsor.ai, você pode perguntar. Em conectores que expõem ações de escrita (por exemplo, Meta Ads, Google Ads, TikTok Ads), você também pode pedir ao assistente para agir sobre o que ele encontrar — por exemplo, "pausar as campanhas que queimaram orçamento na semana passada" ou "reduzir o orçamento diário desta campanha em 20%".
Quais fontes de dados o Windsor MCP suporta?
Mais de 350 conectores em publicidade, analytics, CRM, e-commerce, pagamentos, data warehouses e muito mais. A lista completa e atualizada está em mcp.windsor.ai/datasources. Consulte a seção Fontes de dados compatíveis para destaques por categoria.
Preciso escrever SQL ou configurar dashboards?
Não. Basta fazer suas perguntas em linguagem natural e obter respostas estruturadas em tempo real.
Como funciona a autenticação?
OAuth 2.0 é o padrão — seu cliente redireciona você para o Windsor.ai para um login único. O servidor implementa MCP OAuth com Dynamic Client Registration; clientes que suportam MCP OAuth (Claude, ChatGPT, Cursor, Manus) descobrem os endpoints automaticamente. Para configurações que só suportam chaves de API, passe sua chave Windsor.ai como um token Bearer via cabeçalho Authorization.
Meus dados estão seguros com o Windsor MCP?
Sim. O Windsor MCP expõe tanto ferramentas de leitura (que apenas buscam dados) quanto um pequeno número de ferramentas de escrita (list_actions, execute_action) em conectores que optam por ações — por exemplo, pausar ou ativar uma campanha de anúncios. As ações de escrita são explicitamente sinalizadas como destrutivas para os clientes MCP, que solicitam que você confirme a intenção antes de invocá-las; nada é alterado em suas fontes sem sua aprovação. A autenticação é OAuth 2.0; o servidor MCP não armazena sua senha do Windsor.ai e não retém resultados de consultas. Os dados trafegam via TLS. O Windsor.ai é compatível com SOC 2. Para detalhes, consulte windsor.ai/security.
Como o Windsor MCP é diferente de outras ferramentas de integração de dados?
O Windsor MCP é um servidor MCP nativo, não um plugin ou wrapper — ele funciona em qualquer cliente compatível com MCP sem proxies. O Windsor.ai inclui destinos de data warehouse e banco de dados (BigQuery, Snowflake, Redshift, S3, MySQL, Postgres) em seus planos de menor preço, e o servidor MCP está incluído em todos os planos pagos sem custo adicional. Consulte windsor.ai/pricing para uma comparação recurso por recurso.
Quanto custa o Windsor.ai?
O Windsor.ai tem um plano gratuito para sempre. Os planos pagos adicionam mais fontes, limites maiores e destinos adicionais. O servidor MCP está incluído em todos os planos sem custo adicional. Consulte windsor.ai/pricing para os preços atuais.
O Windsor MCP funciona no celular?
O servidor hospedado é independente de plataforma, mas o suporte móvel depende de qual cliente de IA você usa. Claude Web/Desktop, ChatGPT Web/Desktop e Cursor Desktop são totalmente suportados hoje; o suporte MCP móvel varia por cliente e está sendo implementado gradualmente.
Onde obtenho ajuda?
Para suporte ou feedback, entre em contato com support@windsor.ai. Para relatórios de bugs específicos deste repositório, abra uma issue.
🧠 Experimente agora
Comece a consultar seus dados de negócios via Windsor MCP — o caminho mais rápido é a instalação com um clique no Claude:
👉 Instalar no Claude — 30 segundos, sem chave de API.
Outros pontos de entrada:
- 👉 Instalar no ChatGPT
- 👉 Conector Microsoft Copilot (guia de integração)
- 👉 Guia de integração Manus
- 👉 Plugin Claude Code
- 👉 Plugin Cursor
- 👉 Obter uma chave de API Windsor.ai
- 👉 Assistir à demonstração
- 👉 Documentação ao vivo direcionada a IA
Para suporte ou feedback, entre em contato conosco em support@windsor.ai.