Windsor

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.

O que você pode fazer com Windsor MCP?

  • Consulte dados de marketing e negócios — Faça perguntas sobre mais de 350 fontes, como Meta Ads, GA4, HubSpot, Shopify e Stripe, usando get_data com predefinições de data como last_30d.
  • Descubra e conecte fontes — Liste contas conectadas com get_connectors ou obtenha um link do navegador para autorizar uma nova fonte por meio de get_connector_authorization_url.
  • Execute ações de escrita — Pause campanhas, altere orçamentos ou publique posts com list_actions e execute_action; ações que alteram gastos retornam primeiro um confirmation_token.
  • Crie campos de fórmulas personalizadas — Defina métricas calculadas, como gastos ajustados pela margem, com create_custom_field e depois use-as em consultas.
  • Agende exportações recorrentes — Configure exportações recorrentes de dados para destinos como BigQuery ou Google Sheets com create_destination_task.

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

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 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, chaves de API ou integrações personalizadas. Nos conectores que oferecem ações de gravação, os agentes também podem agir sobre esses dados. Por exemplo, podem criar e gerenciar campanhas, orçamentos e lances no Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads (Bing), Pinterest, Snapchat e Amazon Ads; publicar posts no Instagram, Facebook Pages, LinkedIn Pages e Threads; gerenciar listagens e avaliações do Google Business Profile; atualizar produtos no Google Merchant Center, WooCommerce e TikTok Shop; e criar ou atualizar registros no Salesforce, GoHighLevel e Stripe. A lista atualizada está em /actions.

Funciona com Claude, ChatGPT, Microsoft Copilot, Perplexity, Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus e qualquer cliente compatível com MCP.

Em resumo

  • Conector nativo no Claude (no diretório do Claude) e no ChatGPT (como plugin do ChatGPT).
  • Leitura e gravação: consulte dados de mais de 350 fontes e execute mais de 160 ações de gravação (por exemplo, pausar/ativar campanhas de anúncios, alterar orçamentos, publicar posts) nos conectores que oferecem essas ações (lista atualizada). Ações que iniciam ou aumentam gastos com anúncios exigem uma etapa explícita de confirmação.
  • OAuth 2.0: faça login uma vez no Windsor.ai, sem precisar gerenciar chaves de API.
  • Plano gratuito disponível para sempre no Windsor.ai; alguns provedores de LLM (por exemplo, Claude) exigem um plano pago para usar conectores.
  • Documentação atualizada e legível por máquina para agentes de IA em /llms.txt, /llms-full.txt, /datasources e /actions.

🌟 Recursos

Acesso a dados empresariais em linguagem natural

Faça perguntas como:

  • "Quais campanhas tiveram o melhor ROAS no mês passado?"
  • "Mostre uma análise detalhada 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 geraram?"
  • "Busque 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 consultas

Peça ao seu assistente para agir com base nos insights que ele apresenta, nos conectores que oferecem ações de gravação:

  • "Pause minhas campanhas de Meta Ads com baixo desempenho da semana passada."
  • "Reative a campanha do Google Ads 'Summer Sale 2026'."
  • "Reduza em 20% o orçamento diário desta campanha do TikTok Ads."
  • "Adicione estas palavras-chave negativas àquela campanha do Google Ads."
  • "Pause as campanhas do LinkedIn Ads com a menor CTR deste mês."
  • "Responda à nossa avaliação mais recente de 1 estrela no Google Business Profile, depois que eu aprovar."
  • "Ative este fluxo do Klaviyo."
  • "Publique esta imagem na nossa conta do Instagram."
  • "Pause os grupos de anúncios do Snapchat e Pinterest que não converteram esta semana."
  • "Marque estes pedidos do WooCommerce como concluídos."
  • "Envie estas três imagens e crie com elas um novo anúncio de imagem no Meta Ads."

Conectores com ações de gravação disponíveis atualmente:

