MCP Server
Conecte o CrazyLeads diretamente a assistentes de IA como Claude, Cursor ou qualquer cliente compativel com o Model Context Protocol (MCP). Consulte leads, crie dashboards, gere SQL, gerencie datasets e adicione gráficos usando linguagem natural.
Como Conectar
O CrazyLeads MCP é um servidor HTTPS com autenticação via OAuth 2.1. Você não precisa instalar pacotes nem gerenciar API keys — basta adicionar a URL do servidor no seu cliente e fazer login na sua conta CrazyLeads quando o cliente pedir.
| Campo | Valor |
|---|---|
| URL do servidor | https://mcp.crazyleads.com.br/mcp |
| Transporte | Streamable HTTP |
| Autenticação | OAuth 2.1 (PKCE + Dynamic Client Registration) |
| Escopos | mcp:read mcp:write |
O fluxo de login abre uma aba do navegador, você escolhe o projeto que a IA poderá acessar e autoriza. O token fica salvo no cliente — não há API key pra rotacionar.
Claude Desktop
Abra Settings → Connectors, clique em Add custom connector e cole a URL:
https://mcp.crazyleads.com.br/mcpO Claude abre o login do CrazyLeads no navegador. Após autorizar, selecione o projeto na tela de consentimento. O conector aparece com status Connected e as 75 tools ficam disponíveis na conversa.
Claude.ai (Web)
Em claude.ai/settings/connectors, escolha Add custom connector e use a mesma URL acima. O fluxo de autorizacao e identico ao do Desktop.
Disponível em planos Pro, Team e Enterprise.
Claude Code (CLI)
Adicione o servidor pelo CLI — o Claude Code cuida do fluxo OAuth no primeiro uso:
claude mcp add --transport http crazyleads https://mcp.crazyleads.com.br/mcpUse --scope user pra disponibilizar em todos seus projetos, ou --scope project pra compartilhar com a equipe (gera um .mcp.json no repo).
Pra checar o status ou reautenticar: /mcp dentro do Claude Code.
ChatGPT
No ChatGPT (plano Plus, Pro, Business ou Enterprise), abra Settings → Connectors → Add e selecione Custom MCP server. Use:
https://mcp.crazyleads.com.br/mcpAutorize com sua conta CrazyLeads na janela que abrir e escolha o projeto. As tools ficam disponíveis dentro de conversas e em Deep Research.
Cursor
Adicione ao ~/.cursor/mcp.json (global) ou .cursor/mcp.json (no projeto):
{
"mcpServers": {
"crazyleads": {
"url": "https://mcp.crazyleads.com.br/mcp"
}
}
}O Cursor detecta o servidor e abre o fluxo OAuth automaticamente na primeira chamada.
Outros Clientes MCP
Qualquer cliente compativel com a especificacao Model Context Protocol (transporte Streamable HTTP + OAuth 2.1) funciona — basta apontar pra https://mcp.crazyleads.com.br/mcp. O servidor expõe as metadatas exigidas pelo padrão:
/.well-known/oauth-protected-resource— descobre o servidor de autorizacaohttps://crazyleads.com.br/.well-known/oauth-authorization-server— endpoints OAuth (authorize, token, register, revoke)
O cliente registra-se sozinho via Dynamic Client Registration (RFC 7591) — não há cadastro manual de aplicação.
Projeto Ativo
O token OAuth fica vinculado a um projeto ativo — o que você selecionou na tela de consentimento. Todas as tools operam sobre esse projeto.
- Use
get_active_projectpra ver qual projeto a IA está usando agora. - Use
list_projectspra ver todos os projetos a que você tem acesso. - Use
set_active_projectpra trocar de projeto dentro da mesma conversa — sem precisar reautenticar.
Treinamento da IA via MCP
O MCP Server envia automaticamente um conjunto completo de instruções para a IA, ensinando-a a trabalhar com seus dados de forma inteligente. A IA recebe treinamento sobre:
Data Discovery Automático
A IA e treinada para investigar antes de construir. Antes de criar qualquer dashboard, ela executa queries exploratórias automaticamente para descobrir:
- Produtos distintos e suas frequencias (Hotmart)
- Campanhas, adsets e distribuição de gastos (Facebook/Google Ads)
- UTM sources, campaigns e mediums (Pixel/Page Events)
- Padrões de nomenclatura entre fontes de dados
- Campos disponíveis e seus tipos por fonte
Fontes de Dados
A IA conhece todas as fontes de dados do CrazyLeads e sabe como usar cada uma:
- Pixel / Page Events — trafego, pageviews, sessoes, UTMs, funis
- Hotmart / Payment — vendas, receita, reembolsos, comissões, multi-moeda
- Facebook Ads — gastos, impressões, cliques, CTR, CPC, conversões
- Google Ads — campanhas de search, display, video
- Conversions — eventos de conversão customizados
- Custom SQL — queries cruzadas entre fontes
- Datasets — tabelas customizadas para dados externos
Regras de Negócio
A IA e treinada com regras criticas do dominio:
- Vendas Hotmart: status IN ('APPROVED', 'COMPLETE') apenas
- Receita: usa commission_producer_value (não price_value)
- Multi-moeda: nunca mistura BRL + USD em um SUM
- list_tables primeiro: descobrir o dado antes de escrever SQL
- test_sql antes de afirmar: nunca adivinhar grafias de status ou nomes de campos
- Guias de autoria: artefatos, Envios e experimentos têm guia próprio, lido antes do primeiro create
Analise Cross-Source
A IA sabe combinar dados de fontes diferentes para criar métricas cruzadas:
- CPA: SUM(facebook.spend) / COUNT(hotmart.sales)
- ROAS: SUM(hotmart.revenue) / SUM(facebook.spend)
- Taxa de Conversão: COUNT(conversions) / COUNT(DISTINCT page.visitors)
- Virtual fields unificados: coluna 'produto' consistente entre Hotmart, Facebook e Pages
Artefatos e Apresentação
A IA segue o guia de autoria dos artefatos ao montar relatórios:
- KPIs primeiro, série temporal no meio, tabela de detalhe por último
- Formatação por tipo de grandeza (R$, %, inteiros) definida nas queries
- Uma query por pergunta, nomeada por slug — edição reconcilia por slug
- Publicação e compartilhamento só quando o usuário pede
Fluxo de Criação de Relatório (artefato)
Para criar um relatório/dashboard vivo, a IA segue esta ordem:
Descobrir dados disponíveis
list_tables mostra as tabelas e colunas do projeto — sempre o primeiro passo.
Entender o contexto
A IA pergunta sobre o negócio: quais produtos, como agrupar campanhas, quais métricas importam.
Explorar e validar
test_sql roda queries exploratórias contra o dado real: valores distintos, grafias de status, distribuição.
Ler o guia de autoria
get_artifact_authoring_guide traz o contrato de queries, layout e boas práticas do artefato.
Criar o artefato
create_artifact com as queries validadas. O resultado é uma página viva, hospedada, com link compartilhável (publish_artifact / share_artifact).
Editar com segurança
get_artifact lê a definição atual; update_artifact reconcilia as queries POR SLUG — sempre reenvie o conjunto completo.
Tools de Leads
Consulte, busque e analise seus leads com filtros avançados.
list_leadsLista leads com filtros avançados e paginacao. Retorna dados resumidos de cada lead (nome, email, telefone, status, datas).
limitnumber1-200, padrão 20offsetnumberOffset para paginacaoorder_bystring[]Ordenação (ex: ["-created_at"]). Padrão: mais recentesstatusstringactive, merged_into, archivedemailstringFiltro por email (contains)phonestringFiltro por telefone (contains)namestringFiltro por nome (contains)countrystringCódigo do país (BR, US...)has_emailbooleanFiltra leads com emailhas_phonebooleanFiltra leads com telefonecreated_afterstringData ISO 8601created_beforestringData ISO 8601segment_idstringUUID do segmentofeature_idstringUUID da featureget_leadRetorna detalhe completo de um lead: emails, telefones, devices, endereços, atributos por namespace, merge info e estatísticas.
lead_idstringUUID do leadget_lead_timelineRetorna timeline de atividades do lead: pageviews, purchases, conversions e outros eventos com dados de UTM e transação.
lead_idstringUUID do leadlimitnumber1-200, padrão 50offsetnumberOffset para paginacaoactivity_typesstringTipos separados por virgula (pageview,purchase...)start_datestringData ISO 8601end_datestringData ISO 8601search_leadsBusca leads por nome, email ou telefone (OR-based matching). Retorna leads com dados resumidos.
querystringTexto para buscar em nome, email e telefonelimitnumber1-100, padrão 10count_leadsConta total de leads com filtros. Útil para estatísticas rápidas sem buscar dados completos.
statusstringactive, merged_into, archivedhas_emailbooleanFiltra por tem emailhas_phonebooleanFiltra por tem telefonecountrystringCódigo do paíscreated_afterstringData ISO 8601created_beforestringData ISO 8601segment_idstringUUID do segmentofeature_idstringUUID da featureTools de Projetos, Membros e Integrações
Gerencie projetos, membros do time e integrações (fontes de dados) direto da IA. Todas operam no contexto do projeto ativo, exceto as de projeto que listam/criam workspaces.
Projetos
list_projectsLista todos os projetos a que você tem acesso, com nome, slug e role.
get_active_projectRetorna qual projeto a IA está usando agora (vinculado ao token OAuth da sessão).
set_active_projectTroca o projeto ativo da sessão para outro projeto onde você é membro. Útil pra alternar entre projetos sem reautenticar.
project_idstringUUID do projeto destinocreate_projectCria um novo projeto e te coloca como owner.
namestringNome do projetoslugstringSlug (opcional, gerado a partir do nome)update_projectAtualiza nome e/ou slug do projeto ativo. Requer role admin ou owner.
namestringNovo nomeslugstringNovo slugMembros
list_membersLista membros ativos do projeto com email, nome e role.
invite_memberEnvia convite por email para outra pessoa entrar no projeto.
emailstringEmail do convidadoroleenumowner, admin, editor, viewerlist_invitesLista convites pendentes do projeto.
cancel_inviteCancela um convite pendente.
invite_idstringUUID do conviteupdate_member_roleAltera a role de um membro existente. Requer role admin ou owner.
member_idstringUUID do membroroleenumowner, admin, editor, viewerremove_memberRemove um membro do projeto. Requer role admin ou owner.
member_idstringUUID do membroIntegrações
list_integrationsLista todas as integrações do projeto ativo (Hotmart, Facebook Ads, Google Ads, Pixel, etc.) com status de sync.
get_integrationRetorna detalhes de uma integração, incluindo config, última sincronização e estatísticas.
integration_idstringUUID da integraçãocreate_integrationCria uma nova integração no projeto ativo. O fluxo de autorizacao (OAuth do provider, webhook secret) deve ser completado pela UI depois.
providerenumhotmart, facebook_ads, google_ads, pixel, conversion, activecampaign, generic_webhook, tally...namestringNome amigavelconfigobjectConfig específica do provider (account_id, tracking ID, etc.)update_integrationAtualiza nome ou config de uma integração.
integration_idstringUUID da integraçãonamestringNovo nomeconfigobjectNovo config (partial)delete_integrationRemove uma integração. Dados ja importados permanecem; sync futuro para.
integration_idstringUUID da integraçãotrigger_integration_syncDispara uma sincronização manual de uma integração. Útil pra puxar dados recentes sem esperar o cron.
integration_idstringUUID da integraçãoTools de SQL
Explore as tabelas do projeto e valide SQL contra o dado real antes de usá-lo num artefato.
list_tablesLista todas as tabelas e colunas disponíveis no projeto. Nomes seguem o padrão {type}_{slug} (ex: hotmart_htm_rtg, page_events).
SEMPRE chame esta tool primeiro, antes de escrever SQL.
test_sqlTesta uma query SQL com LIMIT e retorna resultados de amostra. Use nomes reais de tabelas de list_tables. Para vendas, filtre por status IN ('APPROVED', 'COMPLETE').
sqlstringQuery SQL para testarstart_datestringData início (YYYY-MM-DD)end_datestringData fim (YYYY-MM-DD)Tools de Artefatos (relatórios e dashboards)
Dashboards e relatórios são artefatos: páginas vivas, hospedadas, renderizadas sobre queries SQL — criadas e editadas pela conversa. As tools antigas de dashboard/gráfico/aba foram descontinuadas e substituídas por este fluxo.
get_artifact_authoring_guideGuia de autoria de artefatos. SEMPRE chame antes do primeiro create_artifact — traz o contrato de queries, layout e boas práticas.
create_artifactCria um artefato vivo (relatório/dashboard) com um conjunto de queries SQL nomeadas por slug e um template de renderização.
get_artifactLê a definição completa (queries por slug e, opcionalmente, o HTML) de um artefato existente — o par de leitura do update.
update_artifactAtualiza um artefato. Reconcilia as queries POR SLUG e apaga as órfãs: sempre leia com get_artifact e reenvie o conjunto completo.
publish_artifactPublica o artefato com link compartilhável; list_artifacts, share_artifact e delete_artifact completam o ciclo de vida.
Tools de Envios (destinos)
Encaminhe eventos resolvidos do CDP para Meta CAPI, webhooks e demais destinos — com filtro, mapeamento e validação contra eventos reais.
get_envio_authoring_guideGuia de autoria de Envios. SEMPRE chame antes do primeiro create_envio.
create_envioCria um Envio (conversão + assinatura no destino). Aceita dry_run para validar tudo sem escrever nada, e devolve o teste do filtro contra eventos reais.
get_event_samplesAmostras REAIS do payload resolvido por evento — meça o que chega ANTES de mapear ou filtrar.
get_envio_deliveriesEntregas recentes de um Envio; get_envio_stats e get_envio_param_coverage cobrem saúde e cobertura de parâmetros (em, ph, fbc, fbp).
list_destinationsDestinos do projeto; create_destination, update_destination, test_destination, get_destination_health e reactivate_destination completam o ciclo.
Tools de Experimentos (A/B)
O pixel serve variantes por visitante (bucketing estável) e mede o vencedor — incluindo compra server-side casada por identidade.
get_experiment_authoring_guideGuia de autoria. SEMPRE chame antes do primeiro create_experiment.
create_experimentCria o experimento (targeting, variantes com operações de DOM ou redirect, meta de conversão). activate_experiment liga; pause_experiment pausa.
get_experiment_reportRelatório com exposições, conversões, confiança bayesiana e vencedor; aceita recorte por página e eventos secundários.
list_purchase_productsProdutos com venda no período — copie o nome exato para goal.product quando a meta é venda real.
Tools de Datasets
Gerencie datasets customizados: tabelas de dados estruturados para importar dados externos (CSVs, APIs) e usar junto com as outras fontes de dados.
Gerenciamento
list_datasetsLista todos os datasets do projeto com id, slug, nome, descrição, storage_class, versão atual e resumo do schema.
get_datasetRetorna detalhes completos de um dataset incluindo schema (colunas, índices) e informações de versão.
dataset_idstringUUID do datasetcreate_datasetCria um novo dataset com definição de schema. Após criação, chame publish_dataset_version para ativar.
namestringNome do datasetdescriptionstringDescriçãocolumnsobject[]Definição de colunas: [{ name, kind, nullable?, unique?, default_value? }]. Kind: TEXT, INTEGER, DECIMAL, BOOLEAN, TIMESTAMP, JSON, UUIDupdate_datasetAtualiza metadados do dataset (nome e/ou descrição).
dataset_idstringUUID do datasetnamestringNovo nomedescriptionstringNova descriçãodelete_datasetSoft-delete de um dataset. O dataset é desativado mas não removido fisicamente.
dataset_idstringUUID do datasetSchema e Versionamento
get_dataset_schemaRetorna o schema atual (colunas e índices) de um dataset.
dataset_idstringUUID do datasetadd_dataset_columnAdiciona uma coluna ao dataset. Cria uma versão draft. Chame publish_dataset_version para aplicar.
dataset_idstringUUID do datasetnamestringNome da colunakindenumTEXT, INTEGER, DECIMAL, BOOLEAN, TIMESTAMP, JSONnullablebooleanPermite nulos (padrão: true)uniquebooleanValores únicos (padrão: false)default_valuestringValor padrãoupdate_dataset_columnAtualiza uma coluna com mudanças seguras (ordem, default_value, relaxar constraints). NÃO cria nova versão.
dataset_idstringUUID do datasetcolumn_namestringNome da colunaordernumberNova ordemdefault_valuestringNovo valor padrãoremove_dataset_columnRemove uma coluna do dataset. Cria versão draft. Chame publish_dataset_version para aplicar.
CUIDADO: Dados da coluna são permanentemente perdidos após o publish.
dataset_idstringUUID do datasetcolumn_namestringNome da coluna a removerpublish_dataset_versionPublica mudanças de schema pendentes (adicoes/remocoes de colunas). Aplica todas as mudanças de uma vez.
dataset_idstringUUID do datasetrollback_dataset_versionFaz rollback do dataset para um número de versão anterior.
dataset_idstringUUID do datasetversionnumberNúmero da versão para restaurarDados
query_dataset_rowsConsulta linhas de um dataset com filtros, ordenação e paginacao baseada em cursor. Retorna linhas, total e metadados do schema.
slugstringSlug do dataset (identificador legivel)filtersobjectFiltros de consultaorder_bystringCampo para ordenaçãoorder_directionenumasc ou desccursorstringCursor para paginacaolimitnumberLimite de linhas (padrão: 50)upsert_dataset_rowsInsere ou atualiza linhas. Se 'id' existe: UPDATE. Se 'id' não encontrado: INSERT com aquele id. Se 'id' ausente: INSERT com UUID auto-gerado. Max 1000 linhas por chamada.
slugstringSlug do datasetrowsobject[]Array de objetos com os dados (max 1000)delete_dataset_rowsDeleta linhas de um dataset pelos seus UUIDs.
slugstringSlug do datasetrow_idsstring[]Array de UUIDs das linhas a deletarget_dataset_countConta linhas de um dataset, opcionalmente com filtros.
slugstringSlug do datasetfiltersobjectFiltros opcionaisImportação CSV
import_csv_to_datasetImporta um arquivo CSV local para um dataset existente. Le o arquivo do filesystem, faz parse e envia em batches. Use column_mapping para renomear headers do CSV para nomes de colunas do dataset.
dataset_slugstringSlug do dataset de destinofile_pathstringCaminho absoluto do arquivo CSVcolumn_mappingobjectMapa de renomeacao: { "header_csv": "coluna_dataset" }delimiterstringDelimitador (padrão: ",")skip_rowsnumberLinhas para pular no início (padrão: 0)batch_sizenumberTamanho do batch (padrão: 100)smart_import_csvLe um CSV local, infere schema (nomes e tipos de colunas), cria um novo dataset e importa todos os dados automaticamente. Use column_mapping para renomear colunas e column_types para sobrescrever tipos inferidos.
file_pathstringCaminho absoluto do arquivo CSVnamestringNome do dataset a ser criadodescriptionstringDescrição do datasetcolumn_mappingobjectMapa de renomeacao de colunascolumn_typesobjectOverride de tipos: { "coluna": "TEXT"|"INTEGER"|"DECIMAL"|"BOOLEAN"|"TIMESTAMP" }delimiterstringDelimitador (padrão: ",")skip_rowsnumberLinhas para pular (padrão: 0)batch_sizenumberTamanho do batch (padrão: 100)Exemplos de Uso com IA
Com o MCP server conectado, você pode fazer perguntas em linguagem natural:
O assistente de IA chama as tools certas, combina resultados e apresenta o dado de forma legível. O servidor MCP ensina à IA as regras de negócio (o que é venda aprovada, como medir antes de mapear) e as boas práticas de artefatos, Envios e experimentos.