Reportei API/MCP Server
API Docs
MCP Server
MCP Server
API Docs
MCP Server v1.0

Reportei MCP Server

Conecte seu assistente de IA a 40 plataformas de marketing através do Model Context Protocol (MCP), um padrão aberto que permite que assistentes de IA — como Claude, Cursor e outros clientes compatíveis com MCP — leiam e ajam de forma segura sobre os dados da sua conta Reportei.

Com uma única conexão, seu assistente de IA pode listar projetos, buscar métricas de qualquer plataforma conectada, gerar relatórios, gerenciar dashboards, acompanhar KPIs, configurar automações e muito mais — tudo através de linguagem natural.

40

Plataformas de marketing

40+

Ferramentas MCP disponíveis

6

Prompts de análise integrados

Recursos

Acesso Unificado a Métricas

Obtenha dados de performance do Instagram, Facebook Ads, Google Analytics, YouTube, TikTok, LinkedIn, X (Twitter) e outras plataformas de marketing conectadas através de uma única interface.

Gestão de Relatórios e Dashboards

Crie, liste e inspecione relatórios de marketing e dashboards ao vivo. Obtenha links compartilháveis e recursos de exportação.

Acompanhamento de Metas e KPIs

Crie e monitore metas de KPI em qualquer métrica. Acompanhe o progresso, obtenha avaliações de situação e configure alertas.

Controle de Automações

Configure automações de relatórios agendados com canais de notificação por email, WhatsApp e no aplicativo.

Timeline e Marcos

Registre eventos importantes e anotações vinculados aos seus projetos. Perfeito para documentar lançamentos de campanhas ou mudanças de estratégia.

Assinaturas de Webhooks

Inscreva-se em eventos como visualizações de relatórios, metas atingidas e execuções de automações com notificações de webhook em tempo real.

Análise Cross-Channel

Compare performance entre canais, obtenha resumos agregados de campanhas, insights de audiência e análise de conteúdo mais relevante.

Prompts com IA

Prompts integrados para relatórios mensais, análise de campanhas de anúncios, verificações de saúde de SEO, auditorias de redes sociais e muito mais.

Configuração e Conexão

Conecte seu cliente de IA compatível com MCP ao Reportei em poucos passos. O servidor suporta descoberta automática e registro dinâmico de clientes — nenhuma configuração manual de chave de API necessária.

Pré-requisitos

  • Uma conta Reportei (plano Starter, PRO ou Premium)
  • Pelo menos uma integração conectada (ex: Instagram, Google Analytics, Facebook Ads)
  • Um cliente de IA compatível com MCP (Claude Desktop, Cursor ou qualquer cliente MCP)

Passos de Conexão

1

Adicione o servidor MCP Reportei

Nas configurações do seu cliente MCP, adicione um novo servidor MCP remoto com a URL:

https://app.reportei.com/mcp
2

Descoberta automática

Seu cliente descobrirá automaticamente os endpoints OAuth via URLs de metadados padrão. Nenhuma configuração manual necessária.

3

Autorize o acesso

Quando solicitado, faça login com seu email e senha do Reportei. Você verá uma tela de consentimento mostrando as permissões solicitadas. Clique em "Aprovar" para conceder acesso.

4

Comece a usar as ferramentas

Uma vez autorizado, seu assistente de IA tem acesso a todas as ferramentas e recursos do Reportei. Tente perguntar: "Liste meus projetos" ou "Mostre as métricas do Instagram do mês passado."

Configuração do Claude

No Claude, adicione o conector Reportei seguindo os passos abaixo:

  1. Vá até a aba de Conectores
  2. Clique em "Ir para Personalizar"
  3. Clique no botão "+" na coluna de conectores
  4. Clique em "Adicionar conector personalizado" e insira a URL abaixo
  • URL: https://app.reportei.com/mcp

Configuração do Cursor

No Cursor, vá em Settings > MCP Servers e adicione um novo servidor:

  • Tipo: Remote (Streamable HTTP)
  • URL: https://app.reportei.com/mcp

Configuração do Manus

No Manus, vá em Configurações > Conectores > Adicionar Conectores > Custom MCP > Configuração Direta:

O Manus não suporta autenticação OAuth nativamente. Você precisa adicionar manualmente um cabeçalho Authorization com um Bearer token. Use o token da API da sua empresa, disponível em Configurações > API Token no painel da Reportei.

  1. Acesse Configurações > Conectores no Manus
  2. Clique em "Adicionar Conectores" e selecione "Custom MCP"
  3. Selecione "Configuração Direta"
  4. Preencha o nome do servidor e a URL
  5. Adicione um cabeçalho personalizado: Authorization com o valor Bearer seguido do seu token da API da empresa
  • Nome do servidor: Reportei
  • Tipo de transporte: HTTP
  • URL: https://app.reportei.com/mcp
  • Cabeçalho: Authorization
  • Valor: Bearer <your-api-token>

