{"id":81434,"date":"2026-07-14T12:09:43","date_gmt":"2026-07-14T16:09:43","guid":{"rendered":"https:\/\/memberpress.com\/docs\/mcp-errors-troubleshooting\/"},"modified":"2026-07-21T04:52:40","modified_gmt":"2026-07-21T08:52:40","slug":"mcp-errors-troubleshooting","status":"publish","type":"ht_kb","link":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/","title":{"rendered":"Errores y resoluci\u00f3n de problemas del MCP MemberPress"},"content":{"rendered":"<p>El servidor MCP de MemberPress AI Foundation devuelve errores estructurados cuando una solicitud no supera la autenticaci\u00f3n, supera un l\u00edmite de frecuencia, carece de \u00e1mbito o capacidad, o se recibe mientras las escrituras destructivas est\u00e1n en pausa. Cada error incluye un c\u00f3digo que un cliente de IA o un desarrollador puede identificar.<\/p>\n\n\n\n<p>Esta gu\u00eda recoge los c\u00f3digos de error que genera el servidor MCP, indica qu\u00e9 provoca cada uno de ellos y explica c\u00f3mo solucionarlos. La secci\u00f3n dedicada a la resoluci\u00f3n de problemas aborda los fallos que suelen producirse con mayor frecuencia durante la configuraci\u00f3n inicial.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"error-response-shape\"><a href=\"#error-response-shape\">Forma de la respuesta de error<\/a><\/h2>\n\n\n\n<p>El servidor devuelve errores en dos niveles, y estos tienen formas diferentes. Es fundamental identificar el campo correcto para gestionar los errores de forma fiable.<\/p>\n\n\n\n<p><strong>Errores en la capa de transporte<\/strong> se rechazan antes del procesamiento de JSON-RPC: errores de autenticaci\u00f3n y rutas desmontadas. Utilizan el formato de error REST de WordPress, con una cadena <code>c\u00f3digo<\/code> y un estado HTTP en <code>data.status<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": \"auth_required\",\n  \"message\": \"Se requiere el encabezado de autorizaci\u00f3n.\",\n  \"data\": { \"status\": 401 }\n}<\/code><\/pre>\n\n\n\n<p><strong>Errores en la capa de herramientas<\/strong> se producen tras la autenticaci\u00f3n, durante el env\u00edo de herramientas: la capa de seguridad y los controles de capacidad. Utilizan el formato de error JSON-RPC 2.0, en el que <code>c\u00f3digo<\/code> es el valor gen\u00e9rico de JSON-RPC <code>-32603<\/code> y el identificador estable y combinable es <strong><code>data.mp_error_code<\/code><\/strong>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"Las escrituras destructivas han sido suspendidas por un administrador. Int\u00e9ntalo de nuevo m\u00e1s tarde o ponte en contacto con el propietario del sitio.\",\n  \"data\": { \"mp_error_code\": \"WRITES_PAUSED\" },\n  \"request_id\": \"req_011Cc7Bhv5NZnRMgQ9Bg2JBo\"\n}<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Partido en <code>data.mp_error_code<\/code>, no <code>c\u00f3digo<\/code>.<\/strong> Cada error de la capa de herramientas devuelve lo mismo <code>-32603<\/code>; solo <code>mp_error_code<\/code> es lo que los distingue. El <code>request_id<\/code> Es \u00fanico por llamada; resulta \u00fatil para la asistencia t\u00e9cnica, pero nunca para la comparaci\u00f3n.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"error-categories-at-a-glance\"><a href=\"#error-categories-at-a-glance\">Resumen de las categor\u00edas de errores<\/a><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Categor\u00eda<\/th><th>Identificador<\/th><th>Capa<\/th><\/tr><\/thead><tbody><tr><td>Autenticaci\u00f3n<\/td><td><code>auth_required<\/code> y errores de tokens<\/td><td>Transporte (<code>data.status: 401<\/code>)<\/td><\/tr><tr><td>Ruta desactivada o enlaces permanentes<\/td><td><code>rest_sin_ruta<\/code><\/td><td>Transporte (<code>data.status: 404<\/code>)<\/td><\/tr><tr><td>\u00c1mbito de aplicaci\u00f3n y capacidades<\/td><td><code>SCOPE_INSUFFICIENT<\/code>, <code>CAPACIDAD_INSUFICIENTE<\/code><\/td><td>Herramienta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Capa de seguridad<\/td><td><code>ESCRITURA_EN_PAUSA<\/code>, <code>CONFIRMACI\u00d3N_NO V\u00c1LIDA<\/code><\/td><td>Herramienta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Limitaci\u00f3n de velocidad<\/td><td><code>RATE_LIMITED<\/code>, p\u00fablico, inscripci\u00f3n<\/td><td>Varios \u2014 v\u00e9ase \u00abErrores de l\u00edmite de solicitudes\u00bb<\/td><\/tr><tr><td>Validaci\u00f3n<\/td><td><code>error de validaci\u00f3n<\/code><\/td><td>Herramienta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Recursos y situaci\u00f3n<\/td><td><code>usuario_no_encontrado<\/code>, <code>nombre_de_usuario_duplicado<\/code>, <code>ya_reembolsado<\/code>El <code>*_no_encontrado_*<\/code> familia<\/td><td>Herramienta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Agradecimientos<\/td><td><code>cr\u00e9ditos insuficientes<\/code>, <code>cr\u00e9ditos_no_disponibles<\/code><\/td><td>No se puede acceder a trav\u00e9s de las herramientas de MCP \u2014 v\u00e9ase m\u00e1s abajo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"authentication-errors\"><a href=\"#authentication-errors\">Errores de autenticaci\u00f3n<\/a><\/h2>\n\n\n\n<p>El servidor comprueba las credenciales en cada solicitud. Todas las rutas principales de MCP requieren un token \u00abBearer\u00bb o autenticaci\u00f3n \u00abBasic\u00bb.<\/p>\n\n\n\n<p>Una solicitud con <strong>No hay encabezado \u00abAuthorization\u00bb<\/strong> se rechaza en la capa de transporte:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": \"auth_required\",\n  \"message\": \"Se requiere el encabezado de autorizaci\u00f3n.\",\n  \"data\": { \"status\": 401 }\n}<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Disparador<\/th><th>C\u00f3digo<\/th><th>Mensaje<\/th><\/tr><\/thead><tbody><tr><td>Sin credenciales<\/td><td><code>auth_required<\/code><\/td><td>\u201cSe requiere un encabezado de autorizaci\u00f3n\u201d.\u201d<\/td><\/tr><tr><td>Encabezado con formato incorrecto (no es \u00abBearer\u00bb ni \u00abBasic\u00bb)<\/td><td><code>auth_required<\/code><\/td><td>\u201cSe requiere autenticaci\u00f3n de portador o b\u00e1sica\u201d.\u201d<\/td><\/tr><tr><td>Token caducado<\/td><td><code>token_caducado<\/code><\/td><td>\u201cEl token ha caducado\u201d.\u201d<\/td><\/tr><tr><td>Token revocado o inexistente<\/td><td><code>auth_required<\/code><\/td><td>\u201cToken no v\u00e1lido o revocado\u201d.\u201d<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Un token caducado devuelve un c\u00f3digo distinto. Un token revocado y un token que nunca ha existido son <strong>deliberadamente indistinguibles<\/strong> \u2014 Los filtros de b\u00fasqueda de tokens excluyen las filas revocadas, por lo que la respuesta no revela si un token concreto ha existido alguna vez.<\/p>\n\n\n\n<p><code>401<\/code> Las respuestas en la ruta MCP conllevan un <code>WWW-Authenticate<\/code> encabezado con el valor exacto <code>Portador realm=\"mcp\", resource_metadata=\"\"<\/code>, y el encabezado se expone a trav\u00e9s de CORS. Los puntos finales de OAuth lo omiten deliberadamente.<\/p>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> Genera un nuevo token mediante el asistente o vuelve a conectar el cliente para ejecutar de nuevo el flujo de OAuth. Comprueba que el token no haya sido revocado en el <strong>Clientes conectados a MCP<\/strong> ficha.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"scope-and-capability-errors\"><a href=\"#scope-and-capability-errors\">Errores de alcance y capacidad<\/a><\/h2>\n\n\n\n<p>Hay dos puertas de control distintas que rechazan una llamada a una herramienta tras una autenticaci\u00f3n correcta. Ambas se manifiestan como errores de la capa de herramientas.<\/p>\n\n\n\n<p><strong>Puerta de alcance.<\/strong> Cada herramienta declara un \u00e1mbito de acceso necesario. El servidor lo compara con los \u00e1mbitos de acceso concedidos al token antes de la ejecuci\u00f3n. Una conexi\u00f3n de solo lectura que invoca <code>memberpress_create_member<\/code> no supera esta prueba.<\/p>\n\n\n\n<p><strong>Puerta de capacidad.<\/strong> Cada herramienta de escritura tambi\u00e9n declara la capacidad de WordPress que necesita; por ejemplo, <code>create_users<\/code>, <code>editar_usuarios<\/code>, <code>eliminar_usuarios<\/code>o <code>gestionar_opciones<\/code>. El servidor comprueba la capacidad del propietario del token antes de la distribuci\u00f3n. Un <code>completo<\/code>-token de \u00e1mbito propiedad de un usuario sin <code>create_users<\/code> Sigo sin poder crear miembros.<\/p>\n\n\n\n<p>Las puertas se ejecutan en orden \u2014primero \u00abscope\u00bb\u2014 y devuelven <strong>c\u00f3digos distintos<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Puerta<\/th><th><code>mp_error_code<\/code><\/th><th>Mensaje<\/th><\/tr><\/thead><tbody><tr><td>Alcance<\/td><td><code>SCOPE_INSUFFICIENT<\/code><\/td><td><code>El \u00e1mbito \"%s\" no est\u00e1 concedido en este token.<\/code><\/td><\/tr><tr><td>Capacidad<\/td><td><code>CAPACIDAD_INSUFICIENTE<\/code><\/td><td><code>Capacidad insuficiente para esta herramienta. El usuario debe disponer de \"%s\".<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Ambos utilizan la envolvente de la capa de herramientas \u2014 <code>-32603<\/code> con el identificador de la cuadra en <code>data.mp_error_code<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"Capacidad insuficiente para esta herramienta. El usuario debe tener el permiso \\\"create_users\\\".\",\n  \"data\": { \"mp_error_code\": \"CAPABILITY_INSUFFICIENT\" },\n  \"request_id\": \"req_...\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Fallos del visor:<\/strong> La conexi\u00f3n requiere una autorizaci\u00f3n m\u00e1s amplia. Rev\u00f3cala y crea una nueva conexi\u00f3n con los \u00e1mbitos de escritura necesarios. El nivel m\u00e1ximo de acceso debe ser \u00abAcceso completo\u00bb para que las nuevas conexiones puedan recibir \u00e1mbitos de escritura;<\/li>\n\n\n\n<li><strong>Fallos de capacidad:<\/strong> El usuario de WordPress asociado al token no dispone de la capacidad de rol necesaria. Inicia sesi\u00f3n como un usuario que tenga esa capacidad o conc\u00e9desela a ese usuario.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\"><strong>Importante:<\/strong> Las conexiones con contrase\u00f1a de aplicaci\u00f3n son siempre de solo lectura. Por dise\u00f1o, todas las herramientas de escritura fallan en la comprobaci\u00f3n de \u00e1mbito en una conexi\u00f3n con contrase\u00f1a de aplicaci\u00f3n. Utiliza una conexi\u00f3n OAuth para las operaciones de escritura.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"safety-layer-errors\"><a href=\"#safety-layer-errors\">Errores de la capa de seguridad<\/a><\/h2>\n\n\n\n<p>Las medidas de seguridad de los agentes generan sus propios errores en la capa de herramientas. El <strong><a href=\"https:\/\/memberpress.com\/es\/docs\/ai-foundation-safety-measures\/\" target=\"_blank\" rel=\"noopener\">Referencia sobre medidas de seguridad para agentes<\/a><\/strong> explica las medidas; en esta secci\u00f3n se recogen sus rechazos.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"writespaused\"><a href=\"#writespaused\">ESCRITURA_EN_PAUSA<\/a><\/h3>\n\n\n\n<p>El \u00abkill switch\u00bb detiene temporalmente cualquier escritura destructiva. Mientras est\u00e1 activo, el servidor rechaza las herramientas destructivas con <code>ESCRITURA_EN_PAUSA<\/code> \u2014 independientemente de los \u00e1mbitos de la conexi\u00f3n e incluso cuando la llamada incluya un token de confirmaci\u00f3n v\u00e1lido.<\/p>\n\n\n\n<p>Los disparos de rechazo contra el <strong>primera llamada sin compromiso<\/strong>: la *vista previa* de una herramienta destructiva queda bloqueada, no solo su ejecuci\u00f3n. El \u00abkill switch\u00bb bloquea toda la ruta de escritura destructiva, por lo que un estado en pausa ni siquiera puede generar un token de confirmaci\u00f3n. Las herramientas de lectura siguen funcionando.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"Las escrituras destructivas han sido suspendidas por un administrador. Int\u00e9ntalo de nuevo m\u00e1s tarde o ponte en contacto con el propietario del sitio.\",\n  \"data\": { \"mp_error_code\": \"WRITES_PAUSED\" },\n  \"request_id\": \"req_011Cc7Bhv5NZnRMgQ9Bg2JBo\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> un administrador desactiva el \u00abkill switch\u00bb desde el <strong>Clientes conectados a MCP<\/strong> pesta\u00f1a. La pausa es una medida administrativa deliberada; comprueba por qu\u00e9 se ha activado antes de reanudar las operaciones de escritura.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"confirmationinvalid\"><a href=\"#confirmationinvalid\">CONFIRMACI\u00d3N_NO V\u00c1LIDA<\/a><\/h3>\n\n\n\n<p>Las herramientas destructivas requieren un flujo de dos llamadas: la primera llamada devuelve una vista previa y un token de confirmaci\u00f3n de un solo uso; la segunda llamada pasa el token en el <code>confirmar<\/code> par\u00e1metro. <strong>Tres causas distintas dan el mismo resultado <code>CONFIRMACI\u00d3N_NO V\u00c1LIDA<\/code> error<\/strong> \u2014 El mensaje no aclara qu\u00e9 de las dos cosas ocurri\u00f3:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Causa<\/th><th>Detalle<\/th><\/tr><\/thead><tbody><tr><td>El token ha caducado<\/td><td>El token tiene una antig\u00fcedad superior a los 60 segundos de su ventana de validez<\/td><\/tr><tr><td>El token ya se ha utilizado<\/td><td>Los vales son de un solo uso<\/td><\/tr><tr><td>Los argumentos han cambiado<\/td><td>El token se vincula a la herramienta, los argumentos y el usuario concretos<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"El token de confirmaci\u00f3n no es v\u00e1lido, ha caducado o los argumentos han cambiado. Llama a la herramienta sin `confirm` para obtener una vista previa y un token nuevos.\",\n  \"data\": { \"mp_error_code\": \"CONFIRMATION_INVALID\" },\n  \"request_id\": \"req_011Cc7AK3jF4SA4VLs3qsmBD\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> vuelve a ejecutar la herramienta sin <code>confirmar<\/code> para obtener una vista previa y un token nuevos, y a continuaci\u00f3n confirmar en un plazo de 60 segundos utilizando los mismos argumentos. Dado que un c\u00f3digo abarca tres causas, un cliente que est\u00e9 resolviendo un problema deber\u00eda volver a ejecutar la vista previa en lugar de intentar diagnosticar qu\u00e9 protecci\u00f3n se ha activado.<\/p>\n\n\n\n<p>El fallo es intencionado. Una simple respuesta de \u00abaprobado\/suspendido\u00bb no revela si un token concreto lleg\u00f3 a existir, y la soluci\u00f3n es la misma en todos los casos: volver a ejecutar la vista previa.<\/p>\n\n\n\n<p>La respuesta es <code>error.data<\/code> tiene un <code>raz\u00f3n<\/code> campo junto al c\u00f3digo de nivel superior, que no ha sufrido cambios, con dos valores: <code>caducado_o_utilizado<\/code> (el token no se ha encontrado \u2014caducado, ya utilizado o que nunca se ha emitido\u2014 y permanece ocultado de forma deliberada) y <code>arguments_changed<\/code> (El token era v\u00e1lido, pero la solicitud no se correspond\u00eda con lo que se hab\u00eda previsualizado; vuelve a ejecutar la previsualizaci\u00f3n y confirma el nuevo token).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"rate-limit-errors\"><a href=\"#rate-limit-errors\">Errores de l\u00edmite de solicitudes<\/a><\/h2>\n\n\n\n<p>Los l\u00edmites de velocidad independientes protegen el servidor, y <strong>la forma de la respuesta var\u00eda seg\u00fan el punto final<\/strong> \u2014 el punto final MCP autenticado no devuelve <code>429<\/code> en absoluto.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Superficie<\/th><th>L\u00edmite<\/th><th>Respuesta<\/th><\/tr><\/thead><tbody><tr><td>Punto final MCP autenticado<\/td><td>120 solicitudes por minuto por token (valor predeterminado; configurable entre 1 y 1000): se configura en la pesta\u00f1a \u00abConfiguraci\u00f3n de MCP\u00bb, donde tambi\u00e9n se puede desactivar por completo la limitaci\u00f3n de velocidad.<\/td><td>Error de JSON-RPC en HTTP <strong>200<\/strong> \u2014 c\u00f3digo <code>-32029<\/code>, <code>mp_error_code: RATE_LIMITED<\/code><\/td><\/tr><tr><td>Punto final p\u00fablico de MCP<\/td><td>60 solicitudes por minuto por direcci\u00f3n IP (fijo)<\/td><td>HTTP <strong>429<\/strong> con <code>Retry-After: 60<\/code><\/td><\/tr><tr><td>OAuth <code>\/registrarse<\/code><\/td><td>60 registros por hora por direcci\u00f3n IP<\/td><td>HTTP <strong>429<\/strong> con <code>Retry-After: 3600<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>El l\u00edmite del punto final autenticado aparece dentro de la envoltura JSON-RPC, no como un error HTTP:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"jsonrpc\":\"2.0\",\"id\":1,\"error\":{\"code\":-32029,\"message\":\"Se ha superado el l\u00edmite de solicitudes.\",\"data\":{\"mp_error_code\":\"RATE_LIMITED\"}}}<\/code><\/pre>\n\n\n\n<p>El punto final p\u00fablico devuelve un cuerpo de error JSON-RPC sin formato con su <code>429<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"jsonrpc\":\"2.0\",\"error\":{\"code\":-32000,\"message\":\"Se ha superado el l\u00edmite de solicitudes. Int\u00e9ntalo de nuevo dentro de un minuto.\"}}<\/code><\/pre>\n\n\n\n<p>El punto final de registro devuelve un cuerpo de tipo OAuth con su <code>429<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"error\":\"too_many_requests\",\"error_description\":\"Demasiados registros de clientes desde esta IP. Int\u00e9ntalo de nuevo dentro de una hora.\"}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\"><strong>Nota:<\/strong> No se env\u00edan mensajes desde ning\u00fan punto final <code>X-RateLimit-Limit<\/code> o <code>X-L\u00edmite de velocidad restante<\/code> encabezados. Los \u00fanicos encabezados de limitaci\u00f3n de velocidad son los <code>Retry-After<\/code> los valores que se indican m\u00e1s arriba.<\/p>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> Espera a que se reinicie la ventana. Para el punto final autenticado, busca coincidencias en <code>mp_error_code: RATE_LIMITED<\/code> \u2014 a <code>200<\/code> El estatus no es sin\u00f3nimo de \u00e9xito \u2014 y mant\u00e9n la distancia al menos un minuto. Respeto <code>Retry-After<\/code> d\u00f3nde se env\u00eda. Para mantener un volumen leg\u00edtimo constante, realiza solicitudes por lotes o reduce la frecuencia de consulta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"validation-errors\"><a href=\"#validation-errors\">Errores de validaci\u00f3n<\/a><\/h2>\n\n\n\n<p>Los errores de validaci\u00f3n son errores de la capa de herramientas: <strong><code>-32603<\/code><\/strong> con <strong><code>mp_error_code: error_de_validaci\u00f3n<\/code><\/strong>. En <strong><code>mensaje<\/code><\/strong> Esto explica por s\u00ed mismo el problema: indica el valor rechazado y, cuando hay un vocabulario aplicable, enumera los valores aceptados. Por ejemplo, al crear un webhook con un evento desconocido, se obtiene el siguiente resultado:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Eventos desconocidos: \u00abmember-added\u00bb. Eventos conocidos: \u00abtransaction-completed\u00bb, ...<\/code><\/pre>\n\n\n\n<p>Las herramientas de escritura validan los vocabularios de argumentos seg\u00fan sus esquemas, y los valores heredados se rechazan si no se ajustan a la enumeraci\u00f3n aceptada. Las herramientas de cupones son el ejemplo documentado: <code>modo_descuento<\/code> acepta <code>est\u00e1ndar<\/code> o <code>primer pago<\/code>y <code>tipo_descuento<\/code> acepta <code>por ciento<\/code> o <code>d\u00f3lar<\/code>. Los valores heredados <code>primero<\/code>, <code>todos<\/code>y <code>plano<\/code> se rechazan.<\/p>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> corrige la entrada tal y como se indica en el mensaje, o consulta la documentaci\u00f3n de la herramienta <code>esquema de entrada<\/code> en <code>herramientas\/lista<\/code> \u2014 y, a continuaci\u00f3n, vuelve a enviarla con los valores can\u00f3nicos. No vuelvas a intentar enviar los mismos argumentos.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"resource-and-state-errors\"><a href=\"#resource-and-state-errors\">Errores de recursos y de estado<\/a><\/h2>\n\n\n\n<p>M\u00e1s all\u00e1 de la validaci\u00f3n, las herramientas devuelven c\u00f3digos destinados al usuario cuando una solicitud est\u00e1 bien formada, pero no se puede aplicar al estado actual del sitio. Estos siguen el mismo formato de la capa de la herramienta (<strong><code>-32603<\/code><\/strong> + <strong><code>mp_error_code<\/code><\/strong>), y en sus mensajes se explica directamente el motivo:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>C\u00f3digo<\/th><th>Disparador<\/th><\/tr><\/thead><tbody><tr><td><code>usuario_no_encontrado<\/code><\/td><td>El miembro o usuario al que se hace referencia no existe.<\/td><\/tr><tr><td><code>*_no_encontrado_*<\/code> familia<\/td><td>El recurso al que se hace referencia (transacci\u00f3n, suscripci\u00f3n, webhook, etc.) no existe.<\/td><\/tr><tr><td><code>nombre_de_usuario_duplicado<\/code><\/td><td>Creaci\u00f3n de un usuario con un nombre de usuario ya en uso<\/td><\/tr><tr><td><code>ya_reembolsado<\/code><\/td><td>Se ha intentado realizar un reembolso de una transacci\u00f3n que ya hab\u00eda sido reembolsada<\/td><\/tr><tr><td><code>memberpress_not_active<\/code><\/td><td>El complemento MemberPress no est\u00e1 activo<\/td><\/tr><tr><td><code>autoeliminaci\u00f3n rechazada<\/code><\/td><td><code>eliminar_miembro<\/code> dirigido al usuario que realiza la llamada: eliminar la cuenta asociada al token actual pondr\u00eda fin a la sesi\u00f3n. La comprobaci\u00f3n autom\u00e1tica se ejecuta primero, por lo que tiene prioridad sobre el control de acceso de administrador.<\/td><\/tr><tr><td><code>admin_delete_rechazado<\/code><\/td><td><code>eliminar_miembro<\/code> dirigirse a cualquier usuario con el <code>gestionar_opciones<\/code> capacidad. Si la eliminaci\u00f3n es intencionada, retira primero los privilegios al usuario en el panel de administraci\u00f3n de WordPress.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Resoluci\u00f3n:<\/strong> Se trata de condiciones del estado del sistema, no de fallos pasajeros: comprueba el recurso al que se hace referencia (o el estado del sitio) y corrige la solicitud. Volver a intentarlo sin realizar cambios no dar\u00e1 resultado.<\/p>\n\n\n\n<p>Fallos verdaderamente internos \u2014 <strong><code>error_al_guardar<\/code><\/strong>, <strong><code>eliminaci\u00f3n fallida<\/code><\/strong>, <strong><code>db_error<\/code><\/strong> \u2014 est\u00e1n concebidos para ser gen\u00e9ricos, de modo que los detalles de la capa de almacenamiento no se revelen a los clientes. Un cliente que reciba uno de estos mensajes solo puede volver a intentarlo m\u00e1s tarde o informar del fallo al administrador del sitio.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"credit-errors-not-reachable-through-mcp\"><a href=\"#credit-errors-not-reachable-through-mcp\">Errores de cr\u00e9dito: no se puede acceder a ellos a trav\u00e9s de MCP<\/a><\/h2>\n\n\n\n<p>Las llamadas de vista previa pasan por la misma lista de permitidos que la ejecuci\u00f3n en producci\u00f3n y tienen las mismas <code>mp_error_code<\/code> \u2014 Una herramienta no puede revelar en su vista previa un error interno que la ejecuci\u00f3n en tiempo real ocultar\u00eda.<\/p>\n\n\n\n<p>La lista de excepciones de errores del servidor incluye dos c\u00f3digos relacionados con el cr\u00e9dito: <code>cr\u00e9ditos insuficientes<\/code> y <code>cr\u00e9ditos_no_disponibles<\/code>. Ninguna herramienta del MCP consume cr\u00e9ditos de IA, y el servidor del MCP no invoca ning\u00fan m\u00e9todo relacionado con los cr\u00e9ditos. Los c\u00f3digos existen para que los servicios posteriores puedan transmitir los errores relacionados con los cr\u00e9ditos a trav\u00e9s de la respuesta JSON-RPC; ninguna ruta de llamada de las herramientas del MCP los genera.<\/p>\n\n\n\n<p>Un cliente que utilice las herramientas de MCP nunca se encuentra con estos c\u00f3digos. Los saldos acreedores afectan a las funciones de generaci\u00f3n basadas en Mastermind (por ejemplo, Course Copilot), pero no a las llamadas a las herramientas de MCP.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"troubleshooting-setup-failures\"><a href=\"#troubleshooting-setup-failures\">Soluci\u00f3n de problemas relacionados con fallos en la configuraci\u00f3n<\/a><\/h2>\n\n\n\n<p>Modos de fallo que se producen durante la conexi\u00f3n inicial, en el orden en que los usuarios suelen encontrarlos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>El punto final MCP autenticado devuelve <code>404<\/code>:<\/strong> Los enlaces permanentes est\u00e1n configurados como \u00abPlain\u00bb. La API REST requiere enlaces permanentes con el nombre de la entrada o m\u00e1s detallados;<\/li>\n\n\n\n<li><strong>El punto final p\u00fablico de MCP devuelve <code>404<\/code> (<code>rest_sin_ruta<\/code>):<\/strong> El cat\u00e1logo p\u00fablico est\u00e1 desactivado. Cuando est\u00e1 desactivado, la ruta no se monta, por lo que cualquier solicitud devuelve <code>rest_sin_ruta<\/code> \u2014 No se revela la existencia del punto final. Habilita el cat\u00e1logo en el <strong>Configuraci\u00f3n de MCP<\/strong> ficha;<\/li>\n\n\n\n<li><strong>El punto final devuelve <code>401<\/code> (<code>auth_required<\/code>) en un navegador:<\/strong> comportamiento esperado. El <code>401<\/code> confirma que el punto final est\u00e1 activo; el navegador no incluye ning\u00fan encabezado de autorizaci\u00f3n;<\/li>\n\n\n\n<li><strong>Claude Desktop muestra el conector, pero no las herramientas:<\/strong> La autorizaci\u00f3n de OAuth no se ha completado o se ha revocado la conexi\u00f3n. Abre el conector y vuelve a conectarte;<\/li>\n\n\n\n<li><strong><code>paso=error_inicial<\/code> Durante la conexi\u00f3n a Claude Desktop:<\/strong> El registro mediante OAuth tiene un l\u00edmite de 60 intentos por hora por direcci\u00f3n IP. Espera a que se reinicie el contador y vuelve a intentarlo;<\/li>\n\n\n\n<li><strong>Un cliente externo no puede registrarse mediante OAuth (<code>uri_de_redirecci\u00f3n_no_v\u00e1lida<\/code>):<\/strong> El punto final de registro din\u00e1mico solo acepta URI de redirecci\u00f3n incluidas en la lista de permitidos (los clientes de IA conocidos). Un cliente cuya URI de redirecci\u00f3n no figure en la lista de permitidos es rechazado en <code>\/registrarse<\/code>;<\/li>\n\n\n\n<li><strong>Falta una herramienta que se esperaba encontrar en <code>herramientas\/lista<\/code>:<\/strong> La herramienta pertenece a un complemento inactivo. Las herramientas de los complementos solo se registran mientras el complemento correspondiente est\u00e1 activo. Al llamar a una herramienta no registrada, se devuelve el error est\u00e1ndar de JSON-RPC \u00abm\u00e9todo desconocido\u00bb;<\/li>\n\n\n\n<li><strong>Casillas de selecci\u00f3n que faltan en el asistente:<\/strong> El l\u00edmite de acceso est\u00e1 establecido en \u00abSolo lectura\u00bb. El asistente oculta los \u00e1mbitos de escritura y muestra un aviso. Aumenta el l\u00edmite en el <strong>Configuraci\u00f3n de MCP<\/strong> ficha;<\/li>\n\n\n\n<li><strong>Una herramienta destructiva muestra una vista previa en lugar de ejecutarse:<\/strong> Comportamiento esperado. Las herramientas destructivas requieren el flujo de confirmaci\u00f3n de dos llamadas. Pasa el token devuelto en el <code>confirmar<\/code> par\u00e1metro en un plazo de 60 segundos.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"error-handling-guidance\"><a href=\"#error-handling-guidance\">Orientaciones sobre la gesti\u00f3n de errores<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Partido en <code>data.mp_error_code<\/code><\/strong> en cuanto a errores en la capa de herramientas, y en <code>c\u00f3digo<\/code> y <code>data.status<\/code> por errores en la capa de transporte. Nunca realices la coincidencia sobre el <code>-32603<\/code>;<\/li>\n\n\n\n<li><strong><code>auth_required<\/code> \/ <code>401<\/code>:<\/strong> Vuelve a iniciar sesi\u00f3n. No vuelvas a intentarlo con las mismas credenciales; los fallos repetidos activan el bloqueo por ataque de fuerza bruta;<\/li>\n\n\n\n<li><strong><code>SCOPE_INSUFFICIENT<\/code> \/ <code>CAPACIDAD_INSUFICIENTE<\/code>:<\/strong> No volver a intentarlo. La conexi\u00f3n requiere una autorizaci\u00f3n de mayor alcance, o bien el usuario asociado al token carece de la capacidad de WordPress necesaria; un nuevo intento no dar\u00e1 resultado;<\/li>\n\n\n\n<li><strong><code>ESCRITURA_EN_PAUSA<\/code>:<\/strong> No volver a intentarlo autom\u00e1ticamente. Un administrador ha suspendido deliberadamente las operaciones de escritura destructivas; mostrar el estado al usuario;<\/li>\n\n\n\n<li><strong><code>error de validaci\u00f3n<\/code>:<\/strong> corrige la entrada tal y como se indica en el mensaje y, a continuaci\u00f3n, vuelve a enviarla. No vuelvas a intentar con los mismos argumentos: la misma entrada da lugar al mismo rechazo;<\/li>\n\n\n\n<li><strong><code>CONFIRMACI\u00d3N_NO V\u00c1LIDA<\/code>:<\/strong> Reinicia el flujo de dos llamadas desde la llamada de vista previa. Un c\u00f3digo abarca tres causas, as\u00ed que vuelve a ejecutar la vista previa en lugar de intentar determinar cu\u00e1l se ha activado. Nunca almacenes en cach\u00e9 los tokens de confirmaci\u00f3n;<\/li>\n\n\n\n<li><strong>L\u00edmites de frecuencia:<\/strong> Ret\u00edrate. El punto final autenticado indica <code>RATE_LIMITED<\/code> dentro de un HTTP <code>200<\/code>; los puntos finales p\u00fablicos y de registro devuelven <code>429<\/code> con <code>Retry-After<\/code>. Respeto <code>Retry-After<\/code> si se ha enviado; de lo contrario, espera al menos un minuto.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"related-documentation\"><a href=\"#related-documentation\">Documentaci\u00f3n relacionada<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"https:\/\/memberpress.com\/es\/docs\/ai-foundation-overview\/\" target=\"_blank\" rel=\"noopener\">Gu\u00eda general y de configuraci\u00f3n de MemberPress AI Foundation<\/a><\/strong> \u2014 instalaci\u00f3n, requisitos previos y comprobaciones tras la instalaci\u00f3n;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/es\/docs\/connecting-ai-clients\/\" target=\"_blank\" rel=\"noopener\">Conexi\u00f3n de clientes de IA a MemberPress \u2013 Referencia para desarrolladores<\/a><\/strong> \u2014 m\u00e9todos de autenticaci\u00f3n y configuraci\u00f3n por cliente;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/es\/docs\/mcp-tools-reference\/\" target=\"_blank\" rel=\"noopener\">Referencia de herramientas MCP de MemberPress AI Foundation<\/a><\/strong> \u2014 \u00e1mbitos, capacidades y esquemas de cada herramienta;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/es\/docs\/ai-foundation-safety-measures\/\" target=\"_blank\" rel=\"noopener\">Medidas de seguridad para los agentes de MemberPress AI Foundation<\/a><\/strong> \u2014 las cuatro medidas que est\u00e1n detr\u00e1s de los errores de la capa de seguridad.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers [\u2026]<\/p>\n","protected":false},"author":62252,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_strive_editorial_status":"not-started","_strive_copy_of":0,"inline_featured_image":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_genesis_hide_title":false,"_genesis_hide_breadcrumbs":false,"_genesis_hide_singular_image":false,"_genesis_hide_footer_widgets":false,"_genesis_custom_body_class":"","_genesis_custom_post_class":"","_genesis_layout":"","_FSMCFIC_featured_image_caption":"","_FSMCFIC_featured_image_nocaption":"","_FSMCFIC_featured_image_hide":"","_strive_checklists":"\"\"","_strive_active_checklist":"62291e2bb2422","footnotes":""},"ht-kb-category":[1581],"ht-kb-tag":[],"class_list":{"0":"post-81434","1":"ht_kb","2":"type-ht_kb","3":"status-publish","4":"format-standard","6":"ht_kb_category-mcp","7":"entry"},"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t<!-- All in One SEO Pro 4.9.6.2 - aioseo.com -->\n\t<meta name=\"description\" content=\"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers\" \/>\n\t<meta name=\"robots\" content=\"max-image-preview:large\" \/>\n\t<meta name=\"author\" content=\"Nikola M\"\/>\n\t<link rel=\"canonical\" href=\"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/\" \/>\n\t<meta name=\"generator\" content=\"All in One SEO Pro (AIOSEO) 4.9.6.2\" \/>\n\t\t<meta property=\"og:locale\" content=\"es_ES\" \/>\n\t\t<meta property=\"og:site_name\" content=\"MemberPress\" \/>\n\t\t<meta property=\"og:type\" content=\"article\" \/>\n\t\t<meta property=\"og:title\" content=\"MemberPress MCP Errors and Troubleshooting | MemberPress\" \/>\n\t\t<meta property=\"og:description\" content=\"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers\" \/>\n\t\t<meta property=\"og:url\" content=\"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/\" \/>\n\t\t<meta property=\"og:image\" content=\"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg\" \/>\n\t\t<meta property=\"og:image:secure_url\" content=\"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg\" \/>\n\t\t<meta property=\"og:image:width\" content=\"1650\" \/>\n\t\t<meta property=\"og:image:height\" content=\"1275\" \/>\n\t\t<meta property=\"article:published_time\" content=\"2026-07-14T16:09:43+00:00\" \/>\n\t\t<meta property=\"article:modified_time\" content=\"2026-07-21T08:52:40+00:00\" \/>\n\t\t<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/memberpress\/\" \/>\n\t\t<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n\t\t<meta name=\"twitter:site\" content=\"@memberpress\" \/>\n\t\t<meta name=\"twitter:title\" content=\"MemberPress MCP Errors and Troubleshooting | MemberPress\" \/>\n\t\t<meta name=\"twitter:description\" content=\"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers\" \/>\n\t\t<meta name=\"twitter:image\" content=\"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg\" \/>\n\t\t<script type=\"application\/ld+json\" class=\"aioseo-schema\">\n\t\t\t{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#article\",\"name\":\"MemberPress MCP Errors and Troubleshooting | MemberPress\",\"headline\":\"MemberPress MCP Errors and Troubleshooting\",\"author\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\"},\"publisher\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#organization\"},\"image\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/memberpress.com\\\/wp-content\\\/uploads\\\/2022\\\/10\\\/mp-icon-RGB_Icon-01.jpg\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#articleImage\",\"width\":1650,\"height\":1275,\"caption\":\"memberpress logo icon\"},\"datePublished\":\"2026-07-14T12:09:43-04:00\",\"dateModified\":\"2026-07-21T04:52:40-04:00\",\"inLanguage\":\"es-ES\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\"},\"isPartOf\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\"},\"articleSection\":\"MCP\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#breadcrumblist\",\"itemListElement\":[{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es#listItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/memberpress.com\\\/es\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"name\":\"Developer Documentation\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"position\":2,\"name\":\"Developer Documentation\",\"item\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/developer-docs\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/mcp\\\/#listItem\",\"name\":\"MCP\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es#listItem\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/mcp\\\/#listItem\",\"position\":3,\"name\":\"MCP\",\"item\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/mcp\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#listItem\",\"name\":\"MemberPress MCP Errors and Troubleshooting\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"name\":\"Developer Documentation\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#listItem\",\"position\":4,\"name\":\"MemberPress MCP Errors and Troubleshooting\",\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/doc-categories\\\/mcp\\\/#listItem\",\"name\":\"MCP\"}}]},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#organization\",\"name\":\"MemberPress\",\"description\":\"The All-In-One WordPress Membership Plugin\",\"url\":\"https:\\\/\\\/memberpress.com\\\/es\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/memberpress.com\\\/wp-content\\\/uploads\\\/2022\\\/10\\\/mp-icon-RGB_Icon-01.jpg\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#organizationLogo\",\"width\":1650,\"height\":1275,\"caption\":\"memberpress logo icon\"},\"image\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#organizationLogo\"},\"sameAs\":[\"https:\\\/\\\/www.instagram.com\\\/memberpress\\\/\",\"https:\\\/\\\/www.pinterest.com\\\/memberpressplugin\\\/\",\"https:\\\/\\\/www.youtube.com\\\/c\\\/MemberPressPlugin\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/memberpress\\\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\",\"url\":\"https:\\\/\\\/memberpress.com\\\/es\\\/blog\\\/author\\\/nikolacaseproof-com\\\/\",\"name\":\"Nikola M\",\"image\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/memberpress.com\\\/wp-content\\\/litespeed\\\/avatar\\\/1edf820c48f9c430f380efe81887b154.jpg?ver=1785423180\"}},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\",\"url\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/\",\"name\":\"MemberPress MCP Errors and Troubleshooting | MemberPress\",\"description\":\"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers\",\"inLanguage\":\"es-ES\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#website\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/docs\\\/mcp-errors-troubleshooting\\\/#breadcrumblist\"},\"author\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\"},\"creator\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\"},\"datePublished\":\"2026-07-14T12:09:43-04:00\",\"dateModified\":\"2026-07-21T04:52:40-04:00\"},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#website\",\"url\":\"https:\\\/\\\/memberpress.com\\\/es\\\/\",\"name\":\"MemberPress\",\"description\":\"The All-In-One WordPress Membership Plugin\",\"inLanguage\":\"es-ES\",\"publisher\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/es\\\/#organization\"}}]}\n\t\t<\/script>\n\t\t<!-- All in One SEO Pro -->\r\n\t\t<title>MemberPress MCP Errors and Troubleshooting | MemberPress<\/title>\n\n","aioseo_head_json":{"title":"Errores y resoluci\u00f3n de problemas de MemberPress MCP | MemberPress","description":"El servidor MCP de MemberPress AI Foundation devuelve errores estructurados cuando una solicitud no supera la autenticaci\u00f3n, supera un l\u00edmite de frecuencia, carece de \u00e1mbito o capacidad, o se recibe mientras las escrituras destructivas est\u00e1n en pausa. Cada error incluye un c\u00f3digo que un cliente de IA o un desarrollador puede identificar. Esta referencia recoge los c\u00f3digos de error que genera el servidor MCP y muestra qu\u00e9 los provoca","canonical_url":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#article","name":"MemberPress MCP Errors and Troubleshooting | MemberPress","headline":"MemberPress MCP Errors and Troubleshooting","author":{"@id":"https:\/\/memberpress.com\/es\/blog\/author\/nikolacaseproof-com\/#author"},"publisher":{"@id":"https:\/\/memberpress.com\/es\/#organization"},"image":{"@type":"ImageObject","url":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","@id":"https:\/\/memberpress.com\/es\/#articleImage","width":1650,"height":1275,"caption":"memberpress logo icon"},"datePublished":"2026-07-14T12:09:43-04:00","dateModified":"2026-07-21T04:52:40-04:00","inLanguage":"es-ES","mainEntityOfPage":{"@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#webpage"},"isPartOf":{"@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#webpage"},"articleSection":"MCP"},{"@type":"BreadcrumbList","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#breadcrumblist","itemListElement":[{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es#listItem","position":1,"name":"Home","item":"https:\/\/memberpress.com\/es","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/#listItem","name":"Developer Documentation"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/#listItem","position":2,"name":"Developer Documentation","item":"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/#listItem","name":"MCP"},"previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es#listItem","name":"Home"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/#listItem","position":3,"name":"MCP","item":"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#listItem","name":"MemberPress MCP Errors and Troubleshooting"},"previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/#listItem","name":"Developer Documentation"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#listItem","position":4,"name":"MemberPress MCP Errors and Troubleshooting","previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/#listItem","name":"MCP"}}]},{"@type":"Organization","@id":"https:\/\/memberpress.com\/es\/#organization","name":"MemberPress","description":"The All-In-One WordPress Membership Plugin","url":"https:\/\/memberpress.com\/es\/","logo":{"@type":"ImageObject","url":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#organizationLogo","width":1650,"height":1275,"caption":"memberpress logo icon"},"image":{"@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#organizationLogo"},"sameAs":["https:\/\/www.instagram.com\/memberpress\/","https:\/\/www.pinterest.com\/memberpressplugin\/","https:\/\/www.youtube.com\/c\/MemberPressPlugin","https:\/\/www.linkedin.com\/company\/memberpress\/"]},{"@type":"Person","@id":"https:\/\/memberpress.com\/es\/blog\/author\/nikolacaseproof-com\/#author","url":"https:\/\/memberpress.com\/es\/blog\/author\/nikolacaseproof-com\/","name":"Nikola M","image":{"@type":"ImageObject","url":"https:\/\/memberpress.com\/wp-content\/litespeed\/avatar\/1edf820c48f9c430f380efe81887b154.jpg?ver=1785423180"}},{"@type":"WebPage","@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#webpage","url":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/","name":"MemberPress MCP Errors and Troubleshooting | MemberPress","description":"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers","inLanguage":"es-ES","isPartOf":{"@id":"https:\/\/memberpress.com\/es\/#website"},"breadcrumb":{"@id":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/#breadcrumblist"},"author":{"@id":"https:\/\/memberpress.com\/es\/blog\/author\/nikolacaseproof-com\/#author"},"creator":{"@id":"https:\/\/memberpress.com\/es\/blog\/author\/nikolacaseproof-com\/#author"},"datePublished":"2026-07-14T12:09:43-04:00","dateModified":"2026-07-21T04:52:40-04:00"},{"@type":"WebSite","@id":"https:\/\/memberpress.com\/es\/#website","url":"https:\/\/memberpress.com\/es\/","name":"MemberPress","description":"The All-In-One WordPress Membership Plugin","inLanguage":"es-ES","publisher":{"@id":"https:\/\/memberpress.com\/es\/#organization"}}]},"og:locale":"es_ES","og:site_name":"MemberPress","og:type":"article","og:title":"MemberPress MCP Errors and Troubleshooting | MemberPress","og:description":"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers","og:url":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/","og:image":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","og:image:secure_url":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","og:image:width":1650,"og:image:height":1275,"article:published_time":"2026-07-14T16:09:43+00:00","article:modified_time":"2026-07-21T08:52:40+00:00","article:publisher":"https:\/\/www.facebook.com\/memberpress\/","twitter:card":"summary_large_image","twitter:site":"@memberpress","twitter:title":"MemberPress MCP Errors and Troubleshooting | MemberPress","twitter:description":"The MemberPress AI Foundation MCP server returns structured errors when a request fails authentication, exceeds a rate limit, lacks scope or capability, or arrives while destructive writes are paused. Each error carries a code an AI client or developer can match on. This reference catalogs the error codes the MCP server produces, shows what triggers","twitter:image":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg"},"aioseo_meta_data":{"post_id":"81434","title":null,"description":null,"keywords":null,"keyphrases":null,"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":null,"og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"","isEnabled":true},"graphs":[]},"schema_type":"default","schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":null,"robots_max_videopreview":null,"robots_max_imagepreview":"large","priority":null,"frequency":null,"local_seo":null,"seo_analyzer_scan_date":"2026-07-21 08:56:38","breadcrumb_settings":null,"limit_modified_date":false,"reviewed_by":null,"open_ai":null,"ai":null,"created":"2026-07-14 16:09:43","updated":"2026-07-21 08:56:38"},"aioseo_breadcrumb":"<div class=\"aioseo-breadcrumbs\"><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/memberpress.com\/es\" title=\"Home\">Home<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/\" title=\"Developer Documentation\">Developer Documentation<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/\" title=\"MCP\">MCP<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\tMemberPress MCP Errors and Troubleshooting\n<\/span><\/div>","aioseo_breadcrumb_json":[{"label":"Home","link":"https:\/\/memberpress.com\/es"},{"label":"Developer Documentation","link":"https:\/\/memberpress.com\/es\/doc-categories\/developer-docs\/"},{"label":"MCP","link":"https:\/\/memberpress.com\/es\/doc-categories\/mcp\/"},{"label":"MemberPress MCP Errors and Troubleshooting","link":"https:\/\/memberpress.com\/es\/docs\/mcp-errors-troubleshooting\/"}],"_links":{"self":[{"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb\/81434","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/users\/62252"}],"replies":[{"embeddable":true,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/comments?post=81434"}],"version-history":[{"count":1,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb\/81434\/revisions"}],"predecessor-version":[{"id":81511,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb\/81434\/revisions\/81511"}],"wp:attachment":[{"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/media?parent=81434"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb-category?post=81434"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/memberpress.com\/es\/wp-json\/wp\/v2\/ht-kb-tag?post=81434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}