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
O mesmo guia em nossa base de conhecimento, com todas as ações gratuitas listadas
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"
}
}
}
}Claude e ChatGPT (entrar)
Adicione o endereço de conexão como um conector personalizado no Claude ou como um servidor MCP personalizado no ChatGPT. Eles abrem seu site para que você possa aprová-los como um usuário do WordPress, sem a necessidade de copiar senhas de aplicativos. Seu site precisa de links permanentes amigáveis.
Outros aplicativos
Qualquer aplicativo que suporte servidores MCP por meio de entrada e saída padrão pode usar o mesmo comando e as mesmas configurações. Os 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 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 faz | Edição |
|---|---|---|
| Responder a um chamado | Responde ao cliente por e-mail (text) ou adiciona uma nota interna (note: true); status altera opcionalmente o status do tíquete. | Edição gratuita |
| Pergunte ao assistente | Faz uma pergunta ao assistente de IA do site e retorna sua resposta com todas as fontes encontradas. | Edição gratuita |
| Altere vários tíquetes de uma vez (Pro) | Altera o status, a prioridade ou o responsável de até 100 tíquetes (ids). Cada tíquete passa pelas mesmas verificações de quando é alterado individualmente; o resultado lista cada um deles. | Edição Pro |
| Converter um chat em chamado | Abre um chamado a partir de um chat para que 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 chamado | Exclui um tíquete e sua conversa permanentemente (somente gerentes). | Edição gratuita |
| Rascunhar um artigo de ajuda a partir de um chamado (Pro) | Escreve um rascunho de artigo da base de conhecimento a partir de um tíquete resolvido; ele permanece como rascunho até que alguém o publique. | Edição Pro |
| Crie rascunhos de 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 uma resposta salva (Pro) | Retorna o texto de uma resposta salva com seus marcadores preenchidos para um chat ou chamado. | Edição Pro |
| Ler uma conversa | Retorna as mensagens e os detalhes do visitante de um chat (after: apenas mensagens mais recentes que este ID). | Edição gratuita |
| Leia a visão geral do suporte | Retorna quantos tíquetes estão em cada status, quantos chats estão aguardando um atendente (e suas mensagens não lidas) e se o chat, o assistente e os tíquetes estão ativados. | Edição gratuita |
| Leia as configurações de chat | Retorna todas as configurações de chat: o widget, o assistente, pessoas e horário de funcionamento, 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 tíquetes, tempos de resposta e avaliações dos últimos N dias (dias). | Edição Pro |
| Ler um ticket | Retorna um ticket com todo o seu histórico de conversa, status, prioridade e responsável. | Edição gratuita |
| Devolver o chat ao assistente | Retorna uma conversa ao assistente de IA, que responde ao visitante a partir do conteúdo do site. | Edição gratuita |
| Listar respostas salvas (Pro) | Lista as respostas salvas que os agentes podem inserir, com seus atalhos. | Edição Pro |
| Listar chats ao vivo | Lista os chats em espera, em andamento e encerrados recentemente, com a informação de quem está atendendo cada um. | Edição gratuita |
| Liste o que o assistente sabe | Lista o conteúdo a partir do qual o assistente responde, com seu status de indexação, uma página por vez. | Edição gratuita |
| Listar perguntas não respondidas (Pro) | Lista as perguntas feitas pelos visitantes que a base de conhecimento não conseguiu responder. | Edição Pro |
| Listar chamados | Lista os chamados de suporte, filtrados por status ou pesquisa, uma página por vez. | Edição gratuita |
| Reconstruir o índice de busca do assistente | Reconstrói os vetores de pesquisa para um item (item_id) ou para tudo (all: true) (apenas gerentes). | Edição gratuita |
| Releia o conteúdo no assistente | Lê novamente um item (item_id) ou tudo (all: true) para o índice do assistente (apenas gerentes). | Edição gratuita |
| Responder em um chat | Envia uma mensagem para o visitante (text) ou adiciona uma nota interna visível apenas para os agentes (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 da 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 |
| Pesquise na base de conhecimento (Pro) | Encontra artigos de ajuda para incluir como link em uma resposta (q: a busca). | Edição Pro |
| Defina o departamento e as tags de uma conversa (Pro) | Define o departamento e as tags de um chat ou tíquete (kind: chat ou tíquete; id). | Edição Pro |
| Marcar perguntas sem resposta (Pro) | Marca perguntas não respondidas como abertas, planejadas ou dispensadas (ids, status). | Edição Pro |
| Defina sua disponibilidade | Marca o atendente conectado como disponível ou ausente para novos chats (away: true ou false). | Edição gratuita |
| Elabore um rascunho de resposta com IA (Pro) | Cria um rascunho de resposta para um chat ou chamado a partir do conteúdo do site; nada é enviado. | Edição Pro |
| Resumir uma conversa com IA (Pro) | Resume um chat ou chamado em poucas linhas. | Edição Pro |
| Atender um chat | Atribui um chat em espera ao agente 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 as restantes. Cada valor é verificado exatamente como na tela de configurações; get-settings lista as chaves. | Edição gratuita |
| Alterar um chamado | Altera o status, a prioridade ou o responsável de um chamado. | 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.