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
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 y VS Code
// .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"
}
}
}
}ChatGPT y otras aplicaciones
Cualquier aplicación que sea compatible con 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 directamente a la dirección de conexión con el mismo nombre de usuario y la misma contraseña de 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 (texto) o añade una nota interna (note: true); el estado cambia opcionalmente el estado del ticket. | Edición gratuita |
| Preguntar al asistente | Hace una pregunta al asistente de inteligencia artificial del sitio y devuelve su respuesta con cada fuente que ha encontrado. | Edición gratuita |
| Cambiar muchos tickets a la vez (Pro) | Cambia el estado, la prioridad o el asignado de hasta 100 tickets (identificadores). Cada ticket pasa por las mismas comprobaciones que al cambiarlo individualmente; el resultado enumera cada uno. | Edición Pro |
| Convierte un chat en un ticket | Abre un ticket desde 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 ticket | Elimina un ticket y su conversación de forma definitiva (solo para gestores). | Edición gratuita |
| Redactar un artículo de ayuda a partir de un ticket (Pro) | Redacta un borrador de artículo de la base de conocimientos a partir de un ticket resuelto; permanece como borrador hasta que una persona lo publica. | Edición Pro |
| Redactar artículos de ayuda para preguntas sin respuesta (Pro) | Escribe borradores de artículos para la base de conocimientos que responden a las preguntas seleccionadas (ids); estos permanecen como borradores. | Edición Pro |
| Rellenar una respuesta guardada (Pro) | Devuelve el texto de una respuesta guardada con sus marcadores de posición rellenados para un chat o un ticket. | Edición Pro |
| Leer un chat | Devuelve los mensajes de un chat y los detalles del visitante (after: solo los mensajes posteriores a este id). | Edición gratuita |
| Leer el resumen de soporte | Devuelve cuántos tickets hay en cada estado y 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 |
| Leer la configuración del chat | Devuelve todos los ajustes del chat: el widget, el asistente, las personas y el horario de apertura, 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 los números de chat y de ticket, los tiempos de respuesta y las valoraciones de los últimos N días (days). | Edición Pro |
| Leer un ticket | Devuelve un ticket con toda su conversación, estado, prioridad y persona asignada. | Edición gratuita |
| Devolver una conversación al asistente | Devuelve una charla al asistente de inteligencia artificial, que responde al visitante a partir del contenido del sitio. | Edición gratuita |
| Mostrar respuestas guardadas (Pro) | Muestra las respuestas guardadas que los agentes pueden insertar, junto con sus atajos. | Edición Pro |
| Listar chats en vivo | Muestra las listas de chats en espera, en curso y cerrados recientemente, indicando quién gestiona cada uno. | Edición gratuita |
| Enumerar lo que el asistente sabe | Muestra el contenido que utiliza el asistente para responder, con su estado de indexación, página por página. | Edición gratuita |
| Listar preguntas sin responder (Pro) | Muestra las preguntas hechas por los visitantes que la base de conocimientos no pudo responder. | Edición Pro |
| Listar tickets | Lista los tickets de soporte, filtrados por estado o por una búsqueda, página por página. | 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 para administradores). | Edición gratuita |
| Releer el contenido en el asistente | Relee un elemento (item_id) o todo (all: true) en el índice del asistente (solo para administradores). | Edición gratuita |
| Responder en un chat | Envía un mensaje al visitante (text) o añade una nota interna que solo los agentes ven (note: true). | Edición gratuita |
| Guardar una respuesta guardada (Pro) | Crea o modifica una respuesta guardada (título, atajo, cuerpo, departamento; id para modificar una). | Edición Pro |
| Escribir 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 |
| Buscar en la base de conocimientos (Pro) | Busca artículos de ayuda para enlazar en una respuesta (q: la búsqueda). | Edición Pro |
| Establecer el departamento y las etiquetas de una conversación (Pro) | Establece el departamento y las etiquetas de un chat o ticket (tipo: chat o ticket; id). | Edición Pro |
| Marcar preguntas sin responder (Pro) | Marca las preguntas sin respuesta como abiertas, planificadas o descartadas (identificadores, estado). | Edición Pro |
| Establecer su disponibilidad | Marca al agente conectado como disponible o ausente para nuevos chats (ausente: true o false). | Edición gratuita |
| Redactar una respuesta con IA (Pro) | Redacta una respuesta a un chat o ticket a partir del contenido del sitio; no se envía nada. | Edición Pro |
| Resumir una conversación con IA (Pro) | Resume un chat o ticket en pocas líneas. | Edición Pro |
| Iniciar un chat | Asigna un chat en espera al agente conectado, para que el visitante hable con una persona. | Edición gratuita |
| Cambiar la configuración del chat | Modifica la configuración que envías (configuración: clave a valor) y conserva el resto. Cada valor se comprueba exactamente igual que en la pantalla de configuración; get-settings enumera las claves. | Edición gratuita |
| Modificar un ticket | Cambia el estado, la prioridad o el responsable 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.