Assistentes de IA

Use a Zipe dentro do seu assistente de IA

Conecte o Claude, o ChatGPT ou outro cliente de IA aos seus workspaces, com as permissões que você escolher e um workspace por vez.

Endereço do servidor

https://mcp.zipe.app/mcp

Antes de conectar

  • O acesso de agentes de IA nasce desligado em cada workspace. Um owner ou admin liga em Configurações › Agentes de IA.
  • Para conectar, você precisa ser member, admin ou owner em pelo menos um workspace.
  • Uma conexão alcança todos os seus workspaces, inclusive os que vierem depois. Onde você é viewer, o assistente só lê.
  • Cada ferramenta age num workspace só, escolhido pelo nome em cada pedido.

Como conectar

Claude

Free, Pro ou Max

Quem faz: Você mesmo adiciona o conector.

  1. Abra Customize › Connectors em claude.ai/customize/connectors.
  2. Clique em Adicionar conector personalizado e dê o nome Zipe.
  3. Cole o endereço https://mcp.zipe.app/mcp.
  4. Na escolha do cliente OAuth, deixe Use Claude's published identity.
  5. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

No plano Free, o Claude aceita um único conector personalizado.

Team ou Enterprise

Quem faz: Só o Owner da organização no Claude adiciona o conector; cada membro depois só clica em Connect.

  1. O Owner abre Organization settings › Connectors e adiciona um conector personalizado chamado Zipe.
  2. Cole o endereço https://mcp.zipe.app/mcp.
  3. Cada membro abre Customize › Connectors, encontra a Zipe e clica em Connect.
  4. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

Um membro não consegue adicionar o conector sozinho nesses planos.

Claude Code

Terminal

Quem faz: Você mesmo, no seu computador.

claude mcp add --transport http zipe https://mcp.zipe.app/mcp
  1. Rode o comando acima no terminal.
  2. Dentro do Claude Code, digite /mcp, escolha zipe e autorize no navegador.
  3. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

O Claude Code não pede permissão nova no meio de uma chamada. Para já autorizar o que você vai usar, veja o bloco Para desenvolvedores.

Para desenvolvedores

Para o Claude Code já pedir na primeira autorização as permissões que você quer, adicione a Zipe com oauth.scopes. A linha abaixo pede Ler o workspace, Ler Conversas, Responder em Conversas, Ler Social Listening, Operar Social Listening, Criar e publicar conteúdo, Gerenciar automações, Ajustar o Brain, Gerenciar concorrentes e Minhas preferências. Recursos pagos e Administração ficam de fora; acrescente se precisar.

claude mcp add-json zipe '{"type":"http","url":"https://mcp.zipe.app/mcp","oauth":{"scopes":"zipe:read zipe:conversations:read zipe:conversations:write zipe:listening:read zipe:listening:write zipe:content:write zipe:automations:write zipe:brain:write zipe:insights:write zipe:self:write"}}'

Se uma ferramenta pedir uma permissão que não está na lista, acrescente-a em oauth.scopes e autorize de novo em /mcp.

ChatGPT

Plus ou Pro (web)

Quem faz: Você mesmo cria o plugin.

  1. Abra chatgpt.com/plugins, clique em + e escolha Add custom MCP server.
  2. Dê o nome Zipe.
  3. Cole o endereço https://mcp.zipe.app/mcp.
  4. Em Authentication, escolha OAuth.
  5. Aceite o aviso de risco e escolha Create as a plugin.
  6. Abra o plugin e instale com +.
  7. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.
  8. Numa conversa da aba Work, chame a Zipe com @Zipe.

Business, Enterprise ou Edu

Quem faz: Só um admin ou owner do workspace no ChatGPT cria e publica; o controle de acesso desse workspace decide quem usa.

  1. O admin abre chatgpt.com/plugins, clica em + e escolhe Add custom MCP server.
  2. Cole o endereço https://mcp.zipe.app/mcp.
  3. O admin escolhe OAuth em Authentication, aceita o aviso de risco e escolhe Create as a plugin.
  4. O admin publica o plugin para as pessoas ou grupos que vão usar, e cada pessoa instala com +.
  5. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

Em workspace Business ou Enterprise, a política do administrador do ChatGPT pode bloquear servidores MCP personalizados.

Se o admin do ChatGPT deixar as escritas do app desligadas, só as leituras da Zipe aparecem. Para liberar convites, pedidos e as outras escritas, o admin abre Workspace settings › Apps › Manage actions e habilita as ações da Zipe.

O Company Knowledge do ChatGPT só consulta: nenhuma escrita da Zipe roda por ele. Para convidar, mudar configurações ou criar um pedido, chame a Zipe numa conversa.

VS Code

Terminal

Quem faz: Você mesmo, no seu computador.

code --add-mcp '{"name":"zipe","type":"http","url":"https://mcp.zipe.app/mcp"}'
  1. Rode o comando acima no terminal.
  2. No VS Code, inicie o servidor zipe e autorize no navegador quando ele pedir.
  3. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

Codex

Terminal

Quem faz: Você mesmo, no seu computador.

codex mcp add zipe --url https://mcp.zipe.app/mcp
codex mcp login zipe
  1. Rode os dois comandos acima, um depois do outro.
  2. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

Sem o login, o Codex conecta sem autenticação e a Zipe recusa. Depois de revogar a conexão, rode o login de novo.

A autorização volta para o seu próprio computador. Um endereço de retorno remoto, como o de um ambiente na nuvem, não é aceito.

