Voltar ao início

Zyvo no Claude e no ChatGPT

Conector MCP do Zyvo · Documentação pública · Atualizada em 12 de outubro de 2026

O Zyvo é uma plataforma brasileira de marketing, CRM e atendimento com IA, operada pela CREDITUZ TECNOLOGIA LTDA (CNPJ 51.934.531/0001-92). O conector deixa o seu assistente de IA consultar o CRM, os projetos e os resultados da sua conta e criar rascunhos de conteúdo e campanhas, sempre com a sua aprovação.

1. Como conectar

  • Endereço do servidor: https://zyvo.marketing/api/mcp/app
  • No Claude: Configurações, Conectores, adicionar conector personalizado com o endereço acima. No ChatGPT: Configurações, Apps e conectores, criar, com o mesmo endereço.
  • O assistente abre o login do Zyvo. Entre com a sua conta, escolha a conta do Zyvo e o nível de acesso, e clique em permitir.
  • É preciso ter uma conta do Zyvo e ser administrador dela para autorizar a conexão.

2. Permissões

  • Somente leitura: o assistente consulta dados e não altera nada.
  • Leitura e criação: o assistente também cria rascunhos, leads, tarefas e páginas. Cada criação mostra antes uma prévia e só acontece depois que você aprova.
  • O acesso respeita o seu papel na conta. O conector não publica posts, não dispara campanhas, não gasta verba de anúncio e não gera imagens nem vídeos.
  • Para desconectar, abra Integrações no Zyvo, seção MCP, e revogue a conexão. O acesso termina na hora.

3. Ferramentas de leitura