Anúncios pagos

  • Meta Ads: criar/atualizar/pausar/ativar campanhas, conjuntos de anúncios e anúncios; duplicar conjuntos de anúncios; anúncios de imagem e vídeo; orçamentos; impulsionar posts; mensagens de boas-vindas da página.
  • Google Ads: campanhas, grupos de anúncios, anúncios responsivos de pesquisa e recursos; orçamentos; estratégias e metas de lances; segmentação geográfica e por idioma; programação de anúncios; palavras-chave e palavras-chave negativas; públicos do Customer Match.
  • LinkedIn Ads: grupos de campanhas, campanhas e criativos; orçamentos; programação; segmentação.
  • TikTok Ads, Pinterest Ads, Snapchat Ads: pausar/ativar campanhas, grupos de anúncios (esquadrões de anúncios no Snapchat) e anúncios; orçamentos de campanhas e grupos de anúncios.
  • Microsoft Ads (Bing), Amazon Ads, OpenAI Ads: pausar/ativar; orçamentos de campanhas.
  • Amazon DSP: criar/atualizar campanhas.

Redes sociais orgânicas

  • Instagram: posts de imagem, vídeo, carrossel e stories; criar, responder, ocultar/exibir e excluir comentários.
  • Facebook Pages: posts e posts com fotos.
  • LinkedIn Pages: posts e posts com imagens.
  • Threads: posts de texto e imagem, respostas.

Local e SEO

  • Google Business Profile: posts locais, respostas a avaliações, fotos, horários, status de funcionamento, endereço, categorias, itens e área de serviço, atributos.

E-commerce

  • Google Merchant Center: inserir/atualizar/excluir produtos e fontes de dados.
  • WooCommerce: produtos, status e observações de pedidos, cupons.
  • TikTok Shop: produtos, preços, ativar/desativar.
  • Amazon Seller Central: atualizar listagens.

CRM, e-mail e pagamentos

  • Salesforce: criar/atualizar/excluir objetos.
  • GoHighLevel: contatos e faturas.
  • Klaviyo: criar fluxos, definir o status dos fluxos.
  • Stripe: criar clientes e assinaturas.

CMS

  • WordPress: posts, páginas, categorias e tags.

Os demais conectores são somente para leitura. Consulte a documentação de ações de gravação e a lista atualizada de /actions para ver as ações de gravação disponíveis atualmente em cada conector. Em um chat, list_actions retorna o conjunto oficial para um determinado conector.

As ações de gravação modificam o estado externo, portanto os clientes MCP devem sempre confirmar a intenção do usuário antes de executá-las. Além disso, qualquer ação que inicie ou aumente gastos com anúncios (ativar algo, criar uma campanha ativa ou alterar um orçamento, lance ou meta) não é executada na primeira chamada. Ela retorna uma prévia com um confirmation_token de uso único e só é executada quando chamada novamente com esse token, após a aprovação do usuário. O token expira após 10 minutos e só é válido para o mesmo usuário, conector, conta, ação e parâmetros exatos.

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 do Windsor.ai. Lista completa e atualizada 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, scripts ou integrações personalizadas.

Compatibilidade com padrão aberto

Desenvolvido com base na 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 análises detalhadas, resumos e insights de desempenho instantaneamente a partir dos seus dados integrados, sem precisar criar painéis ou escrever consultas.


🤖 Para agentes de IA e mecanismos de busca com IA

Se você é um assistente de IA ou rastreador de mecanismos de busca com IA, a documentação oficial 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 sobre o servidor, as ferramentas e os clientes.
/llms-full.txtReferência completa: fluxo de trabalho, parâmetros das ferramentas, operadores de filtro, solução de problemas e fontes compatíveis por categoria.
/datasourcesLista JSON atualizada de todos os conectores compatíveis. É a fonte oficial e é atualizada continuamente.
/actionsLista JSON atualizada de todas as ações de gravação, agrupadas por conector.
/docsDocumentação HTML legível por humanos, com tags de conectores categorizadas.
/.well-known/oauth-authorization-serverMetadados de descoberta do OAuth 2.0 para clientes MCP.