Antigravity

Terminal

Quem faz: Você mesmo, no seu computador.

agy mcp add zipe https://mcp.zipe.app/mcp
  1. Rode o comando acima no terminal.
  2. Autorize no navegador quando o Antigravity pedir.
  3. Entre na Zipe em app.zipe.app, confira o nome do cliente e marque as permissões que quiser.

Experimente pedir

Cite sempre o workspace pelo nome. O assistente escolhe as ferramentas sozinho.

  • Liste meus workspaces na Zipe e diga qual é o meu papel na Padaria Lumen.
  • Na Padaria Lumen, resuma como foram alcance e engajamento das contas conectadas nos últimos 30 dias.
  • Quais foram os 5 posts com mais engajamento da Padaria Lumen neste mês, e o que eles têm em comum?
  • O que está agendado no calendário da Padaria Lumen para a próxima semana?
  • Crie um rascunho de post para o Instagram da Padaria Lumen sobre o pão de fermentação natural, no tom da marca.
  • Na Padaria Lumen, quais concorrentes acompanhados mais cresceram em seguidores neste mês?
  • Mostre os comentários sem resposta da Padaria Lumen desta semana, agrupados por assunto.

O que o assistente faz

99 ferramentas em 11 módulos: 43 ferramentas de leitura, 5 ferramentas de leitura com recursos pagos, 20 ferramentas de escrita direta e 31 ferramentas que pedem aprovação no app.

Analytics

  • Visão geral do workspace

    Leitura

    Resume o workspace: contas conectadas, seguidores, alcance e engajamento recentes.

    Permissão: Ler o workspace

  • Listar posts

    Leitura

    Lista os posts das contas conectadas, com filtro por rede, período e formato e as métricas de cada um.

    Permissão: Ler o workspace

  • Ver um post

    Leitura

    Abre um post com a legenda, as métricas e a evolução delas dia a dia.

    Permissão: Ler o workspace

  • Série diária de uma conta

    Leitura

    Traz a série diária de uma conta conectada: seguidores, alcance e engajamento.

    Permissão: Ler o workspace

  • Ver o público

    Leitura

    Mostra o público de uma conta conectada: idade, gênero e localização, quando a rede informa.

    Permissão: Ler o workspace

  • Buscar no workspace

    Leitura

    Busca por texto num workspace: posts, ideias, fatos do Brain e outros itens que você pode ler.

    Permissão: Ler o workspace

  • Abrir um item

    Leitura

    Abre um item encontrado pela busca, com o conteúdo completo.

    Permissão: Ler o workspace

  • Saúde das contas

    Leitura

    Mostra a saúde das contas conectadas: conexão, sincronização e o que precisa de atenção.

    Permissão: Ler o workspace

  • Resultado de leitura de mídia

    Leitura

    Traz o resultado de uma leitura de imagem, vídeo ou transcrição já pedida.

    Permissão: Ler o workspace

  • Ler imagem ou vídeo

    LeituraRecursos pagos

    Lê a imagem ou o vídeo de um post e descreve o gancho, as cenas e o tom.

    Permissão: Ler o workspace, Recursos pagos

  • Transcrever vídeo

    LeituraRecursos pagos

    Transcreve a fala de um vídeo de uma conta conectada ou de um concorrente monitorado.

    Permissão: Ler o workspace, Recursos pagos

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • get_workspace_overview Visão geral do workspace
  • list_posts Listar posts
  • get_post Ver um post
  • get_account_series Série diária de uma conta
  • get_audience Ver o público
  • search Buscar no workspace
  • fetch Abrir um item
  • get_account_health Saúde das contas
  • get_media_result Resultado de leitura de mídia
  • read_media Ler imagem ou vídeo
  • transcribe_video Transcrever vídeo
