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

Zinn®, nosso Viking, comemorando enquanto um assistente de IA se conecta às ferramentas da plataforma.

Configure-o em três etapas

  1. 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.

  2. 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.

  3. 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@latest

Cursor

// .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çãoO que fazEdição
Responder a um chamadoResponde 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 assistenteFaz 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 chamadoAbre 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 chatEncerra um chat; o visitante ainda pode solicitar a transcrição.Edição gratuita
Abrir um chamadoAbre 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 chamadoExclui 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 conversaRetorna 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 suporteRetorna 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 chatRetorna 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 ticketRetorna um ticket com todo o seu histórico de conversa, status, prioridade e responsável.Edição gratuita
Devolver o chat ao assistenteRetorna 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 vivoLista 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 sabeLista 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 chamadosLista os chamados de suporte, filtrados por status ou pesquisa, uma página por vez.Edição gratuita
Reconstruir o índice de busca do assistenteReconstró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 assistenteLê novamente um item (item_id) ou tudo (all: true) para o índice do assistente (apenas gerentes).Edição gratuita
Responder em um chatEnvia 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 disponibilidadeMarca 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 chatAtribui um chat em espera ao agente conectado, para que o visitante fale com uma pessoa.Edição gratuita
Alterar as configurações do chatAltera 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 chamadoAltera 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.

O servidor MCP da Zinn Digital®