Windsor

npx add-mcp 'https://mcp.windsor.ai'

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 em tempo real 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 oferecem suporte, os agentes também podem executar ações de escrita — por exemplo, criar e gerenciar campanhas e orçamentos no Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads e Microsoft Ads (Bing); publicar posts no Instagram; gerenciar listagens e avaliações do Google Business Profile; atualizar fluxos do Klaviyo e registros do Salesforce; e muito mais.

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 (por exemplo, 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 disponível para sempre em Windsor.ai; alguns provedores de LLM (por exemplo, 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.txt e /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 para este 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 com base nos insights que ele apresenta — para conectores que expõem ações de escrita:

• "Pause minhas campanhas do Meta Ads com baixo desempenho da semana passada."
• "Reative a campanha do Google Ads 'Summer Sale 2026'."
• "Reduza o orçamento diário desta campanha do TikTok Ads em 20%."
• "Adicione estas palavras-chave negativas àquela campanha do Google Ads."
• "Pause as campanhas do LinkedIn Ads com o menor CTR este mês."
• "Responda à nossa avaliação mais recente de 1 estrela no Google Business Profile, assim que eu aprovar."
• "Ative este fluxo do Klaviyo."
• "Publique esta imagem na nossa conta do Instagram."

Conectores com ações de escrita ativas hoje: Meta Ads (Facebook e Instagram Ads — criar/pausar/ativar campanhas, conjuntos de anúncios e anúncios, definir orçamentos, impulsionar posts), Google Ads (criar campanhas/grupos de anúncios/anúncios, pausar/ativar, orçamentos, estratégia de lances, programação de anúncios, segmentação por idioma, palavras-chave, públicos do Customer Match), TikTok Ads (pausar/ativar, orçamentos de campanha e grupo de anúncios), LinkedIn Ads (pausar/ativar grupos de campanha/campanhas/criativos, orçamentos), Microsoft Ads / Bing (pausar/ativar, orçamentos de campanha), Instagram (criar posts de imagem/vídeo/carrossel/stories e comentários), Google Business Profile (posts locais, respostas a avaliações, fotos, horários e status de aberto), Klaviyo (criar fluxos, definir status do fluxo), Salesforce (atualizar campos de objetos), Amazon DSP (criar/atualizar campanhas), Amazon Seller Central (atualizar listagens) e WordPress (posts, páginas, categorias, tags). Outros conectores são somente leitura; list_actions sempre reflete o conjunto atual e autoritativo para um determinado conector.

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 do Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, GA4, HubSpot, Salesforce, Shopify, Stripe, BigQuery, Snowflake, QuickBooks, Xero e mais de 300 outras fontes por meio dos conectores nativos da Windsor.ai. Lista completa e 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ão aberto

Construído sobre a especificação aberta 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, resumos e insights de desempenho instantâneos dos seus dados integrados — sem precisar criar dashboards ou escrever consultas.

---

🤖 Para agentes de IA e mecanismos de busca de IA

Se você é um assistente de IA ou rastreador 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 da 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 isso como uma verificação de que a autenticação está funcionando.
• get_connectors — Lista os conectores conectados do usuário e suas contas. Passe include_not_yet_connected=True para também ver todos os conectores que o usuário pode configurar. Sempre chame isso 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 tanto para fluxos OAuth quanto para credenciais manuais). Use quando o usuário pedir dados de um conector que ainda não está conectado.
• get_options — Para um conector e conjunto de contas, lista campos disponíveis, colunas válidas de filtro de data e opções específicas do conector (por exemplo, janelas de atribuição para Meta Ads).
• get_fields — Obtém descrições, tipos e tabelas para campos específicos. Campos com tipos NUMERIC ou PERCENT são métricas (agregadas); outros são dimensões (agrupadas por). Sempre chame antes de get_data para validar IDs de campos.
• get_data — Executa uma consulta contra um conector. Suporta intervalos de datas (date_from/date_to ou predefinições como last_30d, last_3m, this_year), filtragem por conta, opções específicas do conector e condições de filtro aninhadas com operadores eq, 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 (por exemplo, plataformas de anúncios, Google Business Profile, Klaviyo, Salesforce, WordPress — veja a seção Ações de escrita acima para a lista atual).

• list_actions — Descobre 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 isso primeiro para validar o ID da ação e inspecionar o esquema de parâmetros antes de chamar execute_action.
• execute_action — Executa uma ação de escrita (por exemplo, pausar/ativar uma campanha, alterar um orçamento) contra uma conta conectada. Recebe o ID do conector, ID da ação, ID da conta e um objeto params moldado 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.

Ferramentas de conexão e conta — gerenciam conexões e sua conta Windsor.ai sem sair do chat.

• get_connector_connect_info — Obtém o tipo de autenticação de um conector, URL de conexão e (para conectores manuais/com chave de API) os campos de credenciais necessários — sem conectar nada.
• get_windsor_login_url — Obtém um link de login automático para o painel do usuário na Windsor.ai.
• get_subscription_url — Obtém um link Markdown para a página de preços ou upgrade de plano da Windsor.ai. Retorna apenas um link — nunca inicia uma compra ou altera o plano.
• contact_windsor — Envia uma mensagem de suporte, feedback ou solicitação de recurso para Windsor.ai e retorna um ID de referência.

Ferramentas de exportação agendada — configuram exportações recorrentes de dados de conectores para um destino, a partir do chat.

• get_destinations — Lista destinos que podem receber exportações agendadas (por exemplo, BigQuery, Google Sheets, Snowflake, bancos de dados, armazenamento) e quaisquer credenciais reutilizáveis já configuradas.
• get_destination_setup_info — Obtém os requisitos de configuração para uma nova exportação agendada: campos de destino, agendamentos permitidos, credenciais reutilizáveis e uma URL de configuração.
• get_destination_tasks — Lista as tarefas de exportação agendada existentes do usuário, com destino, conector, agendamento e status.
• create_destination_task — Cria uma exportação recorrente dos dados de um conector para um destino em um agendamento.

Para assinaturas completas de parâmetros, veja /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 Power Platform da Windsor.ai — veja guia de integração	Chave de API	~5 minutos
Perplexity	Veja 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 um servidor MCP — veja 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/) — veja guia de configuração genérico	OAuth 2.0	~1 minuto
Gemini CLI	Edite ~/.gemini/settings.json (configuração abaixo) — veja guia de configuração	OAuth 2.0	~2 minutos