Calendário e Ideias

  • Ver o calendário

    Leitura

    Mostra o Calendário: posts em rascunho, agendados, publicados e com falha, por período.

    Permissão: Ler o workspace

  • Listar ideias

    Leitura

    Lista as ideias do quadro de Ideias, com coluna, etiquetas e responsáveis.

    Permissão: Ler o workspace

  • Revisar texto

    Leitura

    Confere um texto contra as regras de publicação de cada rede, como o limite de caracteres e de hashtags, antes de agendar.

    Permissão: Ler o workspace

  • Criar rascunho de post

    Direto

    Cria um rascunho de post no Calendário, com texto, mídia e contas de destino.

    Permissão: Criar e publicar conteúdo

  • Editar rascunho de post

    Direto

    Edita um rascunho de post que ainda não foi agendado.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

  • Cancelar agendamento

    Direto

    Cancela o agendamento de um post, que volta a ser rascunho.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

  • Agendar publicação

    Pede aprovação no app

    Pede para agendar um post numa data e hora; alguém do workspace aprova no app.

    Permissão: Criar e publicar conteúdo

  • Tentar publicar de novo

    Pede aprovação no app

    Pede para tentar de novo um post que falhou ao publicar.

    Permissão: Criar e publicar conteúdo

  • Editar post publicado

    Pede aprovação no app

    Pede para editar a legenda de um post já publicado, quando a rede permite.

    Permissão: Criar e publicar conteúdo

  • Excluir post

    Pede para excluir um post do Calendário; se já foi publicado, também da rede social.

    Permissão: Criar e publicar conteúdo

    • rascunhoPede aprovação no app
    • publicadoPede aprovação no app

  • Criar ideia

    Direto

    Cria uma ideia no quadro de Ideias.

    Permissão: Criar e publicar conteúdo

  • Editar ideia

    Direto

    Edita o título, o texto, as etiquetas ou os responsáveis de uma ideia.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

  • Mover ideias

    Direto

    Move ideias entre as colunas do quadro.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

  • Gerenciar etiquetas de ideias

    Cria e renomeia etiquetas de ideias; excluir uma etiqueta pede aprovação.

    Permissão: Criar e publicar conteúdo

    • criarDiretoSeu cliente de IA pode pedir confirmação antes.
    • renomearDiretoSeu cliente de IA pode pedir confirmação antes.
    • excluirPede aprovação no app

  • Editar propriedades do quadro de ideias

    Pede aprovação no app

    Pede para mudar as propriedades do quadro de Ideias, como colunas e campos.

    Permissão: Criar e publicar conteúdo

  • Comentar ideia

    Direto

    Comenta numa ideia, em seu nome.

    Permissão: Criar e publicar conteúdo

  • Criar post a partir de ideia

    Direto

    Transforma uma ideia num rascunho de post no Calendário.

    Permissão: Criar e publicar conteúdo

  • Criar link de aprovação

    Pede aprovação no app

    Pede para gerar um link de aprovação de ideias para alguém de fora da Zipe.

    Permissão: Criar e publicar conteúdo

  • Revogar link de aprovação

    Direto

    Revoga um link de aprovação de ideias que ainda está aberto.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

  • Excluir ideias

    Pede aprovação no app

    Pede para excluir ideias do quadro.

    Permissão: Criar e publicar conteúdo

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • get_content_calendar Ver o calendário
  • list_content_ideas Listar ideias
  • check_copy Revisar texto
  • create_content_draft Criar rascunho de post
  • update_content_draft Editar rascunho de post
  • cancel_publication Cancelar agendamento
  • schedule_publication Agendar publicação
  • retry_publication Tentar publicar de novo
  • edit_published_publication Editar post publicado
  • delete_content Excluir post
  • create_idea Criar ideia
  • update_idea Editar ideia
  • move_ideas Mover ideias
  • manage_idea_tags Gerenciar etiquetas de ideias
  • update_idea_board_properties Editar propriedades do quadro de ideias
  • comment_on_idea Comentar ideia
  • create_post_from_idea Criar post a partir de ideia
  • create_idea_approval_link Criar link de aprovação
  • revoke_idea_approval_link Revogar link de aprovação
  • delete_ideas Excluir ideias
Conversas

  • Listar conversas

    Leitura

    Lista as conversas de mensagem direta das contas conectadas, com filtro por conta e por não lidas.

    Permissão: Ler Conversas

  • Ler conversa

    Leitura

    Lê as mensagens de uma conversa.

    Permissão: Ler Conversas

  • Números das conversas

    Leitura

    Mostra números das conversas: volume, não lidas e tempo de resposta por período.

    Permissão: Ler Conversas

  • Listar comentários

    Leitura

    Lista os comentários recebidos nos posts e anúncios das contas conectadas.

    Permissão: Ler Conversas

  • Ler fio de comentários

    Leitura

    Lê um comentário com as respostas dele.

    Permissão: Ler Conversas

  • Listar menções

    Leitura

    Lista as menções e marcações das contas conectadas.

    Permissão: Ler Conversas

  • Listar avaliações

    Leitura

    Lista as avaliações recebidas pelas páginas e locais conectados.

    Permissão: Ler Conversas

  • Marcar conversa como lida

    Direto

    Marca uma conversa como lida na Zipe.

    Permissão: Responder em Conversas

    Seu cliente de IA pode pedir confirmação antes.

  • Responder mensagem

    Pede aprovação no app

    Pede para responder uma conversa, um comentário, uma avaliação ou uma menção; alguém do workspace aprova antes do envio.

    Permissão: Responder em Conversas

  • Responder comentário por mensagem

    Pede aprovação no app

    Pede para responder um comentário por mensagem direta a quem comentou.

    Permissão: Responder em Conversas

  • Ocultar comentário

    Direto

    Oculta um comentário na hora, sem excluí-lo.

    Permissão: Responder em Conversas

    Seu cliente de IA pode pedir confirmação antes.

  • Moderar comentário

    Pede aprovação no app

    Pede para mostrar de novo, curtir, descurtir ou excluir um comentário.

    Permissão: Responder em Conversas

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • list_conversations Listar conversas
  • read_conversation Ler conversa
  • get_conversation_stats Números das conversas
  • list_comments Listar comentários
  • read_comment_thread Ler fio de comentários
  • list_mentions Listar menções
  • list_reviews Listar avaliações
  • mark_conversation_read Marcar conversa como lida
  • send_reply Responder mensagem
  • private_reply_to_comment Responder comentário por mensagem
  • hide_comment Ocultar comentário
  • moderate_comment Moderar comentário
