Agentes de IA (MCP)

Zinn® Chat para agentes de IA

Su sitio de WordPress es su propio servidor MCP. Un asistente de IA inicia sesión como usuario de WordPress con una contraseña de aplicación y puede hacer lo que ese usuario pueda hacer con Zinn® Chat, y nada más.

36 acciones: 21 gratis, 15 en Pro.

Referencia para desarrolladores: cada acción, su ruta REST y sus parámetros

La misma guía en nuestra base de conocimientos, con todas las acciones gratuitas enumeradas

Zinn®, nuestro vikingo, vitorea mientras un asistente de IA se conecta a las herramientas de la plataforma.

Configúrelo en tres pasos

  1. Comprobar el interruptor

    Necesita WordPress 6.9 o posterior y Zinn® Chat 2.9.0 o posterior. En la configuración del plugin, «Allow AI agents (MCP)» está activada a menos que la haya desactivado.

  2. Crear una contraseña de aplicación

    En WordPress, abra Usuarios, luego Perfil y añada una contraseña de aplicación con el nombre de su aplicación de IA. Cópiela: WordPress la muestra una vez.

  3. Añada el sitio a su aplicación de IA

    Utilice su nombre de usuario de WordPress, la contraseña de aplicación y la dirección de conexión de su sitio:

    https://example.com/wp-json/zinn-chat/v1/mcp

Configuración para aplicaciones de IA populares

Cada aplicación a continuación se comunica con su sitio a través del proxy oficial de WordPress, @automattic/mcp-wordpress-remote. Reemplace la dirección, el nombre de usuario y la contraseña por los suyos.

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 y ChatGPT (iniciar sesión)

Añada la dirección de conexión como un conector personalizado en Claude, o como un servidor MCP personalizado en ChatGPT. Abrirán su sitio para que pueda aprobarlos como usuario de WordPress, sin necesidad de copiar ninguna contraseña de aplicación. Su sitio necesita enlaces permanentes descriptivos.

Otras aplicaciones

Cualquier aplicación que admita servidores MCP a través de la entrada y salida estándar puede utilizar el mismo comando y la misma configuración. Las aplicaciones que solo se conectan a servidores HTTP remotos pueden acceder a la dirección de conexión directamente con el mismo nombre de usuario y contraseña de la aplicación.

Qué puede hacer un agente de IA

Todo lo que las propias pantallas del plugin pueden hacer. Las acciones marcadas como Pro necesitan una licencia de Zinn® Chat Pro.