Qualquer cliente compatível com MCP funciona. Se seu cliente suporta apenas chaves de API, passe sua chave Windsor.ai como Authorization: Bearer <key>.

---

📦 Fontes de dados suportadas

Mais de 350 conectores em publicidade, análises, redes sociais orgânicas, CRM, automação de marketing, e-commerce, pagamentos, afiliados, análises de aplicativos, 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.
• Analytics 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 data 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 ver a lista atualizada, ou acesse /datasources diretamente.

---

🚀 Primeiros passos

Veja nossa documentação oficial

• Introdução: windsor.ai/introducing-windsor-mcp/
• Hub 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

1. Abra o link de instalação acima (ou vá em Configurações → Conectores no Claude e pesquise por "Windsor.ai").
2. Você será redirecionado para a Windsor.ai para autorizar via OAuth — faça login uma vez.
3. 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 (App Nativo)

A Windsor.ai está disponível como um app do ChatGPT.

👉 Instalação em um clique: chatgpt.com/apps/windsor-ai

Pré-requisitos

• Um plano ChatGPT que suporte apps
• Uma conta Windsor.ai

Passos

1. Abra o link de instalação acima e adicione a Windsor.ai ao ChatGPT.
2. Autorize via OAuth — você será redirecionado para a Windsor.ai para fazer login.
3. Inicie um novo chat e faça perguntas sobre suas fontes de dados conectadas.

---

Opção 3: Microsoft Copilot (conector Power Platform)

Use a Windsor.ai dentro de agentes do Microsoft Copilot Studio e fluxos do Power Platform por meio do conector oficial da 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