Insights

  • Painel de concorrentes

    Leitura

    Mostra o painel de concorrentes monitorados: seguidores, frequência, engajamento e formatos.

    Permissão: Ler o workspace

  • Listar conteúdo de concorrentes

    Leitura

    Lista posts dos concorrentes monitorados, com filtro por conta, período e formato.

    Permissão: Ler o workspace

  • Analisar hashtags

    Leitura

    Analisa as hashtags usadas nos posts das contas conectadas e dos concorrentes monitorados.

    Permissão: Ler o workspace

  • Consultar perfil público

    LeituraRecursos pagos

    Consulta um perfil público pelo @, com seguidores e posts recentes, sem passar a monitorá-lo.

    Permissão: Ler o workspace, Recursos pagos

  • Ler comentários de concorrente

    LeituraRecursos pagos

    Lê os comentários de um post de concorrente monitorado, sem guardar nem acompanhar depois.

    Permissão: Ler o workspace, Recursos pagos, Ler Conversas

  • Buscar posts por hashtag

    LeituraRecursos pagos

    Busca posts públicos recentes de uma hashtag fora dos perfis monitorados.

    Permissão: Ler o workspace, Recursos pagos

  • Monitorar conta

    Pede aprovação no appRecursos pagos

    Pede para monitorar uma conta em Insights, o que ocupa um lugar no limite de concorrentes do workspace.

    Permissão: Gerenciar concorrentes, Recursos pagos

  • Parar de monitorar conta

    Pede aprovação no app

    Pede para parar de monitorar uma conta em Insights.

    Permissão: Gerenciar concorrentes

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • get_competitor_panel Painel de concorrentes
  • list_competitor_content Listar conteúdo de concorrentes
  • analyze_hashtags Analisar hashtags
  • look_up_social_account Consultar perfil público
  • read_competitor_comments Ler comentários de concorrente
  • discover_hashtag_posts Buscar posts por hashtag
  • add_watched_account Monitorar conta
  • remove_watched_account Parar de monitorar conta
Brain

  • Buscar no Brain

    Leitura

    Busca no Brain fatos sobre a identidade, a voz e a linha editorial da marca, com a evidência de cada um.

    Permissão: Ler o workspace

  • Ver o contexto da marca

    Leitura

    Traz o resumo da marca que o Brain mantém: quem ela é, como fala e sobre o que publica.

    Permissão: Ler o workspace

  • Ler uma fonte do Brain

    Leitura

    Lê uma fonte que o Brain usou, como uma página do site ou a transcrição de um vídeo da marca.

    Permissão: Ler o workspace

  • Registrar fato no Brain

    Confirma ou corrige um fato do Brain; declarar um fato novo pede aprovação.

    Permissão: Ajustar o Brain

    • confirmarDiretoSeu cliente de IA pode pedir confirmação antes.
    • corrigirDiretoSeu cliente de IA pode pedir confirmação antes.
    • declarar fato novoPede aprovação no app

  • Revisar estratégia

    Pede aprovação no app

    Pede para revisar a estratégia de conteúdo da marca guardada no Brain.

    Permissão: Ajustar o Brain

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • search_brain Buscar no Brain
  • get_brand_context Ver o contexto da marca
  • read_brain_source_document Ler uma fonte do Brain
  • record_brain_fact Registrar fato no Brain
  • revise_strategy Revisar estratégia
Automações

  • Listar automações

    Leitura

    Lista as automações do workspace, com a conta, o gatilho e se estão ativas.

    Permissão: Ler o workspace

  • Ver uma automação

    Leitura

    Abre uma automação com o gatilho, as palavras e as mensagens que ela envia.

    Permissão: Ler o workspace

  • Desempenho de uma automação

    Leitura

    Mostra quantas mensagens uma automação enviou e quantas pessoas ela alcançou por período.

    Permissão: Ler o workspace

  • Listar modelos de mensagem

    Leitura

    Lista os modelos de mensagem salvos no workspace.

    Permissão: Ler o workspace

  • Criar automação

    Direto

    Cria uma automação de resposta a comentários, que nasce pausada.

    Permissão: Gerenciar automações

  • Editar automação

    Edita uma automação; se ela estiver ativa, a mudança pede aprovação.

    Permissão: Gerenciar automações

    • automação pausadaDiretoSeu cliente de IA pode pedir confirmação antes.
    • automação ativaPede aprovação no app

  • Ativar ou pausar automação

    Pausa uma automação na hora; ativar pede aprovação.

    Permissão: Gerenciar automações

    • ativarPede aprovação no app
    • pausarDiretoSeu cliente de IA pode pedir confirmação antes.

  • Excluir automação

    Pede aprovação no app

    Pede para excluir uma automação.

    Permissão: Gerenciar automações

  • Gerenciar modelo de mensagem

    Direto

    Cria, edita ou exclui modelos de mensagem do workspace.

    Permissão: Criar e publicar conteúdo

    Seu cliente de IA pode pedir confirmação antes.

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • list_automations Listar automações
  • get_automation Ver uma automação
  • get_automation_performance Desempenho de uma automação
  • list_message_templates Listar modelos de mensagem
  • create_automation Criar automação
  • update_automation Editar automação
  • set_automation_active Ativar ou pausar automação
  • delete_automation Excluir automação
  • manage_message_template Gerenciar modelo de mensagem