FerramentaO que faz
zyvo_resumo_crm
Resumo do CRM
Total de leads, novos na semana e distribuição por etapa do funil. Sem funil, considera só os funis comerciais (funis operacionais, de tarefas e controles internos, ficam de fora); use finalidade todas para o CRM inteiro.
zyvo_listar_funis
Funis e classificação
Lista os funis com a finalidade (comercial, pós-venda ou operacional), a estratégia (Outbound LinkedIn, Outbound e-mail, Inbound site, Anúncios...), o produto e a fase padrão de cada etapa (entrada, contato, qualificação, reunião, proposta, ganho, perdido, nutrição). Funil operacional fica fora das métricas comerciais.
zyvo_relatorio_funis
Relatório de funis
Métricas de vários funis juntos pelas fases padrão e por cohort de entrada no funil: quantos entraram no período, quantos chegaram a contato, qualificação, reunião e proposta (percentual e tempo médio até a fase), ganhos e perdidos, recortados por estratégia, produto, funil, tag de produto do card (Credituz/Zyvo) e canal de abordagem (E-mail, WhatsApp, SMS, DM Instagram, DM LinkedIn; card com mais de um canal conta em cada um e em Multicanal). Sem filtro, só os funis comerciais. Somente leitura.
zyvo_crm_analytics
Painel analítico do CRM
Os números da aba CRM do Dashboard, sempre atualizados: indicadores do período comparados com o anterior, funil por fase, cohorts, movimento por fase, canais de abordagem, e-mail, gargalos de agora (cards parados e sem próxima ação), produto, funis, time por responsável, perdas e cidades. Período pela entrada no funil; sem filtro, funis comerciais dos últimos 90 dias. Somente leitura.
zyvo_buscar_contato
Buscar contato
Encontra um contato por nome, telefone, e-mail ou CNPJ e mostra dados, etiquetas, consentimentos e última atividade, e também as pessoas e empresas do CRM que batem.
zyvo_historico_etapas
Histórico e tempo por etapa
Métricas de um funil a partir das datas exatas gravadas pelo banco: quando cada card foi criado e entrou em cada etapa, quantos entraram em cada etapa no período, quantos ainda estão nela e o tempo médio e mediano por etapa. Com formato json devolve cada movimentação com data ISO para calcular conversão e ciclo. Somente leitura.
zyvo_ver_lead
Ver card do lead
Mostra o card de um lead: funil e etapa, data e hora de criação, desde quando está na etapa e todas as etapas percorridas com data e duração, qualificação, tags, valor, origem, próxima ação, histórico, últimas mensagens e o cliente (empresa, pessoa, outros negócios e linha do tempo).
zyvo_relatorio_empresas
Relatório por empresa
Receita ganha, taxa de ganho, ticket médio, ciclo de venda, valor em aberto, empresas que mais compraram, empresas esfriando e motivos de perda.
zyvo_ver_empresa
Ver empresa (cliente)
Ficha de uma empresa do CRM: CNPJ, cidade, pessoas e decisor, negócios com funil, etapa e valor, próxima ação e as últimas interações.
zyvo_linha_do_tempo
Linha do tempo do cliente
O que aconteceu com um cliente, do mais recente ao mais antigo: WhatsApp, e-mails, notas, mudanças de etapa e ações da IA, juntando todos os negócios da empresa.
zyvo_links_pesquisa
Links individuais da pesquisa
Quem recebeu uma pesquisa, com o status de cada pessoa e o link único de quem ainda não respondeu, pronto para mandar por WhatsApp. É o mesmo link que a pessoa recebeu por e-mail.
zyvo_agentes_followup
Agentes de Follow-up
Lista os Agentes de Follow-up (cadência de 8 toques por LinkedIn, Instagram, e-mail e WhatsApp) com status, canal, limite e quantos follow-ups estão para aprovar. Só time interno. O super admin pode ver a conta de alguém do time.
zyvo_fila_followup
Fila do Agente de Follow-up
Mostra os follow-ups da fila de um agente (lead, canal, toque, texto e status) para revisar antes de aprovar.
zyvo_follow_ups_hoje
Follow-ups de hoje
Leads com follow-up agendado para hoje ou atrasado.
zyvo_leads_parados
Leads parados
Leads sem movimentação há X dias, sem contar ganhos e perdidos.
zyvo_conversas_pendentes
Conversas esperando o time
Conversas que saíram do agente de IA e aguardam uma pessoa do time.
zyvo_tarefas
Tarefas do quadro
Lista e conta tarefas do quadro, com filtro por estado, responsável e lista.
zyvo_resumo_redes
Resumo das redes sociais
Desempenho das redes sociais e do conteúdo publicado em um período.
zyvo_listar_projetos
Projetos
Apresentações, propostas, e-books, sites, templates, carrosséis e ofertas da conta.
zyvo_minhas_apresentacoes
Apresentações
Apresentações criadas, com o link público de cada uma.
zyvo_quem_abriu_apresentacao
Quem abriu a apresentação
Quem abriu uma apresentação publicada e quando foi a última vez.
zyvo_status_pacote_campanha
Status do pacote de campanha
Andamento de cada peça de um pacote de campanha, com os links e o texto pronto da mensagem de WhatsApp.
zyvo_minhas_campanhas
Campanhas
Campanhas de todos os canais (e-mail, SMS, e-mail em ritmo, WhatsApp, Instagram e agendadas) com status e progresso.
zyvo_detalhe_campanha
Resultado de uma campanha
Totais de uma campanha (entregues, aberturas, cliques, bounces, respostas, teste A/B) e a situação de cada destinatário.
zyvo_visao_prospeccao
Visão de prospecção
WhatsApp, e-mail em ritmo, e-mail no total, cadências e público alcançável com consentimento.
zyvo_dominios_envio
Domínios de envio
Domínios de envio de e-mail da conta, status, remetente padrão e registros DNS que faltam.
zyvo_escrever_mensagem_campanha
Escrever mensagem de campanha
A IA escreve ou melhora o texto de uma campanha e devolve o rascunho. Não envia nada.
zyvo_empresa
Ficha da empresa
Ficha de uma empresa da base pública: cadastro, atividades, contato empresarial, situação no seu workspace e aderência ao seu ICP. Abrir a ficha não gasta contato.
zyvo_listas_prospeccao
Listas de prospecção
Listas de prospecção da Inteligência Comercial.
zyvo_sinais_oportunidades
Sinais e oportunidades
Sinais recentes de empresas (abertura, nova unidade, reativação, mudança de situação) com sugestão de abordagem.
zyvo_resumo_lead
Resumo do lead pela IA
Resumo curto de um card: em que pé está, o que o cliente quer ou objetou e o que saber antes do próximo contato. Usa o resumo guardado e só gera de novo quando há novidade (consome crédito de IA).
zyvo_comentarios_redes
Comentários nas redes
Últimos comentários nos posts das redes conectadas ao Inbox, com o post de cada um.
zyvo_sugerir_perguntas_pesquisa
Sugerir perguntas de pesquisa
A IA propõe perguntas para o que você quer descobrir com uma pesquisa. Não cria nada (consome crédito de IA).
zyvo_detalhar_carrossel
Detalhar carrossel
Mostra os textos de cada slide de um carrossel salvo com o caminho de cada campo (ex.: slides.8.cta.premio), para editar com zyvo_editar_carrossel.
zyvo_criativos_biblioteca
Biblioteca de criativos
Lista os criativos (imagens e vídeos) da biblioteca de anúncios da conta, com id, formato e link.
zyvo_status_lote_ads
Andamento de um lote de anúncios
Andamento de um lote de anúncios do estúdio (prontas, em produção, falhas) e as melhores peças, com código, ângulo, formato, headline e link da imagem. Sem lote, mostra o mais recente.
zyvo_nota_criativo
Nota de um criativo
Nota de 0 a 100 de um criativo do estúdio de anúncios, metade pela copy e metade pela imagem, com o que melhorar. Refazer a avaliação consome crédito de IA.
zyvo_referencias_concorrentes
Referências de concorrentes
Anúncios de concorrentes já analisados (gancho, ângulo, oferta) e os ângulos que nenhum deles usa.
zyvo_resultado_criativos
Resultado por criativo
Resultado de cada criativo do estúdio que foi para a conta de anúncios: verba, impressões, cliques e taxa de clique da plataforma, e do CRM os leads, qualificados, vendas e valor pelo código de rastreio. Aponta o vencedor e os criativos cansados.
zyvo_status_job_midia
Andamento de vídeo em produção
Andamento de um vídeo pedido com zyvo_gerar_video_anuncio (ou dos últimos). Quando fica pronto, já o guarda na biblioteca e devolve o link.

