Comprender los ámbitos de lectura y escritura
Una conexión de red principal del sitio activada explícitamente también admite network:sites:read y network:sites:write. Los ámbitos MCP/contenido correspondientes, el derecho Unlimited actual, la política de escritura de red y la autorización de superadministrador siguen siendo obligatorios. Las concesiones existentes no obtienen estos ámbitos automáticamente. Consulta Gestionar páginas multisitio.
Los ámbitos indican qué se le permite intentar a un token de OAuth. Son la primera de las cuatro comprobaciones por las que pasa cada llamada.
Los ocho ámbitos
| Ámbito | Cubre |
|---|---|
mcp:read |
Listado y lectura a través del protocolo |
mcp:write |
Cualquier operación que cambie el estado |
wp:content:read |
Lectura de entradas, páginas, medios, taxonomías, comentarios, metadatos, opciones y menús |
wp:content:write |
Modificarlos |
pom_theme:read |
Lectura de ajustes, modelos de contenido y plantillas de POM Theme |
pom_theme:write |
Modificarlos |
woocommerce:catalog:read |
Lectura de productos, variaciones, atributos y cupones |
woocommerce:catalog:write |
Modificarlos |
Se presentan en pares de lectura y escritura en cuatro áreas. El par mcp: es transversal; los otros tres siguen los límites de cada producto.
Conexiones de cuenta
La pasarela de cuenta anuncia mcp:read, mcp:write, account:sites:read y account:sites:execute. El descubrimiento/la lectura requieren los dos ámbitos de lectura; la ejecución requiere mcp:read, mcp:write y account:sites:execute. Incluye account:sites:read para el flujo de inspección circundante. Cada destino debe disponer además de una concesión de sitio independiente. La licencia actual, esa concesión, el actor de WordPress y los candados de escritura locales siguen siendo la autoridad. El consentimiento de cuenta cubre los sitios web actuales y los que se incorporen posteriormente.
Las herramientas requieren varios a la vez
Una herramienta declara cada ámbito que necesita, y el token debe contenerlos todos.
Las operaciones de escritura declaran mcp:write y el ámbito de escritura de su área. Por ejemplo, wc_update_product requiere mcp:write y woocommerce:catalog:write; leer ese producto requiere mcp:read y woocommerce:catalog:read. El vaciado de POM Cache declara mcp:write sin ámbito de área.
WordPress MCP Adapter además requiere mcp:read para acceder al transporte. Incluye el ámbito de lectura del área cuando el flujo deba inspeccionar el estado actual antes de escribir o verificar el resultado después; no se concede implícitamente con el ámbito de escritura.
Cómo se conceden los ámbitos
En el registro, un cliente puede solicitar ámbitos. Si no pide ninguno, se registra con los ocho disponibles para solicitarlos más adelante.
En la autorización, el cliente pide un subconjunto y tú los ves en la pantalla de consentimiento. Omitir el parámetro hace que se recurra a los ámbitos registrados del cliente.
Las cadenas de ámbito desconocidas se descartan en lugar de provocar un error, de modo que un cliente que pida algo que no existe sencillamente no lo obtiene.
Las claves de API usan un usuario de servicio
Estas concesiones de ámbito por cliente se aplican a OAuth. Las llamadas con clave de API usan las capacidades del usuario de servicio configurado y pueden escribir cuando los candados obligatorios estén abiertos. No proporcionan ámbitos separados para cada cliente que comparte la clave. Consulta Usar una clave de API.
Los ámbitos no son permiso
Un token con todos los ámbitos sigue sin poder hacer algo que el usuario de WordPress que actúa no puede hacer, y sigue sin poder escribir mientras el candado de escritura correspondiente esté cerrado.
Piensa en los ámbitos como lo que el cliente tiene permitido pedir, en las capacidades como lo que el usuario tiene permitido hacer y en los candados como lo que el propietario del sitio ha activado. Consulta Modelo de seguridad de MCP.
Elegir qué aprobar
Aprueba el conjunto más reducido que permita realizar el trabajo.
| Tarea | Ámbitos razonables |
|---|---|
| Responder preguntas sobre el sitio | mcp:read, wp:content:read |
| Editar entradas y páginas | Añade mcp:write, wp:content:write |
| Mantenimiento del catálogo | Añade el par woocommerce:catalog:* |
| Plantillas y ajustes del tema | Añade el par pom_theme:* |
| Informes de solo lectura sobre todo | Los cuatro ámbitos de lectura, sin ámbitos de escritura |
Un token de solo lectura es una configuración permanente legítima y el valor predeterminado correcto para un asistente que todavía estás evaluando.
Ampliar más adelante
Los ámbitos son fijos durante toda la vida de un token. Para ampliarlos, el cliente repite el flujo de autorización y tú apruebas el conjunto más amplio; al renovar se conservan los ámbitos originales.
Eso es una ventaja: empieza con un alcance reducido y amplíalo deliberadamente cuando una tarea lo necesite.
Reducir lo que un token puede alcanzar
Tres formas, en gravedad creciente:
- Cierra el candado de escritura de esa área. Inmediato, reversible y afecta a todos los clientes.
- Reduce las capacidades del usuario que actúa.
- Restablece OAuth, revocando todos los clientes y tokens del sitio.
La primera suele ser la respuesta correcta a «este asistente está haciendo más de lo que esperaba».
Diagnosticar un error de ámbito
pom_ai_mcp_scope_denied significa que al token le falta un ámbito que la herramienta requiere. Comprueba, en orden:
- Qué ámbitos se aprobaron realmente: el registro de MCP deja constancia de la autorización.
- Si el acceso al transporte nativo necesita
mcp:read, o si una operación de lectura separada necesita el ámbito de lectura del área. - Si el cliente solicitó un conjunto más reducido del que suponías.
Si el token tiene los ámbitos, el rechazo procede de otra comprobación: un error de capacidad nombra la capacidad de WordPress, y un candado cerrado indica que el grupo de escritura está desactivado en los ajustes.