Social Listening

  • Listar consultas do Listening

    Leitura

    Lista as consultas do Social Listening e o estado de cada uma.

    Permissão: Ler Social Listening

  • Ver consulta do Listening

    Leitura

    Abre uma consulta do Social Listening com termos, redes e uso do mês.

    Permissão: Ler Social Listening

  • Buscar menções do Listening

    Leitura

    Busca menções coletadas por uma consulta, com filtro por rede, sentimento, tema e período.

    Permissão: Ler Social Listening

  • Ver menção do Listening

    Leitura

    Abre uma menção com o texto, o autor, o engajamento e a leitura de sentimento.

    Permissão: Ler Social Listening

  • Resumo do Listening

    Leitura

    Resume uma consulta: volume por dia, sentimento, temas e picos.

    Permissão: Ler Social Listening

  • Listar menções salvas

    Leitura

    Lista as menções salvas de uma consulta.

    Permissão: Ler Social Listening

  • Criar consulta do Listening

    Direto

    Cria uma consulta do Social Listening em rascunho, que só coleta depois de aprovada no app.

    Permissão: Operar Social Listening

  • Editar consulta do Listening

    Edita uma consulta; em rascunho é direto, coletando pede aprovação.

    Permissão: Operar Social Listening

    • consulta em rascunhoDiretoSeu cliente de IA pode pedir confirmação antes.
    • consulta coletandoPede aprovação no app

  • Decidir sugestão do Listening

    Aceita ou recusa uma sugestão de configuração de uma consulta.

    Permissão: Operar Social Listening

    • consulta em rascunhoDiretoSeu cliente de IA pode pedir confirmação antes.
    • consulta coletandoPede aprovação no app

  • Pausar consulta do Listening

    Direto

    Pausa a coleta de uma consulta.

    Permissão: Operar Social Listening

    Seu cliente de IA pode pedir confirmação antes.

  • Escolher quem recebe alertas do Listening

    Direto

    Escolhe quem do workspace recebe os alertas e o resumo de uma consulta.

    Permissão: Operar Social Listening

    Seu cliente de IA pode pedir confirmação antes.

  • Gerenciar menções salvas

    Direto

    Salva ou tira menções da lista de salvas.

    Permissão: Operar Social Listening

    Seu cliente de IA pode pedir confirmação antes.

  • Gerenciar comunidade do Listening

    Cria ou edita uma comunidade, um recorte de uma consulta descrito em linguagem natural.

    Permissão: Operar Social Listening

    • consulta em rascunhoDiretoSeu cliente de IA pode pedir confirmação antes.
    • consulta coletandoPede aprovação no app

  • Pedir amostra do Listening

    Pede aprovação no appRecursos pagos

    Pede uma amostra de menções para conferir a configuração de uma consulta.

    Permissão: Operar Social Listening, Recursos pagos

  • Buscar lugares para avaliações do Google

    Pede aprovação no appRecursos pagos

    Pede uma busca de lugares para acompanhar as avaliações deles numa consulta.

    Permissão: Operar Social Listening, Recursos pagos

  • Pedir ativação da consulta do Listening

    Recursos pagos

    Pede para começar ou retomar a coleta de uma consulta.

    Permissão: Operar Social Listening, Recursos pagos

    • começar a coletaPede aprovação no appRecursos pagos
    • retomar a coletaPede aprovação no appRecursos pagos

  • Pedir exclusão da consulta do Listening

    Pede aprovação no app

    Pede para excluir uma consulta e as menções dela.

    Permissão: Operar Social Listening

  • Avaliar menções do Listening

    Pede aprovação no app

    Pede para registrar avaliações de relevância em menções, que ensinam a consulta.

    Permissão: Operar Social Listening

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • list_listening_queries Listar consultas do Listening
  • get_listening_query Ver consulta do Listening
  • query_listening_mentions Buscar menções do Listening
  • get_listening_mention Ver menção do Listening
  • listening_insights Resumo do Listening
  • list_listening_saved Listar menções salvas
  • create_listening_query Criar consulta do Listening
  • update_listening_query Editar consulta do Listening
  • decide_listening_suggestion Decidir sugestão do Listening
  • pause_listening_query Pausar consulta do Listening
  • set_listening_recipients Escolher quem recebe alertas do Listening
  • manage_listening_saved Gerenciar menções salvas
  • manage_listening_community Gerenciar comunidade do Listening
  • request_listening_sample Pedir amostra do Listening
  • request_google_places_search Buscar lugares para avaliações do Google
  • request_listening_activation Pedir ativação da consulta do Listening
  • request_listening_delete Pedir exclusão da consulta do Listening
  • request_listening_feedback Avaliar menções do Listening
AdsSó leitura

  • Ver anúncios

    Leitura

    Lê as campanhas e os anúncios das contas de anúncio escolhidas no workspace, com investimento e resultados.

    Permissão: Ler o workspace

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • get_ads Ver anúncios
Agência

  • Definir acesso à marca

    Pede aprovação no app

    Pede para dar ou tirar o acesso de alguém da agência a uma marca.

    Permissão: Administração

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • set_brand_access Definir acesso à marca
Workspace e equipe

  • Listar workspaces

    Leitura

    Lista os workspaces que você acessa, com o nome, o seu papel e o estado de cada um.

  • Ver um pedido

    Leitura

    Mostra um pedido feito pelo assistente: o que ele propõe, o estado e o prazo para aprovar.

    Permissão: Ler o workspace

  • Listar meus pedidos

    Leitura

    Lista os pedidos que você fez pelo assistente num workspace e o estado de cada um.

    Permissão: Ler o workspace

  • Listar membros

    Leitura

    Lista os membros do workspace e os papéis deles.

    Permissão: Ler o workspace

  • Listar contas conectadas

    Leitura

    Lista as redes sociais, os locais do Google Business e o estado das conexões de anúncio do workspace.

    Permissão: Ler o workspace

  • Gerenciar membro

    Pede aprovação no app

    Pede para mudar o papel ou as contas de um membro, tirá-lo do workspace ou sair dele.

    Permissão: Administração

  • Convidar membro

    Pede aprovação no app

    Pede para convidar até dez pessoas para o workspace, cada uma com um papel.

    Permissão: Administração

  • Gerenciar convite

    Revoga um convite pendente; reenviar pede aprovação.

    Permissão: Administração

    • revogarDiretoSeu cliente de IA pode pedir confirmação antes.
    • reenviarPede aprovação no app

  • Desconectar integração

    Pede aprovação no app

    Pede para desconectar uma rede social ou um local do Google Business do workspace.

    Permissão: Administração

  • Editar configurações do workspace

    Direto

    Muda o nome do workspace e quais e-mails da Zipe ele recebe.

    Permissão: Administração

    Seu cliente de IA pode pedir confirmação antes.

  • Gerenciar pauta de notícias

    Direto

    Ajusta a pauta de notícias que alimenta o e-mail diário de oportunidades.

    Permissão: Administração

    Seu cliente de IA pode pedir confirmação antes.

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • list_workspaces Listar workspaces
  • get_request_status Ver um pedido
  • list_my_requests Listar meus pedidos
  • list_members Listar membros
  • list_connections Listar contas conectadas
  • manage_member Gerenciar membro
  • invite_member Convidar membro
  • manage_invite Gerenciar convite
  • disconnect_integration Desconectar integração
  • update_workspace_settings Editar configurações do workspace
  • manage_news_agenda Gerenciar pauta de notícias