4. Ferramentas de criação

Na primeira chamada a ferramenta devolve a prévia e um preview_id. A criação só acontece numa segunda chamada, com confirmar: true e esse preview_id, depois da sua aprovação.

FerramentaO que faz
zyvo_enviar_pesquisa
Enviar pesquisa por e-mail ou WhatsApp
Envia uma pesquisa para um funil do CRM, por e-mail ou pelo WhatsApp conectado. Cada pessoa recebe o link único dela; quem já recebeu pelo outro canal recebe o mesmo link. Mostra a prévia antes de enviar.
zyvo_criar_lead
Criar lead no CRM
Cria um card no CRM, no funil e na etapa indicados, com os dados do contato: empresa, cargo, cidade, perfis nas redes (LinkedIn, Instagram, site…) e responsável. Para uma lista inteira use zyvo_importar_leads.
zyvo_importar_leads
Importar lista de leads no CRM
Importa uma lista de leads (até 500) para um funil do CRM numa chamada só, sem repetir quem já está nele (mesmo e-mail, telefone ou perfil). Cada linha precisa de telefone, e-mail ou um perfil (uma lista do LinkedIn entra só com o link). Tags e responsável valem para o lote. Mostra a prévia antes.
zyvo_classificar_funil
Classificar funil
Define a finalidade de um funil (comercial entra nas métricas, pós-venda tem métrica própria, operacional fica de fora), a estratégia e o produto. Mostra uma prévia antes.
zyvo_mover_lead
Mover lead de etapa
Move um card do CRM para outra etapa do funil.
zyvo_anotar_lead
Anotar no lead
Registra uma nota na timeline de um lead.
zyvo_criar_agente_followup
Criar Agente de Follow-up
Cria um Agente de Follow-up num funil: ele lê a Próxima ação e a nota de cadência de cada card, escreve o próximo toque e monta a fila diária para aprovar. Só time interno. O super admin pode criar na conta de alguém do time.
zyvo_montar_fila_followup
Montar fila do Agente de Follow-up
Lê agora os cards com Próxima ação vencida e coloca os follow-ups na fila do agente. No modo revisar nada é enviado.
zyvo_criar_tarefa
Criar tarefa
Cria uma tarefa no quadro da conta.
zyvo_criar_apresentacao
Criar apresentação ou proposta
Gera com IA uma apresentação ou proposta comercial como RASCUNHO, com link de prévia (computador e celular). Fica pronta em 2 a 5 minutos. Depois mostre com zyvo_ver_previa e só publique com zyvo_publicar_apresentacao quando o usuário aprovar.
zyvo_criar_landing_page
Criar landing page
Gera com IA uma landing page ou site como RASCUNHO, com link de prévia. Mostre com zyvo_ver_previa e só publique com zyvo_publicar_apresentacao quando o usuário aprovar.
zyvo_criar_carrossel
Criar carrossel
Escreve um carrossel editorial para o Instagram, com a legenda, e salva em Publicar > Rascunhos, pronto para aprovar e agendar. Não publica.
zyvo_editar_carrossel
Editar carrossel
Edita um carrossel salvo (também os de Publicar > Rascunhos) sem recriar: troca textos, legenda, tema visual e @. Use zyvo_detalhar_carrossel para ver os caminhos dos campos e zyvo_visualizar_carrossel para mostrar o resultado. Não publica.
zyvo_aprovar_carrossel
Aprovar carrossel
Depois que o usuário viu a prévia (zyvo_visualizar_carrossel) e confirmou no chat, marca o carrossel como Aprovado em Publicar > Rascunhos. Não publica nem agenda: o dia e o horário são escolhidos no Zyvo.
zyvo_criar_template_email
Criar template de e-mail
Cria um template visual de e-mail a partir do objetivo da campanha. Não envia nada.
zyvo_criar_pacote_campanha
Criar pacote de campanha
A partir de um brief, cria de uma vez apresentação, landing page, carrossel, template de e-mail e mensagem de WhatsApp coerentes entre si. Nada é postado, agendado nem disparado: apresentação e landing page nascem como RASCUNHO com link de prévia (mostre com zyvo_ver_previa e publique com zyvo_publicar_apresentacao quando o usuário aprovar). Fica pronto em 2 a 5 minutos; acompanhe em zyvo_status_pacote_campanha.
zyvo_importar_apresentacao
Importar apresentação
Importa para o Zyvo um deck em HTML criado fora dele, como RASCUNHO com link de prévia. O HTML é sanitizado e cada <section> vira um slide com métricas. Mostre com zyvo_ver_previa e publique com zyvo_publicar_apresentacao quando o usuário aprovar.
zyvo_publicar_apresentacao
Publicar apresentação, proposta ou site
Publica um rascunho (apresentação, proposta ou landing page) criado ou importado pelo Zyvo: o link passa a abrir para qualquer pessoa, com métricas de leitura. Use só depois que o usuário viu a prévia (zyvo_ver_previa) e aprovou.
zyvo_importar_midia
Importar imagem ou vídeo
Guarda na biblioteca de criativos do Zyvo uma imagem (até 16 MB) ou um vídeo (até 48 MB) a partir de uma URL https pública.
zyvo_importar_carrossel
Importar carrossel
Monta um rascunho de carrossel ou story com imagens prontas e coloca nos rascunhos de Publicar. Não publica.
zyvo_pausar_campanha
Pausar campanha
Pausa uma campanha em envio (e-mail em ritmo, WhatsApp ou Instagram). Dá para retomar depois.
zyvo_retomar_campanha
Retomar campanha
Retoma uma campanha pausada. A prévia mostra quantos ainda estão na fila e avisa quando a pausa veio do freio de bounce.
zyvo_salvar_busca
Salvar busca de empresas
Salva um recorte de busca de empresas para rodar de novo depois (guarda os filtros, não o resultado).
zyvo_criar_icp
Criar perfil de cliente ideal
Cria um ICP (perfil de cliente ideal) que pontua as empresas por aderência.
zyvo_marcar_empresa
Marcar empresa
Marca uma empresa no seu workspace: favorita, status, etiquetas, nota e responsável. Não muda a base pública.
zyvo_editar_lead
Editar dados do lead
Corrige ou completa os dados de um card do CRM (nome, e-mail, telefone, Instagram, valor, campos como CNPJ e cargo, motivo de perda) e a próxima ação do card (data e o que fazer, ou remover). Não troca etapa nem funil: para etapa use zyvo_mover_lead.
zyvo_copiar_leads_funil
Copiar leads para outro funil
Copia cards para outro funil sem tirar do original. Quem já está no destino (mesmo e-mail ou telefone) não duplica.
zyvo_anotar_conversa
Nota interna na conversa
Escreve uma nota interna numa conversa do Inbox. O cliente não vê. Use @nome para mencionar alguém do time.
zyvo_organizar_conversa
Organizar conversa
Etiqueta, favorita ou adia uma conversa do Inbox. Não manda nada para o cliente.
zyvo_editar_pesquisa
Editar pesquisa
Muda o nome ou as perguntas de uma pesquisa que ainda não tem respostas. Com respostas, use zyvo_duplicar_pesquisa.
zyvo_duplicar_pesquisa
Duplicar pesquisa
Faz uma cópia de uma pesquisa, já com as mudanças pedidas. É o caminho para mudar uma pesquisa que já tem respostas.
zyvo_encerrar_pesquisa
Encerrar ou reabrir pesquisa
Encerra uma pesquisa (o link para de aceitar respostas) ou reabre.
zyvo_link_individual
Link individual de apresentação
Gera o link de uma apresentação ou proposta só para uma pessoa, para saber quando ela abriu (aparece em zyvo_quem_abriu_apresentacao).
zyvo_prazo_link
Prazo do link público
Define até quando o link público de uma apresentação, proposta ou página vale (depois sai do ar sozinho) ou tira o prazo.
zyvo_gerar_imagem_anuncio
Gerar imagem de anúncio com IA
Gera uma foto publicitária com IA e salva na biblioteca de criativos, pronta para Meta, Google e TikTok. Cada variação conta uma imagem da cota mensal do plano; a prévia mostra o custo. Não publica nem anuncia. Panfleto, flyer ou tabela de preços não é aqui.
zyvo_editar_imagem_anuncio
Editar criativo com IA
Refaz um criativo que já está na biblioteca seguindo uma instrução (trocar fundo, cor, elemento, cena ou formato). Gera uma imagem nova e mantém a original. Conta na cota de imagens. Não publica nem anuncia.
zyvo_gerar_video_anuncio
Gerar vídeo de anúncio com IA
Gera um vídeo de anúncio (4, 6 ou 8 s, ou longo de 16, 24 ou 32 s, com áudio) a partir de uma descrição ou animando um criativo da biblioteca, com narração opcional por voz da ElevenLabs. O longo sai em partes de 8 s que continuam a mesma cena e chega já editado num arquivo só (no UGC a fala é dividida entre as partes). Até 8 s leva de 1 a 3 minutos; o longo, de 2 a 4 minutos por parte: devolve um job_id para acompanhar em zyvo_status_job_midia. Conta na cota mensal de vídeos do plano (o longo conta uma parte a cada 8 s). Não publica nem anuncia.
zyvo_criar_lote_ads
Criar lote de anúncios por ângulo
Cria um lote de criativos para teste A/B: para cada ângulo a IA escreve conceitos com gancho, headline, texto e CTA, gera uma imagem por conceito em cada formato, dá nota a cada peça e grava um código de rastreio (o CRM sabe qual anúncio trouxe cada lead). Roda em segundo plano (2 a 6 min); acompanhe em zyvo_status_lote_ads. Conta na cota de imagens (e de vídeos, se pedir). Nada vai para a conta de anúncios.
zyvo_mais_como_este
Novo lote a partir de um vencedor
Cria um novo lote a partir de um criativo (normalmente o vencedor em zyvo_resultado_criativos): mesmo ângulo e promessa, com ganchos e cenas novos, usando a imagem dele como referência. Conta na cota de imagens.
zyvo_video_do_criativo
Transformar criativo em vídeo
Gera um Reels 9:16 de 6 s animando uma imagem pronta do estúdio, com a mesma copy e um código de rastreio próprio. A partir do plano Pro; conta na cota de vídeos.
zyvo_editar_copy_criativo
Editar copy de um criativo
Ajusta gancho, headline, texto, descrição ou CTA de um criativo do estúdio e refaz a nota.
zyvo_referencia_concorrente
Analisar anúncio de concorrente
Guarda e analisa um anúncio de concorrente (texto colado, link público ou print) para o estúdio usar como contraste nos próximos lotes, nunca como cópia: extrai gancho, ângulo, oferta, formato e CTA. Consome crédito de IA.