Este repositório do GitHub é uma página de descoberta para desenvolvedores; considere os endpoints acima como a fonte oficial para a quantidade de conectores, as assinaturas das ferramentas e os clientes compatíveis.


🎯 Como funciona

Você conecta o Windsor MCP ao seu assistente de IA como um conector usando o protocolo MCP. Em seguida, o assistente executa consultas de dados em tempo real e recebe resultados estruturados, tudo dentro da interface de chat.

O endpoint do servidor é https://mcp.windsor.ai/ (Streamable HTTP; SSE está disponível em https://mcp.windsor.ai/sse/). A autenticação é feita com OAuth 2.0: na primeira conexão, seu cliente redireciona você ao Windsor.ai para fazer login uma única vez. Não é necessária uma chave de API. Clientes que aceitam apenas chaves de API podem passar uma chave do Windsor.ai como Authorization: Bearer <key>.

Ferramentas disponíveis

Ferramentas de leitura: buscam dados, sem nunca modificá-los.

  • get_current_user: retorna o perfil do usuário autenticado (nome de usuário, e-mail e plano atual do Windsor.ai). Use para verificar se a autenticação está funcionando.
  • get_connectors: lista os conectores conectados do usuário e suas contas, além dos IDs das ações de gravação e das opções de leitura disponíveis em cada conector. Passe include_not_yet_connected=True para também ver todos os conectores que o usuário pode configurar. Sempre chame esta ferramenta primeiro para descobrir as fontes de dados disponíveis.
  • get_connector_authorization_url: obtém um link para conectar ou autorizar um conector no navegador (funciona tanto com fluxos OAuth quanto com fluxos de credenciais manuais). Use quando o usuário solicitar dados de um conector que ainda não esteja conectado.
  • get_options: para um conector e um conjunto de contas, lista os campos disponíveis, as colunas válidas para filtros de data e as opções específicas do conector (por exemplo, janelas de atribuição do Meta Ads).
  • get_fields: obtém descrições, tipos e tabelas de campos específicos. Campos dos tipos NUMERIC ou PERCENT são métricas (agregadas); os demais são dimensões (agrupadas por). Sempre chame antes de get_data para validar os IDs dos campos.
  • get_data: executa uma consulta em um conector. Aceita intervalos de datas (date_from/date_to ou predefinições como last_30d, last_3m, this_year; os últimos 3 dias quando nenhuma data é informada), filtragem por conta, opções específicas do conector, condições de filtro aninhadas com os operadores eq, neq, gt, gte, lt, lte, contains, ncontains, null, notnull, in e force_refresh para buscar novamente os dias mais recentes (planos com atualização por hora). Uma consulta que demore mais do que o tempo de espera retorna status: "pending"; repetir a mesma chamada retoma o mesmo trabalho e retorna os dados assim que estiverem prontos. Clientes compatíveis com a extensão MCP Tasks recebem uma tarefa.

Alguns conectores de data warehouse (mysql, postgresql, redshift, mongodb, snowflake, big_query) exigem o argumento explícito date_filters (um objeto que mapeia uma tabela para uma coluna de data, por exemplo, {"orders": "created_at"}) ao filtrar por data.

Ferramentas de campos personalizados: defina métricas e dimensões calculadas uma vez e use-as em todos os lugares.

  • get_custom_fields: lista os campos personalizados (fórmulas) do usuário em todos os conectores, cada um com seu conector, ID do campo, tipo e fórmula.
  • create_custom_field: cria um campo personalizado (fórmula) em um conector, por exemplo, CPA ou gastos ajustados por uma margem (to_float(spend) * 1.2). Depois, ele funciona como um campo normal em get_fields, get_data e nas exportações agendadas. Útil para recriar campos calculados ao migrar de outra plataforma.