Conexão e preferências

  • Ver esta conexão

    Leitura

    Mostra esta conexão: o cliente de IA e as permissões concedidas.

  • Ver quem está conectado

    Leitura

    Mostra qual conta da Zipe está usando esta conexão.

  • Ajustar minha preferência

    Direto

    Ajusta os seus avisos de conteúdo e os e-mails diário e semanal num workspace.

    Permissão: Minhas preferências

    Seu cliente de IA pode pedir confirmação antes.

Para desenvolvedores

Nomes técnicos das ferramentas, como o cliente de IA os mostra.

  • describe_connection Ver esta conexão
  • get_account_identity Ver quem está conectado
  • set_my_preference Ajustar minha preferência

Permissões

Todas as permissões aparecem na primeira autorização, e você marca as que quiser.

Ler o workspace começa marcada. As outras começam marcadas só quando o cliente de IA as pede.

Recursos pagos e Administração começam desmarcadas na primeira autorização, mesmo quando o cliente as pede.

O assistente vê todas as ferramentas desde o início. Quando chama uma que pede uma permissão que você não deu, o cliente pede para autorizar de novo: no Claude, a tela de autorização; no ChatGPT, o aviso da conexão; no Claude Code, /mcp.

Um owner ou admin pode travar permissões específicas para agentes em cada workspace, em Configurações › Agentes de IA, na seção Permissões para agentes. Tudo nasce liberado, inclusive Conversas.

  • Ler o workspace

    Começa marcada

    Lê posts, métricas, calendário, Brain, automações e concorrentes dos workspaces que você acessa. Também lê os pedidos que esperam aprovação.

  • Ler Conversas

    Marcada quando o cliente pede

    Lê mensagens diretas, comentários, menções e avaliações das contas conectadas.

  • Responder em Conversas

    Marcada quando o cliente pede

    Prepara respostas e moderação de comentários. O que sai para o público espera aprovação de alguém do workspace.

  • Ler Social Listening

    Marcada quando o cliente pede

    Lê as consultas, as menções coletadas e os resumos do Social Listening.

  • Operar Social Listening

    Marcada quando o cliente pede

    Cria e ajusta consultas do Social Listening. Ativar, coletar e excluir esperam aprovação.

  • Criar e publicar conteúdo

    Marcada quando o cliente pede

    Cria rascunhos, ideias e modelos de mensagem. Agendar e publicar esperam aprovação.

  • Gerenciar automações

    Marcada quando o cliente pede

    Cria e edita automações, que nascem pausadas. Ativar espera aprovação.

  • Ajustar o Brain

    Marcada quando o cliente pede

    Confirma ou corrige fatos do Brain. Declarar fato novo e revisar estratégia esperam aprovação.

  • Gerenciar concorrentes

    Marcada quando o cliente pede

    Começa ou deixa de monitorar contas em Insights. Sempre com aprovação de alguém do workspace.

  • Recursos pagos

    Começa desmarcada

    Leituras e coletas que usam o limite diário do workspace, as mesmas que o app oferece.

  • Administração

    Começa desmarcada

    Prepara convites, papéis, acesso a marcas e configurações do workspace. Um owner ou admin aprova cada mudança.

  • Minhas preferências

    Marcada quando o cliente pede

    Ajusta as suas próprias preferências de aviso na Zipe.

Segurança

Como sei que estou conectando a Zipe de verdade?

O endereço tem de ser https://mcp.zipe.app/mcp, no host mcp.zipe.app. Desconfie de qualquer outro.

A tela de autorização abre em app.zipe.app e mostra o nome do cliente de IA e as permissões pedidas. Se algo não bater, feche a tela.

Um workspace por vez

Cada ferramenta lê ou escreve num workspace só, e toda resposta, widget e pedido mostra o nome dele. Nenhuma ferramenta junta dados de workspaces diferentes.

Se o assistente escrever num workspace até 24 horas depois de ter lido ou escrito em outro, a escrita vira um pedido no app, mesmo que fosse direta.

Quem fica sabendo quando eu conecto?

Você e os owners e admins de todos os seus workspaces ativos recebem um aviso no sino e por e-mail, com o nome do cliente.

