Windsor MCP Server

oficial

O 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.

GitHub
3

Documentação

Windsor MCP — Conecte Claude, ChatGPT e Cursor a mais de 325 fontes de dados de marketing

O Windsor MCP (Model Context Protocol) é um servidor MCP hospedado que permite ao seu assistente de IA consultar, explorar e analisar dados de negócios ao vivo de mais de 325 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. Nos conectores que oferecem suporte, os agentes também podem executar ações de gravação — por exemplo, pausar ou ativar campanhas publicitárias 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 aplicativo do ChatGPT).
  • Leitura e gravação: consulte dados de mais de 325 fontes e execute ações de gravação (ex.: pausar/ativar campanhas publicitárias) nos conectores que as expõem.
  • OAuth 2.0 — faça login uma vez no Windsor.ai, sem chaves de API para gerenciar.
  • Plano gratuito vitalício disponível no 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.txt e /datasources.

🌟 Funcionalidades

Acesso em linguagem natural a dados de negócios

Faça perguntas como:

  • "Quais campanhas tiveram o melhor ROAS no mês passado?"
  • "Mostre um detalhamento de 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?"
  • "Extraia nossos pedidos do Shopify e pagamentos do Stripe deste trimestre."
  • "Combine as sessões do GA4 com os gastos do Google Ads em um relatório semanal."

Tudo em tempo real, diretamente na interface de chat do seu LLM.

Ações de gravação, não apenas leituras

Peça ao seu assistente para agir com base nos insights que ele revela — para conectores que expõem ações de gravação (ex.: Meta Ads, Google Ads, TikTok Ads):

  • "Pause minhas campanhas do Meta Ads com baixo desempenho da semana passada."
  • "Reative a campanha do Google Ads 'Promoção de Verão 2026'."
  • "Reduza o orçamento diário desta campanha do TikTok Ads em 20%."

Ações de gravação 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 325 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 de conectores nativos do Windsor.ai. Lista completa e atualizada em mcp.windsor.ai/datasources.

Configuração sem código

O Windsor MCP está disponível como um 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 com base na especificação MCP aberta, é 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 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 um 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:

EndpointO que você encontrará
/llms.txtResumo curto no formato llmstxt.org do servidor, ferramentas e clientes.
/llms-full.txtReferência completa: fluxo de trabalho, parâmetros de ferramentas, operadores de filtro, solução de problemas, fontes suportadas por categoria.
/datasourcesLista JSON ao vivo de cada conector suportado. Autoritativa; atualizada continuamente.
/docsDocumentação HTML legível por humanos com tags de conectores categorizadas.
/.well-known/oauth-authorization-serverMetadados de descoberta OAuth 2.0 para clientes MCP.

Este repositório do 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 o redireciona para o Windsor.ai para um login único. Nenhuma chave de API é necessária. Clientes que suportam apenas chaves de API podem passar uma chave do 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 uma verificação de sanidade 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 ver também 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 do navegador para conectar ou autorizar um conector (funciona tanto para fluxos OAuth quanto de credenciais manuais). Use quando o usuário solicitar dados de um conector que ainda não está conectado.
  • get_options — Para um conector e conjunto de contas, lista os campos disponíveis, colunas de filtro de data válidas 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 tipos NUMERIC ou PERCENT são métricas (agregadas); outros são dimensões (agrupados por). Sempre chame antes de get_data para validar os IDs dos campos.
  • get_data — Executa uma consulta em um conector. Suporta intervalos de datas (date_from/date_to ou predefinições como last_30d, last_3m, this_year), filtragem de 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.

Um punhado de conectores de warehouse (mysql, postgresql, redshift, mongodb, snowflake, big_query) exigem um argumento date_filters explícito ao filtrar por data.

Ferramentas de gravação — disponíveis em conectores que expõem ações (ex.: plataformas de anúncios).

  • list_actions — Descobre ações de gravação 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 seu esquema de parâmetros antes de chamar execute_action.
  • execute_action — Executa uma ação de gravação (ex.: pausar/ativar uma campanha, alterar um orçamento) em uma conta conectada. Recebe o ID do conector, ID da ação, ID da conta e um objeto params moldado de acordo com o esquema JSON da ação. Ações de gravação 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