Autenticação

O Reportei MCP Server usa OAuth 2.1 com PKCE (Proof Key for Code Exchange) para autenticação segura. Isso é tratado automaticamente por clientes compatíveis com MCP — você só precisa fazer login quando solicitado.

Como Funciona

1

Seu cliente MCP descobre os endpoints de autenticação automaticamente via URLs de metadados OAuth padrão.

2

O cliente se registra dinamicamente (RFC 7591) — nenhuma configuração manual de chave de API necessária.

3

Você é redirecionado para a página de login do Reportei onde faz login com seu email e senha.

4

Após o login, uma tela de consentimento mostra quais permissões estão sendo solicitadas. Você aprova ou nega.

5

Um token de acesso é emitido e seu cliente MCP o usa para todas as requisições subsequentes.

Padrões de Segurança

PadrãoFinalidade
OAuth 2.1Framework de autorização com PKCE obrigatório
RFC 7636 (PKCE S256)Proteção contra interceptação de código de autorização
RFC 7591Registro Dinâmico de Cliente (configuração automática)
RFC 9728Metadados de Recurso Protegido (auto-descoberta)
RFC 8414Metadados do Servidor de Autorização
RFC 8707Indicadores de Recurso para vinculação de audiência

Escopos

O servidor atualmente suporta o seguinte escopo:

EscopoDescrição
mcp:toolsAcesso a todas as ferramentas, recursos e prompts MCP

Acesso aos Dados

O token de acesso concede acesso aos dados da empresa que você é dono no Reportei. Todas as ferramentas e recursos são limitados à sua empresa — você só pode acessar seus próprios projetos, relatórios, integrações e métricas.

Ferramentas Disponíveis

Ferramentas são funções executáveis que seu assistente de IA pode chamar. Elas são organizadas por domínio.

Projetos

FerramentaDescriçãoTipo
get_company_settingsObter perfil da empresa, plano e configurações de recursosLeitura
list_projectsListar todos os projetos (clientes) com busca e paginaçãoLeitura
get_projectObter detalhes completos de um projetoLeitura

Integrações e Métricas

FerramentaDescriçãoTipo
list_integrationsListar contas de plataformas conectadas (filtrar por projeto ou slug)Leitura
get_integrationObter detalhes de uma integração conectadaLeitura
list_metricsDescobrir métricas disponíveis para um tipo de plataforma (por slug)Leitura
get_metrics_dataBuscar valores reais de métricas para um períodoLeitura

Relatórios e Dashboards

FerramentaDescriçãoTipo
list_reportsListar snapshots de relatórios estáticos com filtrosLeitura
get_reportObter detalhes do relatório com URLs compartilháveisLeitura
create_reportCriar um novo relatório estático com template e integraçõesEscrita
list_dashboardsListar dashboards ao vivo que atualizam ao visualizarLeitura
get_dashboardObter detalhes do dashboard com URLs compartilháveisLeitura
create_dashboardCriar um novo dashboard ao vivoEscrita
list_templatesListar templates disponíveis de relatórios e dashboardsLeitura

Análises e Campanhas

FerramentaDescriçãoTipo
get_performance_summaryKPIs agregados de todas as integrações para um períodoLeitura
compare_periodsComparar métricas entre dois períodosLeitura
get_top_contentTop posts/conteúdo por engajamento de plataformas sociaisLeitura
get_channel_breakdownDesempenho detalhado por categoria de canalLeitura
get_campaign_summaryPerformance agregada de campanhas de anúncios entre plataformasLeitura
get_audience_insightsDemografia da audiência (idade, gênero, localização)Leitura

Metas e KPIs

FerramentaDescriçãoTipo
list_goalsListar metas de KPI acompanhadas de um projetoLeitura
get_goal_progressObter progresso detalhado de uma meta específicaLeitura
create_goalCriar uma nova meta de KPI para uma métricaEscrita
update_goalAtualizar valor alvo ou configurações de alerta de uma metaEscrita

Automações

FerramentaDescriçãoTipo
list_automationsListar automações de relatórios de um projetoLeitura
get_automationObter detalhes de uma automação específicaLeitura
create_automationCriar uma automação de relatório agendada (inicia desabilitada)Escrita
update_automationAtualizar configurações da automação (agenda, destinatários, canais)Escrita
toggle_automationHabilitar ou desabilitar uma automaçãoEscrita

Eventos de Timeline