Cada pessoa pode desligar esse aviso em Configurações › Notificações, inclusive você. O alerta de uso indevido da conexão continua chegando por e-mail e não pode ser desligado.

Conexão criada pelo suporte

Durante uma sessão de suporte, uma pessoa autorizada da Zipe pode conectar um assistente operado pela Zipe por até 24 horas. Essa conexão aparece com o selo Criada pelo suporte da Zipe, não faz alterações administrativas nem aprova pedidos e termina com a sessão.

Aprovações

  • Rascunhos e itens internos que dá para desfazer são feitos direto. O que sai para o público, muda acesso, custa ou apaga vira um pedido no app.
  • Os pedidos ficam na fila Pedidos do agente de cada workspace. Quem tem a permissão aprova um a um ou em lote, vários do mesmo tipo de uma vez, e pode tirar itens de um lote antes de aprovar.
  • Pode aprovar qualquer pessoa cujo papel no workspace permite a ação, inclusive quem pediu.
  • Um pedido vale 24 horas, ou menos quando a janela de 24 horas da rede social para responder uma mensagem ou comentário fecha antes. O cartão do pedido mostra o prazo real.
  • Nenhuma ferramenta nem widget aprova um pedido. A aprovação acontece só no app.

Perguntas frequentes

Quanto o assistente pode usar?

O assistente usa os limites do workspace, como no app, conforme o plano ou contrato do workspace.

Leitura de mídia, transcrição e consultas a perfis e hashtags fora dos acompanhados só funcionam com a permissão Recursos pagos marcada.

Por que o assistente pediu permissão no meio da conversa?

O assistente vê todas as ferramentas, mas cada uma exige a permissão dela. Quando falta uma, o cliente abre a autorização de novo para você decidir.

No Claude Code, isso aparece em /mcp; para evitar, declare as permissões em oauth.scopes.

Como limito o que agentes fazem no meu workspace?

Em Configurações › Agentes de IA, um owner ou admin pode desligar o acesso de agentes no workspace, travar permissões específicas e bloquear uma conexão.

Por que o Cursor não aparece?

A Zipe entrega o catálogo inteiro de uma vez (99 ferramentas) e o Cursor desliga ferramentas acima do limite de cerca de 40 dele. Por isso ainda não há guia para o Cursor.

Solução de problemas

Quando uma ferramenta recusa um pedido, o assistente mostra o motivo. Estes são os mais comuns.

A conexão venceu
Conecte a Zipe de novo pelo seu cliente de IA.
Código: token_expired
A conexão foi encerrada
Alguém encerrou a conexão em Configurações › Agentes de IA, ou você mesmo. Conecte de novo se ainda precisar.
Código: token_revoked
Falta uma permissão
Autorize de novo quando o cliente pedir e marque a permissão que a ferramenta precisa. No Claude Code, use /mcp.
Código: insufficient_scope
Permissão travada neste workspace
Um owner ou admin travou essa permissão para agentes. Só ele pode liberar, em Configurações › Agentes de IA.
Código: agent_permission_locked
Agentes de IA desligados no workspace
Peça a um owner ou admin do workspace para conferir Configurações › Agentes de IA.
Código: workspace_mcp_disabled
Conexão bloqueada no workspace
Peça a um owner ou admin do workspace para conferir Configurações › Agentes de IA.
Código: workspace_blocked_for_connection
Workspace suspenso
O owner do workspace pode reativá-lo no app da Zipe. Enquanto isso, as ferramentas não agem nele.
Código: workspace_suspended
Pagamento pendente no workspace
O owner do workspace pode regularizar a assinatura no app da Zipe.
Código: workspace_past_due
Workspace removido
O workspace não existe mais. Peça ao assistente para listar seus workspaces e escolher outro.
Código: workspace_removed
Seu papel não permite a ação
Onde você é viewer, o assistente só lê. Peça a um owner ou admin para mudar seu papel, se fizer sentido.
Código: role_insufficient
Workspace não encontrado
Peça ao assistente para listar seus workspaces e usar o nome exato.
Código: workspace_unknown
Muitas chamadas seguidas
Espere alguns segundos e peça de novo.
Código: burst_limited
Acesso de agentes pausado
A Zipe pausou o acesso de agentes por segurança. Tente mais tarde; o app continua funcionando.
Código: platform_paused
Limite do workspace atingido
O limite do workspace para essa ação acabou e volta na data indicada, como no app.
Código: quota_exceeded
Janela de resposta fechada
A rede social só aceita resposta dentro de 24 horas da última mensagem da pessoa. Espere ela escrever de novo.
Código: messaging_window_closed