AcciónQué haceEdición
Responder a un ticketResponde al cliente por correo electrónico (text) o añade una nota interna (note: true); status cambia opcionalmente el estado del ticket.Edición gratuita
Pregunta al asistenteHace una pregunta al asistente de IA del sitio y devuelve su respuesta con cada una de las fuentes encontradas.Edición gratuita
Cambia varias entradas a la vez (Pro)Cambia el estado, la prioridad o la persona asignada de hasta 100 tickets (ids). Cada ticket pasa por las mismas comprobaciones que si lo cambiaras por separado; el resultado muestra cada uno de ellos.Edición Pro
Convierte un chat en un ticketAbre un ticket a partir de un chat para que pueda responderse por correo electrónico (necesita la dirección de correo electrónico del visitante).Edición gratuita
Cerrar un chatFinaliza un chat; el visitante aún puede solicitar la transcripción.Edición gratuita
Abrir un ticketAbre un ticket en nombre de un cliente (su correo electrónico, un asunto y el primer mensaje).Edición gratuita
Eliminar una respuesta guardada (Pro)Elimina una respuesta guardada.Edición Pro
Eliminar un ticketElimina un ticket y su conversación de forma permanente (solo administradores).Edición gratuita
Redacta un borrador de artículo de ayuda a partir de un ticket (Pro)Escribe un borrador de artículo de base de conocimientos a partir de un ticket resuelto; se mantiene como borrador hasta que alguien lo publique.Edición Pro
Crea borradores de artículos de ayuda para preguntas sin respuesta (Pro)Escribe borradores de artículos de la base de conocimiento que responden a las preguntas seleccionadas (id); se quedan como borradores.Edición Pro
Rellena una respuesta guardada (Pro)Devuelve el texto de una respuesta guardada con sus marcadores de posición completados para un chat o ticket.Edición Pro
Leer un chatDevuelve los mensajes de un chat y los detalles del visitante (after: solo mensajes posteriores a este id).Edición gratuita
Lee el resumen de soporteDevuelve cuántos tickets hay en cada estado, cuántos chats están esperando a una persona (y sus mensajes no leídos), y si el chat, el asistente y los tickets están activados.Edición gratuita
Lee los ajustes del chatDevuelve todos los ajustes del chat: el widget, el asistente, las personas y el horario de atención, los tickets y el correo electrónico, el índice del sitio, la privacidad y el spam.Edición gratuita
Leer estadísticas de soporte (Pro)Devuelve el número de chats y tickets, tiempos de respuesta y valoraciones de los últimos N días (días).Edición Pro
Leer un ticketDevuelve un ticket con toda su conversación, estado, prioridad y persona asignada.Edición gratuita
Devuelve el chat al asistenteDevuelve un chat al asistente de IA, que responde al visitante a partir del contenido del sitio.Edición gratuita
Listar respuestas guardadas (Pro)Muestra las respuestas guardadas que los agentes pueden insertar, junto con sus atajos.Edición Pro
Listar chats en vivoMuestra una lista de los chats en espera, en curso y cerrados recientemente, junto con la persona encargada de cada uno.Edición gratuita
Lista lo que el asistente sabeMuestra el contenido a partir del cual responde el asistente, con su estado de indexación, página por página.Edición gratuita
Listar preguntas sin respuesta (Pro)Muestra las preguntas que hicieron los visitantes y que la base de conocimientos no pudo responder.Edición Pro
Listar ticketsMuestra una lista de tickets de soporte, filtrados por estado o búsqueda, una página a la vez.Edición gratuita
Reconstruir el índice de búsqueda del asistenteReconstruye los vectores de búsqueda para un elemento (item_id) o para todo (all: true) (solo administradores).Edición gratuita
Vuelve a leer el contenido en el asistenteVuelve a leer un elemento (item_id) o todo (all: true) en el índice del asistente (solo para administradores).Edición gratuita
Responder en el chatEnvía un mensaje al visitante (text) o añade una nota interna que solo ven los agentes (note: true).Edición gratuita
Guarda una respuesta guardada (Pro)Crea o modifica una respuesta guardada (título, atajo, cuerpo, departamento; id para modificar una).Edición Pro
Escribe un artículo de ayuda (Pro)Crea un artículo de la base de conocimiento o modifica uno (id): título, contenido, extracto, categorías y estado (borrador o publicar cuando puedas publicar).Edición Pro
Busca en la base de conocimiento (Pro)Encuentra artículos de ayuda para enlazar en una respuesta (q: la búsqueda).Edición Pro
Establece el departamento y las etiquetas de una conversación (Pro)Establece el departamento y las etiquetas de un chat o ticket (kind: chat o ticket; id).Edición Pro
Marcar preguntas sin responder (Pro)Marca las preguntas sin respuesta como abiertas, planificadas o descartadas (ids, status).Edición Pro
Configura tu disponibilidadMarca al agente que ha iniciado sesión como disponible o ausente para nuevos chats (away: true o false).Edición gratuita
Redacta una respuesta con IA (Pro)Crea un borrador de respuesta a un chat o ticket a partir del contenido del sitio; no se envía nada.Edición Pro
Resume una conversación con IA (Pro)Resume un chat o ticket en unas pocas líneas.Edición Pro
Aceptar un chatAsigna un chat en espera al agente que ha iniciado sesión, para que el visitante hable con una persona.Edición gratuita
Cambia los ajustes del chatCambia los ajustes que envías (ajustes: clave a valor) y conserva el resto. Cada valor se comprueba exactamente como en la pantalla de ajustes; get-settings lista las claves.Edición gratuita
Cambiar un ticketCambia el estado, la prioridad o el asignado de un ticket.Edición gratuita

Seguro por diseño

Cada acción comprueba el mismo permiso de WordPress que la propia pantalla del plugin, para la página o entrada exacta que afecta. Un suscriptor no puede conectarse de ninguna manera.

Las contraseñas de aplicación se pueden revocar en cualquier momento en Usuarios, Perfil, sin cambiar su contraseña habitual.

Desactive «Permitir agentes de IA (MCP)» y las acciones y la dirección de conexión desaparecerán del sitio.

Las páginas que modifica un agente conservan sus revisiones de WordPress, por lo que cualquier cambio se puede deshacer.

¿Aloja en Zinn Digital®?

Si Zinn Digital® aloja el sitio, nuestro propio servidor MCP puede realizar estas acciones por usted sin necesidad de una contraseña de aplicación: conecte su aplicación de IA al servidor MCP de Zinn Digital® y utilice wordpress_abilities_list y wordpress_ability_run.

El servidor MCP de Zinn Digital®