FerramentaDescriçãoTipo
list_timeline_eventsListar eventos de timeline (marcos, notas, anotações)Leitura
get_timeline_eventObter detalhes de um evento de timelineLeitura
create_timeline_eventCriar um evento de timeline com conteúdo HTMLEscrita
update_timeline_eventAtualizar um evento de timeline existenteEscrita
delete_timeline_eventExcluir permanentemente um evento de timelineExclusão

Webhooks

FerramentaDescriçãoTipo
list_webhooksListar assinaturas de webhooksLeitura
create_webhookInscrever-se em eventos (report_viewed, goal_met, etc.)Escrita
update_webhookAtualizar URL ou escopo de uma assinatura de webhookEscrita
delete_webhookRemover uma assinatura de webhookExclusão

Recursos

Recursos são endpoints de dados somente leitura que fornecem contexto ao seu assistente de IA. São acessados via URIs reportei://.

URIDescrição
reportei://company/settingsPerfil da empresa, plano, status da assinatura e flags de recursos
reportei://projectsTodos os projetos (clientes) da empresa
reportei://projects/{projectId}Detalhes completos de um projeto específico
reportei://projects/{projectId}/integrationsIntegrações conectadas de um projeto
reportei://projects/{projectId}/reportsRelatórios recentes de um projeto
reportei://projects/{projectId}/dashboardsDashboards recentes de um projeto
reportei://projects/{projectId}/automationsAutomações agendadas de um projeto
reportei://projects/{projectId}/goalsMetas de KPI acompanhadas de um projeto
reportei://projects/{projectId}/timelineEventos de timeline recentes de um projeto
reportei://integrations/typesTodos os tipos de integração conectados com slugs
reportei://integrations/{slug}/metricsMétricas disponíveis para um tipo de integração
reportei://templatesTodos os templates disponíveis de relatórios e dashboards
reportei://webhooks/eventsTodos os tipos de eventos de webhook

Prompts Integrados

Fluxos de análise pré-construídos que guiam seu assistente de IA através de análises de marketing complexas. Cada prompt orquestra múltiplas ferramentas para produzir relatórios abrangentes.

Relatório Mensal do Cliente

client_monthly_report

Gera um relatório mensal completo de marketing para um cliente — seleciona template, descobre integrações, cria o relatório e fornece uma URL compartilhável.

Parâmetros: projectId, month, year

Análise de Campanhas de Anúncios

ad_campaign_analysis

Analisa a eficiência publicitária em todas as plataformas de anúncios conectadas. Avalia gasto, ROAS, CPC, conversões e fornece recomendações de otimização.

Parâmetros: projectId, startDate, endDate

Verificação de Saúde SEO

seo_health_check

Realiza uma verificação completa de saúde de SEO e web analytics usando Google Analytics 4 e Search Console. Retorna uma pontuação de saúde (0-100) com recomendações acionáveis.

Parâmetros: projectId, startDate, endDate

Comparação Cross-Channel

cross_channel_comparison

Compara performance em todas as plataformas conectadas. Normaliza métricas entre social, anúncios, analytics, e-commerce e CRM para identificar os canais mais eficientes.

Parâmetros: projectId, startDate, endDate

Auditoria de Redes Sociais

social_media_audit

Audita a performance de redes sociais em todas as plataformas sociais conectadas. Analisa engajamento, crescimento de seguidores, alcance e performance de conteúdo com ranking de canais.

Parâmetros: projectId, startDate, endDate

Revisão de Performance de Marketing

marketing_performance_review

Revisão completa de performance em todas as plataformas conectadas — social, publicidade, web analytics, e-commerce, CRM e email marketing combinados.

Parâmetros: projectId, startDate, endDate

Exemplos de Uso

Aqui estão fluxos de trabalho comuns que você pode realizar com seu assistente de IA uma vez conectado ao Reportei MCP Server.

Verificar Performance do Instagram

Você:

“Mostre a performance do Instagram da Acme Corp no mês passado.”

O que acontece por trás:

  1. list_projects — Encontra "Acme Corp" e obtém o ID do projeto
  2. list_integrations — Encontra a integração do Instagram Business
  3. list_metrics — Descobre as métricas disponíveis do Instagram
  4. get_metrics_data — Busca os dados reais para o período

Resultado:

Seu assistente apresenta seguidores, taxa de engajamento, alcance, impressões, top posts e demografia da audiência — com comparação ao período anterior se disponível.

Gerar um Relatório Mensal

Você:

“Crie um relatório para a Acme Corp de fevereiro de 2026.”

O que acontece por trás:

  1. list_projects — Encontra o projeto
  2. list_integrations — Descobre todas as plataformas conectadas
  3. list_templates — Mostra os templates de relatório disponíveis
  4. confirm — Confirma o template e as integrações com você
  5. create_report — Gera o relatório com todos os dados

Resultado:

Um relatório de marketing completo é criado com um link compartilhável que você pode enviar diretamente ao seu cliente.

Comparar Performance de Anúncios entre Plataformas

Você:

“Compare a performance de anúncios da Acme Corp no Q1 2026 — Facebook Ads vs Google Ads vs TikTok Ads.”

O que acontece por trás:

  1. get_campaign_summary — Métricas agregadas de anúncios de todas as plataformas
  2. compare_periods — Compara Q1 2026 vs Q4 2025
  3. get_channel_breakdown — Performance por categoria de canal

Resultado:

Uma comparação detalhada mostrando gasto, CPC, ROAS, conversões e recomendações para alocação de orçamento entre suas plataformas de anúncios.

Configurar uma Meta de KPI

Você:

“Crie uma meta mensal para a Acme Corp: alcançar 10.000 seguidores no Instagram até o final do mês.”

O que acontece por trás:

  1. list_integrations — Encontra a integração do Instagram e seu ID de origem
  2. list_metrics — Descobre a chave de referência da métrica de seguidores
  3. create_goal — Cria a meta de KPI com valor alvo de 10.000

Resultado:

A meta é criada e acompanhada. Pergunte "Como está a meta de seguidores do Instagram?" a qualquer momento para verificar o progresso.

Plataformas Suportadas

Reportei conecta a 40 plataformas de marketing em múltiplas categorias. Uma vez que uma plataforma é conectada em sua conta Reportei, seus dados ficam disponíveis através do servidor MCP.

Redes Sociais

Instagram Business, Facebook, YouTube, LinkedIn, TikTok, Pinterest, X (Twitter), Threads

Publicidade

Facebook Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, Microsoft Ads, Spotify Ads

Web Analytics

Google Analytics 4, Google Search Console

E-commerce

Shopify, WooCommerce, Hotmart, Kiwify

CRM e Vendas

HubSpot, Pipedrive, RD Station CRM

Email Marketing

Mailchimp, RD Station Marketing, Active Campaign

Outros

Google My Business, Google Sheets e mais de 15 outros

Perguntas Frequentes

Vejo erros "Unauthorized" ou "No Bearer token provided"
Seu cliente MCP precisa completar o fluxo OAuth. Reinicie a conexão nas configurações do seu cliente MCP. Se o problema persistir, tente remover e adicionar novamente o servidor Reportei.
Autorizei mas minhas ferramentas não retornam dados
Certifique-se de ter pelo menos um projeto com integrações conectadas na sua conta Reportei. Use list_projects e list_integrations para verificar.
A ferramenta "create_report" retorna erro de limite de recursos
Seu plano atual do Reportei tem um limite de relatórios que podem ser gerados. Verifique os limites do seu plano em reportei.com ou use a ferramenta get_company_settings para ver seus limites atuais.
Dados de métricas retornam "no_data_in_period"
A integração pode não ter dados para o período solicitado. Tente um período diferente, ou verifique se a conta da plataforma ainda está conectada e ativa no Reportei.
Métricas retornam status "expired_token"
O token OAuth daquela plataforma expirou no Reportei. Faça login na sua conta Reportei e reconecte a integração para renovar o token.
Quais dados da empresa o servidor MCP acessa?
O servidor MCP acessa apenas os dados da empresa que você é dono no Reportei. Se você pertence a múltiplas empresas, o token MCP é limitado à sua empresa proprietária.
Posso usar o MCP com membros da minha equipe?
Atualmente, o servidor MCP é limitado à conta do proprietário da empresa. Membros da equipe não podem autorizar o acesso MCP independentemente.
Quais clientes MCP são suportados?
Qualquer cliente compatível com MCP que suporte transporte Streamable HTTP e OAuth 2.1 com PKCE. Isso inclui Claude Desktop, Cursor e outras aplicações habilitadas para MCP.
Existe limite de requisições?
O servidor MCP usa os mesmos limites de requisição da API v2 do Reportei. O uso típico através de um assistente de IA está bem dentro dos limites. Se encontrar limitação de taxa, reduza a frequência das requisições.
Posso revogar o acesso MCP?
Sim. Vá nas configurações da sua conta Reportei, encontre a seção de Tokens de API e exclua o token OAuth do MCP. Isso revoga imediatamente o acesso para todos os clientes MCP que usam aquele token.

Política de Privacidade

Seus dados são processados de forma segura. O servidor MCP acessa apenas os dados da sua conta Reportei e não os compartilha com terceiros. Toda comunicação usa criptografia HTTPS.

Leia nossa Política de Privacidade completa

Suporte

Se precisar de ajuda com o servidor MCP ou tiver dúvidas sobre integração, nossa equipe de suporte está aqui para ajudar.

  • [email protected]
  • reportei.com