Novidades

    • Nova: Listar workspaces. Nova ferramenta.
    • Nova: Ver esta conexão. Nova ferramenta.
    • Nova: Ver quem está conectado. Nova ferramenta.
    • Nova: Visão geral do workspace. Nova ferramenta.
    • Nova: Listar posts. Nova ferramenta.
    • Nova: Ver um post. Nova ferramenta.
    • Nova: Série diária de uma conta. Nova ferramenta.
    • Nova: Ver o público. Nova ferramenta.
    • Nova: Ver anúncios. Nova ferramenta.
    • Nova: Ver o calendário. Nova ferramenta.
    • Nova: Listar ideias. Nova ferramenta.
    • Nova: Revisar texto. Nova ferramenta.
    • Nova: Buscar no Brain. Nova ferramenta.
    • Nova: Ver o contexto da marca. Nova ferramenta.
    • Nova: Ler uma fonte do Brain. Nova ferramenta.
    • Nova: Listar automações. Nova ferramenta.
    • Nova: Ver uma automação. Nova ferramenta.
    • Nova: Desempenho de uma automação. Nova ferramenta.
    • Nova: Listar modelos de mensagem. Nova ferramenta.
    • Nova: Painel de concorrentes. Nova ferramenta.
    • Nova: Listar conteúdo de concorrentes. Nova ferramenta.
    • Nova: Analisar hashtags. Nova ferramenta.
    • Nova: Buscar no workspace. Nova ferramenta.
    • Nova: Abrir um item. Nova ferramenta.
    • Nova: Saúde das contas. Nova ferramenta.
    • Nova: Resultado de leitura de mídia. Nova ferramenta.
    • Nova: Ler imagem ou vídeo. Nova ferramenta.
    • Nova: Transcrever vídeo. Nova ferramenta.
    • Nova: Consultar perfil público. Nova ferramenta.
    • Nova: Ler comentários de concorrente. Nova ferramenta.
    • Nova: Buscar posts por hashtag. Nova ferramenta.
    • Nova: Ver um pedido. Nova ferramenta.
    • Nova: Listar meus pedidos. Nova ferramenta.
    • Nova: Criar rascunho de post. Nova ferramenta.
    • Nova: Editar rascunho de post. Nova ferramenta.
    • Nova: Cancelar agendamento. Nova ferramenta.
    • Nova: Agendar publicação. Nova ferramenta.
    • Nova: Tentar publicar de novo. Nova ferramenta.
    • Nova: Editar post publicado. Nova ferramenta.
    • Nova: Excluir post. Nova ferramenta.
    • Nova: Criar ideia. Nova ferramenta.
    • Nova: Editar ideia. Nova ferramenta.
    • Nova: Mover ideias. Nova ferramenta.
    • Nova: Gerenciar etiquetas de ideias. Nova ferramenta.
    • Nova: Editar propriedades do quadro de ideias. Nova ferramenta.
    • Nova: Comentar ideia. Nova ferramenta.
    • Nova: Criar post a partir de ideia. Nova ferramenta.
    • Nova: Criar link de aprovação. Nova ferramenta.
    • Nova: Revogar link de aprovação. Nova ferramenta.
    • Nova: Excluir ideias. Nova ferramenta.
    • Nova: Registrar fato no Brain. Nova ferramenta.
    • Nova: Revisar estratégia. Nova ferramenta.
    • Nova: Monitorar conta. Nova ferramenta.
    • Nova: Parar de monitorar conta. Nova ferramenta.
    • Nova: Criar automação. Nova ferramenta.
    • Nova: Editar automação. Nova ferramenta.
    • Nova: Ativar ou pausar automação. Nova ferramenta.
    • Nova: Excluir automação. Nova ferramenta.
    • Nova: Gerenciar modelo de mensagem. Nova ferramenta.
    • Nova: Listar conversas. Nova ferramenta.
    • Nova: Ler conversa. Nova ferramenta.
    • Nova: Números das conversas. Nova ferramenta.
    • Nova: Listar comentários. Nova ferramenta.
    • Nova: Ler fio de comentários. Nova ferramenta.
    • Nova: Listar menções. Nova ferramenta.
    • Nova: Listar avaliações. Nova ferramenta.
    • Nova: Marcar conversa como lida. Nova ferramenta.
    • Nova: Responder mensagem. Nova ferramenta.
    • Nova: Responder comentário por mensagem. Nova ferramenta.
    • Nova: Ocultar comentário. Nova ferramenta.
    • Nova: Moderar comentário. Nova ferramenta.
    • Nova: Listar consultas do Listening. Nova ferramenta.
    • Nova: Ver consulta do Listening. Nova ferramenta.
    • Nova: Buscar menções do Listening. Nova ferramenta.
    • Nova: Ver menção do Listening. Nova ferramenta.
    • Nova: Resumo do Listening. Nova ferramenta.
    • Nova: Listar menções salvas. Nova ferramenta.
    • Nova: Criar consulta do Listening. Nova ferramenta.
    • Nova: Editar consulta do Listening. Nova ferramenta.
    • Nova: Decidir sugestão do Listening. Nova ferramenta.
    • Nova: Pausar consulta do Listening. Nova ferramenta.
    • Nova: Escolher quem recebe alertas do Listening. Nova ferramenta.
    • Nova: Gerenciar menções salvas. Nova ferramenta.
    • Nova: Gerenciar comunidade do Listening. Nova ferramenta.
    • Nova: Pedir amostra do Listening. Nova ferramenta.
    • Nova: Buscar lugares para avaliações do Google. Nova ferramenta.
    • Nova: Pedir ativação da consulta do Listening. Nova ferramenta.
    • Nova: Pedir exclusão da consulta do Listening. Nova ferramenta.
    • Nova: Avaliar menções do Listening. Nova ferramenta.
    • Nova: Listar membros. Nova ferramenta.
    • Nova: Listar contas conectadas. Nova ferramenta.
    • Nova: Gerenciar membro. Nova ferramenta.
    • Nova: Convidar membro. Nova ferramenta.
    • Nova: Gerenciar convite. Nova ferramenta.
    • Nova: Definir acesso à marca. Nova ferramenta.
    • Nova: Desconectar integração. Nova ferramenta.
    • Nova: Editar configurações do workspace. Nova ferramenta.
    • Nova: Gerenciar pauta de notícias. Nova ferramenta.
    • Nova: Ajustar minha preferência. Nova ferramenta.