Ferramentas de gravação: disponíveis nos conectores que oferecem ações de gravação (consulte a seção Ações de gravação acima para ver a lista atualizada).

  • list_actions: Descubra as ações de gravação disponíveis para um conector. Cada ação inclui um esquema JSON que descreve os parâmetros aceitos. Conectores somente leitura retornam uma lista vazia. Sempre chame esta ferramenta primeiro para validar o ID da ação e inspecionar o esquema dos parâmetros antes de chamar execute_action.
  • execute_action: Execute uma ação de gravação (por exemplo, pausar/ativar uma campanha, alterar um orçamento) em uma conta conectada. Recebe o ID do conector, o ID da ação, o ID da conta e um objeto params estruturado de acordo com o esquema JSON da ação. Para ações que iniciam ou aumentam os gastos com anúncios, a primeira chamada retorna uma prévia com um confirmation_token; chame novamente com os mesmos argumentos e esse token depois que o usuário aprovar (clientes cuja lista de ferramentas em cache não inclua o argumento podem passá-lo dentro de params). As ações de gravação modificam o estado externo, portanto, os clientes devem confirmar a intenção com o usuário antes de invocá-las.
  • upload_files: Para ações que recebem arquivos (por exemplo, create_ad_image do Meta Ads), abra um widget de upload no chat para que o usuário possa selecionar arquivos locais. Os arquivos vão diretamente do navegador para Windsor.ai, sem passar pelo assistente; o resultado (por exemplo, um image_hash por imagem) pode então ser usado em execute_action. Clientes que não conseguem renderizar o widget recebem um comando curl. O link de upload é válido por dez minutos e para um único upload.

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

  • get_connector_connect_info: Obtenha o tipo de autenticação de um conector, o 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: Obtenha um link de login automático para o painel Windsor.ai do usuário.
  • get_subscription_url: Obtenha um link Markdown para a página de preços ou de upgrade de plano da Windsor.ai. Retorna apenas um link; nunca inicia uma compra nem altera o plano.
  • contact_windsor: Envie uma mensagem de suporte, feedback ou solicitação de recurso para Windsor.ai e receba um ID de referência.

Ferramentas de exportação agendada: configure exportações recorrentes de dados de conectores para um destino, pelo chat.

  • get_destinations: Liste os 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: Obtenha os requisitos de configuração para uma nova exportação agendada: campos de destino, agendas permitidas, credenciais reutilizáveis e um URL de configuração.
  • get_destination_tasks: Liste as tarefas de exportação agendada existentes do usuário, com destino, conector, agenda e status.
  • create_destination_task: Crie uma exportação recorrente dos dados de um conector para um destino, conforme uma agenda.

Para ver as assinaturas completas dos parâmetros, consulte /llms-full.txt.

Exemplos de prompts

O servidor raiz também oferece prompts MCP que os clientes podem exibir como sugestões de início com um clique: listar fontes conectadas, adicionar uma fonte de dados e listar campanhas em andamento nas plataformas de anúncios.

Endpoints com escopo definido

Além do endpoint principal, o mesmo servidor está disponível em URLs mais específicas. As ferramentas são as mesmas, mas apenas os conectores listados estão no escopo, mantendo o assistente focado e a lista de conectores curta:

  • Por conector: https://mcp.windsor.ai/<connector>/, por exemplo, https://mcp.windsor.ai/facebook/ para Meta Ads ou https://mcp.windsor.ai/google_ads/ para Google Ads. Qualquer slug de conector de /datasources funciona.
  • Por caso de uso: conjuntos selecionados de conectores relacionados.
EndpointConectores
/paid_media/Meta Ads, Google Ads, TikTok Ads, Microsoft Ads (Bing), LinkedIn Ads, Amazon Ads
/search_ads/Google Ads, Microsoft Ads (Bing), Yahoo! JAPAN Ads
/social_ads/Meta Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, Snapchat Ads
/social_media/Instagram, Facebook Pages, TikTok Organic, YouTube, LinkedIn Pages, Google Business Profile
/crm/HubSpot, Salesforce, Pipedrive, GoHighLevel, Zoho CRM, ActiveCampaign
/ecommerce/Shopify, Amazon Seller Central, WooCommerce, BigCommerce, Klaviyo, Google Merchant Center
/finance/Stripe, QuickBooks, PayPal, Xero, Chargebee, Braintree
/web_analytics/Google Analytics 4, Search Console, Adobe Analytics, Amplitude, Mixpanel, Matomo