ClienteComo instalarAutenticaçãoTempo de configuração
Claude (Desktop, Web, Code)Instalação com um clique — listado no diretório do Claude · guia de configuraçãoOAuth 2.0~30 segundos
ChatGPTInstalação com um clique — listado como um aplicativo do ChatGPT · guia de configuraçãoOAuth 2.0~30 segundos
Microsoft CopilotConector Windsor.ai Power Platform — veja o guia de integraçãoChave de API~5 minutos
PerplexityVeja o guia de configuraçãoOAuth 2.0~1 minuto
Claude Codeclaude plugin install windsor-ai — fonte, com comandos de barra e um agente analistaOAuth 2.0~1 minuto
Cursorwindsor-ai/windsor-ai-cursor-plugin, ou cole a configuração abaixo · guia de configuraçãoOAuth 2.0~1 minuto
ManusAdicione https://mcp.windsor.ai/ como um servidor MCP — veja o guia de integraçãoOAuth 2.0~1 minuto
Windsurf, Cline, GitHub Copilot, n8nConfiguração padrão de servidor MCP (url: https://mcp.windsor.ai/) — veja o guia de configuração genéricoOAuth 2.0~1 minuto
Gemini CLIEdite ~/.gemini/settings.json (configuração abaixo) — veja o guia de configuraçãoOAuth 2.0~2 minutos

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

📦 Fontes de dados suportadas

Mais de 325 conectores nas áreas de publicidade, análise, mídias sociais orgânicas, CRM, automação de marketing, e-commerce, pagamentos, afiliados, análise de aplicativos, helpdesk, produtividade, bancos de dados e warehouses. Lista completa e atualizada: 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.
  • Análise e busca — Google Analytics 4, Adobe Analytics, Mixpanel, Amplitude, Matomo, Plausible, PostHog, Search Console, Bing Webmaster, Looker, Metabase.
  • Mídias 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 parceiros — CJ, Awin, Impact, Partnerize, PartnerStack, Adtraction, Commission Factory, Rakuten Advertising, ShareASale, Tradedoubler, Everflow.
  • Análise e atribuição de aplicativos — 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 atualizada ou acesse /datasources diretamente.

🚀 Primeiros passos

Veja nossa documentação oficial

Você precisará de uma conta no Windsor.ai — cadastre-se em onboard.windsor.ai.

Opção 1: Claude (Conector Nativo — Recomendado)

O Windsor.ai está listado no diretório do Claude.

👉 Instalação com 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 no Windsor.ai

Passos

  1. Abra o link de instalação acima (ou vá para Configurações → Conectores no Claude e procure por "Windsor.ai").
  2. Você será redirecionado para o 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 do Meta Ads por ROAS no mês passado?

Para usuários do Claude Code, instale nosso plugin dedicado com comandos slash e um agente analista:

claude plugin install windsor-ai

Fonte: github.com/windsor-ai/claude-windsor-ai-plugin.

Opção 2: ChatGPT (App Nativo)

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

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

Pré-requisitos

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

Passos

  1. Abra o link de instalação acima e adicione o Windsor.ai ao ChatGPT.
  2. Autorize via OAuth — você será redirecionado para o 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 do Power Platform)

Use o Windsor.ai dentro de agentes do Microsoft Copilot Studio e fluxos do Power Platform através 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 no Windsor.ai e chave de API (de onboard.windsor.ai)

Passos

  1. No Copilot Studio, adicione uma nova ação e procure por Windsor.ai no catálogo de conectores.
  2. Forneça sua chave de API do Windsor.ai quando solicitado.
  3. Mapeie as ações do conector (listar conectores, obter campos, obter dados) no fluxo do seu agente. Passo a passo completo no guia de integração.

Opção 4: Cursor

Publicamos um plugin dedicado para o Cursor: github.com/windsor-ai/windsor-ai-cursor-plugin.

Pré-requisitos

  • Cursor Desktop instalado
  • Uma conta no 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/"
    }
  }
}
  1. O Cursor irá guiá-lo pelo OAuth no primeiro uso. Comece a consultar seus dados imediatamente.

Opção 5: Manus

O Manus suporta servidores MCP remotos nativamente — passo a passo completo no guia de integração do 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
  1. Execute gemini uma vez para gerar o diretório de configuração, depois edite ~/.gemini/settings.json:
{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}
  1. Execute gemini e 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 no Windsor.ai com dados integrados. Alguns provedores de LLM (ex.: 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 do 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, pipelines 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 de warehouse e mais. Se estiver nos seus dados do Windsor.ai, você pode perguntar. Em conectores que expõem ações de escrita (ex.: Meta Ads, Google Ads, TikTok Ads), você também pode pedir ao assistente para agir com base no que encontrar — por exemplo, "pause as campanhas que queimaram orçamento na semana passada" ou "reduza o orçamento diário desta campanha em 20%".

Quais fontes de dados o Windsor MCP suporta?

Mais de 325 conectores nas áreas de publicidade, analytics, CRM, e-commerce, pagamentos, warehouses e 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 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 Registro Dinâmico de Cliente; clientes que suportam MCP OAuth (Claude, ChatGPT, Cursor, Manus) descobrem os endpoints automaticamente. Para configurações que suportam apenas chaves de API, passe sua chave do Windsor.ai como um token Bearer através do 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 publicitária. Ações de escrita são explicitamente sinalizadas como destrutivas para 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 sobre TLS. O Windsor.ai está em conformidade com SOC 2. Para detalhes, veja windsor.ai/security.

Como o Windsor MCP se diferencia 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. O 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 a recurso.

Quanto custa o Windsor.ai?

O Windsor.ai tem um plano gratuito para sempre. Planos pagos adicionam mais fontes, limites mais altos 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 em dispositivos móveis?

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.

Onde obtenho ajuda?

Para suporte ou feedback, entre em contato com [email protected]. 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:

Para suporte ou feedback, entre em contato conosco em [email protected].