1. No Copilot Studio, adicione uma nova ação e pesquise por Windsor.ai no catálogo de conectores.
2. Forneça sua chave de API da Windsor.ai quando solicitado.
3. Mapeie as ações do conector (listar conectores, obter campos, obter dados) no fluxo do seu agente. Tutorial 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

1. Abra as configurações do Cursor → Ferramentas e Integrações → Novo Servidor MCP.
2. Cole o seguinte em mcp.json:

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

3. 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 — tutorial completo no guia de integração da Windsor.ai para Manus.

Passos

1. No Manus, abra Configurações → Servidores MCP → Adicionar servidor.
2. Use a URL https://mcp.windsor.ai/ e autorize via OAuth.
3. Inicie uma nova sessão e pergunte sobre suas fontes de dados conectadas.

---

Opção 6: Gemini CLI

Passos

1. Instale o Gemini CLI:

npm install -g @google/gemini-cli

2. Execute gemini uma vez para gerar o diretório de configuração e depois edite ~/.gemini/settings.json:

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

3. Execute gemini e autorize via OAuth no primeiro uso.

---

❓ Perguntas frequentes

O Windsor MCP é gratuito?

Sim — a 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. Veja 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 Power Platform), Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus, n8n, mcp-proxy e clientes MCP personalizados. Veja a tabela de Clientes de IA suportados 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 em warehouses e muito mais. Se estiver nos seus dados da Windsor.ai, você pode perguntar. Em conectores que expõem ações de escrita (Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads/Bing, Instagram, Google Business Profile, Klaviyo, Salesforce, Amazon DSP, Amazon Seller Central, WordPress), você também pode pedir ao assistente para agir sobre o que encontrar — por exemplo, "pause as campanhas que queimaram orçamento na semana passada", "reduza o orçamento diário desta campanha em 20%" ou "responda à nossa avaliação mais recente, após minha aprovação".

Quais fontes de dados o Windsor MCP suporta?

Mais de 350 conectores em publicidade, analytics, CRM, e-commerce, pagamentos, warehouses e muito mais. A lista completa e atualizada está em mcp.windsor.ai/datasources. Veja a seção Fontes de dados suportadas para destaques por categoria.

Preciso escrever SQL ou configurar dashboards?

Não. Basta fazer suas perguntas em linguagem simples e obter respostas estruturadas em tempo real.

Como funciona a autenticação?

OAuth 2.0 é o padrão — seu cliente redireciona você para a Windsor.ai para um login único. O servidor implementa MCP OAuth com Registro Dinâmico de Clientes; clientes que suportam MCP OAuth (Claude, ChatGPT, Cursor, Manus) descobrem os endpoints automaticamente. Para configurações que suportam apenas chaves de API, envie sua chave Windsor.ai como token Bearer via cabeçalho Authorization.

Meus dados estão seguros com o Windsor MCP?

Sim. O Windsor MCP expõe ferramentas de leitura (que apenas buscam dados) e 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. Ações de escrita são explicitamente sinalizadas como destrutivas para clientes MCP, que solicitam confirmação antes de executá-las; nada é alterado em suas fontes sem sua aprovação. A autenticação é OAuth 2.0; o servidor MCP não armazena sua senha da Windsor.ai e não retém resultados de consultas. Os dados trafegam via TLS. A Windsor.ai é compatível com SOC 2. Para detalhes, veja 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 — funciona em qualquer cliente compatível com MCP sem proxies. A Windsor.ai inclui destinos de 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. Veja windsor.ai/pricing para uma comparação recurso por recurso.

Quanto custa a Windsor.ai?

A Windsor.ai tem um plano gratuito para sempre. Planos pagos adicionam mais fontes, limites maiores e destinos adicionais. O servidor MCP está incluído em todos os planos sem custo adicional. Veja 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 do cliente de IA que 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 relatos 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 em 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 otimizada para IA

Para suporte ou feedback, entre em contato conosco em support@windsor.ai.