🤝 Clientes de IA compatíveis

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 plugin do ChatGPT · guia de configuraçãoOAuth 2.0~30 segundos
Microsoft CopilotConector Windsor.ai para Power Platform; consulte o guia de integraçãoChave de API~5 minutos
PerplexityConsulte o guia de configuraçãoOAuth 2.0~1 minuto
Claude Codeclaude plugin install windsor-ai (código-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 servidor MCP; consulte 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/); consulte o guia de configuração genéricoOAuth 2.0~1 minuto
Gemini CLIEdite ~/.gemini/settings.json (configuração abaixo); consulte o guia de configuraçãoOAuth 2.0~2 minutos

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


📦 Fontes de dados compatíveis

Mais de 350 conectores para publicidade, análise, redes sociais orgânicas, CRM, automação de marketing, comércio eletrônico, pagamentos, afiliados, análise de aplicativos, suporte, produtividade, bancos de dados e data 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 pesquisa: Google Analytics 4, Adobe Analytics, Mixpanel, Amplitude, Matomo, Plausible, PostHog, Search Console, Bing Webmaster, Looker, Metabase.
  • Redes sociais orgânicas: Facebook Organic, Instagram, LinkedIn Organic, TikTok Organic, Pinterest Organic, X Organic, 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.
  • Comércio eletrônico 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.
  • Suporte e atendimento: 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 e 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) em qualquer cliente MCP para obter a lista atualizada ou acesse /datasources diretamente.


🚀 Primeiros passos

Consulte nossa documentação oficial

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 com um clique: claude.ai/directory/360c0c31-4bb6-42ca-8e50-5da0a100a68e

Pré-requisitos

  • Uma conta Claude (Claude Desktop, Web ou Code) em um plano compatível com conectores
  • Uma conta Windsor.ai

Etapas

  1. Abra o link de instalação acima (ou acesse Settings → Connectors 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 fazer perguntas 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 de barra e um agente analista:

claude plugin install windsor-ai

Código-fonte: github.com/windsor-ai/claude-windsor-ai-plugin.


Opção 2: ChatGPT (plugin nativo)

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

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

Pré-requisitos

  • Um plano do ChatGPT compatível com plugins
  • Uma conta Windsor.ai

Etapas

  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 do Power Platform)

Use a Windsor.ai em 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 do Power Platform
  • Uma conta Windsor.ai e uma chave de API (em onboard.windsor.ai)

Etapas

  1. No Copilot Studio, adicione uma nova ação e pesquise 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. Consulte o passo a passo 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

Etapas

  1. Abra as configurações do Cursor → Tools & Integrations → New MCP Server.
  2. Cole o seguinte em mcp.json:
{
  "mcpServers": {
    "windsor": {
      "url": "https://mcp.windsor.ai/"
    }
  }
}
  1. O Cursor guiará você pelo processo de autorização OAuth no primeiro uso. Comece a consultar seus dados imediatamente.

Opção 5: Manus

O Manus oferece suporte nativo a servidores MCP remotos. Consulte o passo a passo completo no guia de integração da Windsor.ai para Manus.

Etapas

  1. No Manus, abra Settings → MCP Servers → Add server.
  2. Use o 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

Etapas

  1. Instale o Gemini CLI:
npm install -g @google/gemini-cli
  1. Execute gemini uma vez para gerar o diretório de configuração e, em seguida, 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. 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. Consulte windsor.ai/pricing para saber mais.

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 (por meio do conector do Power Platform), Cursor, Windsurf, Cline, GitHub Copilot, Gemini, Manus, n8n, mcp-proxy e clientes MCP personalizados. Consulte a tabela de 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, relatórios entre canais, consultas a data warehouses e muito mais. Se estiver nos seus dados da Windsor.ai, você pode perguntar. Nos conectores que têm ações de gravação (incluindo Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads/Bing, Pinterest, Snapchat, Amazon Ads, Instagram, Facebook Pages, Google Business Profile, Google Merchant Center, WooCommerce, TikTok Shop, Salesforce, Klaviyo, Stripe e WordPress; consulte a documentação das ações de gravação e a lista atualizada de /actions), você também pode pedir ao assistente que aja com base no que encontrar. Por exemplo: "pause as campanhas que tiveram gastos, mas não converteram na semana passada", "reduza o orçamento diário desta campanha em 20%" ou "responda à nossa avaliação mais recente, depois que eu aprovar".

Quais fontes de dados o Windsor MCP oferece?

Mais de 350 conectores para publicidade, análise, 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 ver os destaques por categoria.

Preciso escrever SQL ou configurar painéis?

Não. Basta fazer suas perguntas em linguagem simples e receber 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 o OAuth do MCP com Dynamic Client Registration; clientes compatíveis com OAuth do MCP (Claude, ChatGPT, Cursor, Manus) descobrem os endpoints automaticamente. Para configurações que aceitam apenas chaves de API, passe sua chave da Windsor.ai como um token Bearer pelo cabeçalho Authorization.

Meus dados estão seguros com o Windsor MCP?

Sim. O Windsor MCP disponibiliza ferramentas de leitura (que apenas buscam dados) e um pequeno número de ferramentas de gravação (list_actions, execute_action, upload_files) nos conectores que têm ações de gravação, como pausar ou ativar uma campanha publicitária. As ações de gravação são explicitamente sinalizadas como destrutivas para os clientes MCP, que solicitam sua confirmação antes de executá-las; nada é alterado nas suas fontes sem sua aprovação. Ações que iniciam ou aumentam os gastos com anúncios também exigem um token de confirmação único, obtido em uma prévia, antes de serem executadas. Os arquivos enviados vão diretamente do seu navegador para a Windsor.ai, nunca passam pelo assistente de IA. A autenticação é feita por OAuth 2.0; o servidor MCP não armazena sua senha da Windsor.ai nem retém os resultados das consultas. Os dados são transmitidos por TLS. A Windsor.ai tem conformidade com SOC 2. Para saber mais, consulte windsor.ai/security.

Qual é a diferença entre o Windsor MCP e outras ferramentas de integração de dados?

O Windsor MCP é um servidor MCP nativo, não um plugin nem um wrapper, por isso funciona em qualquer cliente compatível com MCP sem proxies. A Windsor.ai inclui destinos de data warehouses e bancos de dados (BigQuery, Snowflake, Redshift, S3, MySQL, Postgres) nos 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 comparar os recursos em detalhes.

Quanto custa a Windsor.ai?

A Windsor.ai tem um plano gratuito para sempre. Os planos pagos oferecem 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 ver os preços atuais.

O Windsor MCP funciona em dispositivos móveis?

O servidor hospedado é independente de plataforma, mas o suporte para dispositivos móveis depende do cliente de IA usado. Claude Web/Desktop, ChatGPT Web/Desktop e Cursor Desktop são totalmente compatíveis atualmente; o suporte a MCP em dispositivos móveis varia conforme o cliente e está sendo disponibilizado gradualmente.

Onde posso obter ajuda?

Para suporte ou comentários, entre em contato pelo endereço support@windsor.ai. Para relatar bugs específicos deste repositório, abra uma issue.


🧠 Experimente agora

Comece a consultar os dados da sua empresa pelo Windsor MCP. O caminho mais rápido é a instalação com um clique no Claude:

👉 Instalar no Claude: 30 segundos, sem chave de API.

Outras opções:

Para suporte ou comentários, entre em contato pelo endereço support@windsor.ai.