O MCP da Zatten: ferramentas

O MCP da Zatten tem quatro ferramentas. Três leem e uma escreve. Todas agem em nome da conta da agência, dentro do alcance da conexão criada no painel.

​

O ciclo de uso

​

O par project_id + project_name

get_template e update_template pedem o id do projeto e o nome exato, como vieram de list_projects. O servidor confere os dois contra o banco. Se não casarem, recusa e diz de quem é o id enviado. É a trava mais barata contra mexer no cliente errado: quem confunde dois projetos erra o id ou o nome, e errar os dois do mesmo jeito é muito menos provável.

​

whoami

Confirma a conta conectada. Use antes de alterar qualquer coisa, para dizer à pessoa em nome de quem você está agindo.

​

list_projects

Os projetos que a conexão alcança, em ordem de nome. A lista é o limite da conexão: projeto que não aparece aqui não pode ser lido nem alterado, nem pelo id.

​

get_template

O projeto inteiro em JSON: funil, tags, propriedades, skills, automações, fluxos, templates da Meta e o agente. A referência de cada bloco está em Referência do template.

• O config do agente vem da versão mais nova, publicada ou não. Assim quem edita não apaga um rascunho que alguém deixou no painel.
• Todos os templates da Meta do projeto vêm no bloco meta_templates.
• A revision é a marca do estado atual. Duas leituras sem mudança no meio devolvem a mesma; se mudou, alguém mexeu.
• O JSON traz endereços de webhook e de MCP, headers e as chaves do agente (do modelo e do LangSmith), preenchidos. Trate-o como confidencial: nunca mostre uma chave na conversa nem a grave em arquivo. O snapshot é gravado com as chaves trocadas por "<removido>" (ver Organizar sua agência).

​

update_template

Aplica alterações. Cria o que falta, atualiza o que existe e nunca apaga. Envie só os blocos que vai mudar: o que não vier não é tocado. Mas o bloco enviado é declarado por inteiro, e o que existir no projeto e faltar no bloco volta como órfão. As regras completas (o que conta como “vazio”, ligar e desligar, renomear, referências por nome, o agente) estão em Como uma escrita funciona. O que update_template não faz:

• apagar qualquer coisa;
• publicar a versão do agente (cria uma versão nova, não publicada);
• enviar template à Meta (o envio é pelo painel);
• migrar o projeto de motor;
• reescrever o desenho de um fluxo que já existe;
• gravar llm_attendant.functions;
• ligar a aprovação humana do agente.

Os assistentes tratam update_template como ação destrutiva e costumam pedir confirmação. Não é que apague: é que altera a configuração de um cliente real.

​

Erros

Quando a operação é recusada, nada é alterado. As mensagens dizem o que fazer:

​

Armadilhas

• ok: true não quer dizer que tudo foi feito. Recusas parciais (automação que não ligou por falta de endereço, conversão cuja coluna não existe, template da Meta não enviado) aparecem só nas notes.
• A revision não vem na resposta da escrita. Duas escritas seguidas com a mesma revision: a segunda é recusada, porque a primeira já mudou o projeto.
• "" numa chave do langchain.config apaga a chave. A chave do modelo e a do LangSmith só são mantidas quando o campo não vem. Devolva o valor lido ou omita o campo; nunca troque a chave por "" ou por um texto de exemplo.
• Renomear o projeto muda o par. Se o bloco meta trocar o nome do projeto, a próxima chamada precisa do nome novo.
• A nota sobre templates da Meta cita uma opção que o MCP não tem. Quando faltam templates, a nota sugere submit_meta_templates: true. Pelo MCP essa opção não existe: o envio à Meta é feito por uma pessoa, no painel (WhatsApp → Templates).

​

Para saber mais

• Como uma escrita funciona
• Referência do template
• Instalar a skill e o MCP
• API de template (REST): o mesmo motor, por HTTP, com a chave do projeto.
• MCP: especificação, ferramentas. Termos para buscar: “MCP tools”, “tool annotations destructiveHint”.