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
Configúrelo en tres pasos
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.
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.
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@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 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ón | Qué hace | Edición |
|---|---|---|
| Responder a un ticket | Responde 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 asistente | Hace 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 ticket | Abre 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 chat | Finaliza un chat; el visitante aún puede solicitar la transcripción. | Edición gratuita |
| Abrir un ticket | Abre 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 ticket | Elimina 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 chat | Devuelve los mensajes de un chat y los detalles del visitante (after: solo mensajes posteriores a este id). | Edición gratuita |
| Lee el resumen de soporte | Devuelve 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 chat | Devuelve 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 ticket | Devuelve un ticket con toda su conversación, estado, prioridad y persona asignada. | Edición gratuita |
| Devuelve el chat al asistente | Devuelve 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 vivo | Muestra 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 sabe | Muestra 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 tickets | Muestra 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 asistente | Reconstruye 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 asistente | Vuelve a leer un elemento (item_id) o todo (all: true) en el índice del asistente (solo para administradores). | Edición gratuita |
| Responder en el chat | Enví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 disponibilidad | Marca 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 chat | Asigna 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 chat | Cambia 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 ticket | Cambia 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.