Agentes de IA (MCP)
Zinn® Chat para agentes de IA
Seu site WordPress é o seu próprio servidor MCP. Um assistente de IA faz login como usuário do WordPress com uma senha de aplicativo e pode fazer o que esse usuário puder fazer com Zinn® Chat — nada mais.
36 ações: 21 gratuitas, 15 no Pro.
Referência do desenvolvedor: cada ação, sua rota REST e seus parâmetros
Configure-o em três etapas
Verifique a chave
Você precisa do WordPress 6.9 ou posterior e de Zinn® Chat 2.9.0 ou posterior. Nas configurações do plugin, "Allow AI agents (MCP)" está ativado, a menos que você o tenha desativado.
Criar uma senha de aplicativo
No WordPress, abra Usuários, depois Perfil, e adicione uma senha de aplicativo com o nome do seu aplicativo de IA. Copie-a: o WordPress a exibe apenas uma vez.
Adicione o site ao seu aplicativo de IA
Use seu nome de usuário do WordPress, a senha do aplicativo e o endereço de conexão do seu site:
https://example.com/wp-json/zinn-chat/v1/mcp
Configuração para aplicativos de IA populares
Todos os aplicativos abaixo se comunicam com o seu site através do proxy oficial do WordPress, @automattic/mcp-wordpress-remote. Substitua o endereço, o nome de usuário e a senha pelos seus.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-chat \
-e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestCursor
// .cursor/mcp.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}VS Code
// .vscode/mcp.json — VS Code's key is "servers"
{
"servers": {
"zinn-chat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Outros aplicativos
Qualquer aplicativo que ofereça suporte a servidores MCP por meio de entrada e saída padrão pode usar o mesmo comando e as mesmas configurações. Aplicativos que se conectam apenas a servidores HTTP remotos podem acessar o endereço de conexão diretamente com o mesmo nome de usuário e a mesma senha de aplicativo. O ChatGPT é a exceção por enquanto: ele se conecta a servidores MCP apenas por login OAuth, portanto, não pode usar uma senha de aplicativo.
O que um agente de IA pode fazer
Tudo o que as próprias telas do plugin conseguem fazer. As ações marcadas como Pro exigem uma licença do Zinn® Chat Pro.
| Ação | O que ele faz | Edição |
|---|---|---|
| Responder a um chamado | Responde ao cliente por e-mail (text) ou adiciona uma nota interna (note: true); o status altera opcionalmente o status do ticket. | Edição gratuita |
| Perguntar ao assistente | Faz uma pergunta ao assistente de IA do site e retorna a resposta com todas as fontes encontradas. | Edição gratuita |
| Alterar vários tickets de uma só vez (Pro) | Altera o status, a prioridade ou o responsável por até 100 tickets (ids). Cada ticket passa pelas mesmas verificações de quando é alterado individualmente; o resultado lista cada um deles. | Edição Pro |
| Transformar um chat em um chamado | Abre um chamado a partir de um chat para que ele possa ser respondido por e-mail (necessita do endereço de e-mail do visitante). | Edição gratuita |
| Fechar um chat | Encerra um chat; o visitante ainda pode solicitar a transcrição. | Edição gratuita |
| Abrir um chamado | Abre um chamado em nome de um cliente (o e-mail dele, um assunto e a primeira mensagem). | Edição gratuita |
| Excluir uma resposta salva (Pro) | Exclui uma resposta salva. | Edição Pro |
| Excluir um ticket | Exclui permanentemente um ticket e sua respectiva conversa (somente para gerentes). | Edição gratuita |
| Esboçar um artigo de ajuda a partir de um ticket (Pro) | Escreve um rascunho de artigo da base de conhecimento a partir de um ticket resolvido; ele permanece como rascunho até que alguém o publique. | Edição Pro |
| Escrever artigos de ajuda para perguntas sem resposta (Pro) | Escreve rascunhos de artigos da base de conhecimento respondendo às perguntas escolhidas (ids); eles permanecem como rascunhos. | Edição Pro |
| Preencher com uma resposta salva (Pro) | Retorna o texto de uma resposta salva com seus espaços reservados preenchidos para um chat ou chamado. | Edição Pro |
| Ler um chat | Retorna as mensagens de um chat e os detalhes do visitante (after: apenas mensagens mais recentes do que este ID). | Edição gratuita |
| Ler a visão geral do suporte | Retorna quantos tickets estão em cada status e quantos chats estão aguardando por uma pessoa (e suas mensagens não lidas), e se o chat, o assistente e os tickets estão ativados. | Edição gratuita |
| Ler as configurações do chat | Retorna todas as configurações de chat: o widget, o assistente, pessoas e horário de atendimento, tickets e e-mail, o índice do site, privacidade e spam. | Edição gratuita |
| Ler estatísticas de suporte (Pro) | Retorna o número de chats e tickets, os tempos de resposta e as avaliações dos últimos N dias (dias). | Edição Pro |
| Ler ticket | Retorna um ticket com toda a sua conversa, status, prioridade e responsável. | Edição gratuita |
| Devolver um chat para o assistente | Retorna um chat para o assistente de IA, que responde ao visitante com base no conteúdo do site. | Edição gratuita |
| Listar respostas salvas (Pro) | Lista as respostas salvas que os atendentes podem inserir, juntamente com seus atalhos. | Edição Pro |
| Listar chats ao vivo | Lista os chats aguardando, em andamento e recentemente encerrados, indicando quem está atendendo cada um. | Edição gratuita |
| Liste o que o assistente sabe | Lista o conteúdo que o assistente usa para responder, com o respectivo status de indexação, uma página por vez. | Edição gratuita |
| Listar perguntas sem resposta (Pro) | Lista as perguntas feitas pelos visitantes que a base de conhecimento não pôde responder. | Edição Pro |
| Listar tickets | Lista tickets de suporte, filtrados por status ou pesquisa, uma página por vez. | Edição gratuita |
| Reconstruir o índice de pesquisa do assistente | Reconstrói os vetores de busca para um item (item_id) ou para tudo (all: true) (apenas para gerentes). | Edição gratuita |
| Releia o conteúdo para o assistente | Releia um único item (item_id) ou tudo (all: true) para o índice do assistente (apenas para gerentes). | Edição gratuita |
| Responder no chat | Envia uma mensagem para o visitante (text) ou adiciona uma nota interna que apenas os agentes veem (note: true). | Edição gratuita |
| Salvar uma resposta salva (Pro) | Cria ou altera uma resposta salva (título, atalho, corpo, departamento; id para alterar uma). | Edição Pro |
| Escrever um artigo de ajuda (Pro) | Cria um artigo de base de conhecimento ou altera um (id): título, conteúdo, resumo, categorias e status (rascunho ou publicar quando você puder publicar). | Edição Pro |
| Pesquisar na base de conhecimento (Pro) | Encontra artigos de ajuda para incluir num link em uma resposta (q: a pesquisa). | Edição Pro |
| Definir o departamento e as tags de uma conversa (Pro) | Define o departamento e as tags de um chat ou tíquete (tipo: chat ou tíquete; id). | Edição Pro |
| Marcar perguntas sem resposta (Pro) | Marca as perguntas não respondidas como abertas, planejadas ou descartadas (ids, status). | Edição Pro |
| Defina sua disponibilidade | Marca o agente conectado como disponível ou ausente para novos chats (ausente: true ou false). | Edição gratuita |
| Redigir uma resposta com IA (Pro) | Rascunha uma resposta para um chat ou ticket a partir do conteúdo do site; nada é enviado. | Edição Pro |
| Resumir uma conversa com IA (Pro) | Resume um chat ou ticket em poucas linhas. | Edição Pro |
| Iniciar um chat | Atribui um chat em espera ao atendente conectado, para que o visitante fale com uma pessoa. | Edição gratuita |
| Alterar as configurações do chat | Altera as configurações que você envia (configurações: chave para valor) e mantém o restante. Cada valor é verificado exatamente como na tela de configurações; get-settings lista as chaves. | Edição gratuita |
| Alterar um ticket | Altera o status, a prioridade ou o responsável por um ticket. | Edição gratuita |
Seguro por padrão
Cada ação verifica a mesma permissão do WordPress que a tela do próprio plugin, para a página ou post exato que ela afeta. Um assinante não pode se conectar de forma alguma.
As senhas de aplicativo podem ser revogadas a qualquer momento em Usuários, Perfil, sem alterar sua senha normal.
Desative "Allow AI agents (MCP)" e as ações e o endereço de conexão desaparecerão do site.
As páginas alteradas por um agente mantêm suas revisões do WordPress, portanto, qualquer alteração pode ser desfeita.
Hospedado na Zinn Digital®?
Se a Zinn Digital® hospedar o site, nosso próprio servidor MCP poderá usar estas ações para você sem uma senha de aplicativo: conecte seu aplicativo de IA ao servidor MCP da Zinn Digital® e use wordpress_abilities_list e wordpress_ability_run.