5. Exemplos de pedidos

  • Quais leads estão parados há mais de 10 dias no funil de vendas?
  • Quem abriu a proposta que mandei para a Acme e quando?
  • Crie uma campanha completa de lançamento do plano anual para pequenas clínicas, com apresentação, landing page, carrossel, e-mail e mensagem de WhatsApp.
  • Coloque a Maria Souza, da Padaria Central, no CRM na etapa Qualificado e anote que ela pediu orçamento.
  • Publique no Zyvo este deck que você acabou de criar, para eu acompanhar quem leu.

6. Dados e privacidade

O Zyvo recebe do assistente apenas o nome da ferramenta e os argumentos de cada chamada, e devolve o resultado dela. Cada ação fica registrada no histórico da conta. Detalhes na seção 11.1 da Política de Privacidade e nos Termos de Uso.

7. Suporte

Dúvidas ou problemas com o conector: suporte@zyvo.marketing. Privacidade: contato@zyvo.marketing.

8. Para desenvolvedores

  • Transporte: Streamable HTTP (POST JSON-RPC). Versões do protocolo: 2024-11-05 a 2025-11-25.
  • Autorização: OAuth 2.1 com PKCE S256 e registro dinâmico de cliente. Metadados em /.well-known/oauth-authorization-server e /.well-known/oauth-protected-resource/api/mcp/app. Escopos: leitura e escrita.
  • Neste endereço o token só é aceito no cabeçalho Authorization: Bearer.