{"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\/pt\/docs\/mcp-errors-troubleshooting\/","title":{"rendered":"Erros e solu\u00e7\u00e3o de problemas do MCP MemberPress"},"content":{"rendered":"<p>O servidor MCP da MemberPress AI Foundation retorna erros estruturados quando uma solicita\u00e7\u00e3o falha na autentica\u00e7\u00e3o, excede um limite de taxa, n\u00e3o possui escopo ou capacidade, ou chega enquanto as grava\u00e7\u00f5es destrutivas est\u00e3o em pausa. Cada erro cont\u00e9m um c\u00f3digo que um cliente de IA ou desenvolvedor pode identificar.<\/p>\n\n\n\n<p>Este guia lista os c\u00f3digos de erro gerados pelo servidor MCP, mostra o que causa cada um deles e explica como resolv\u00ea-los. Uma se\u00e7\u00e3o dedicada \u00e0 solu\u00e7\u00e3o de problemas aborda os tipos de falhas que ocorrem com mais frequ\u00eancia durante a configura\u00e7\u00e3o inicial.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"error-response-shape\"><a href=\"#error-response-shape\">Formato da resposta de erro<\/a><\/h2>\n\n\n\n<p>O servidor retorna erros em duas camadas, e eles apresentam formatos diferentes. Identificar o campo correto \u00e9 essencial para um tratamento confi\u00e1vel dos erros.<\/p>\n\n\n\n<p><strong>Erros na camada de transporte<\/strong> s\u00e3o rejeitadas antes do processamento do JSON-RPC \u2014 falhas de autentica\u00e7\u00e3o e rotas desativadas. Elas utilizam o formato de erro REST do WordPress, com uma string <code>c\u00f3digo<\/code> e um c\u00f3digo de status HTTP em <code>data.status<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": \"auth_required\",\n  \"message\": \"\u00c9 necess\u00e1rio o cabe\u00e7alho de autoriza\u00e7\u00e3o.\",\n  \"data\": { \"status\": 401 }\n}<\/code><\/pre>\n\n\n\n<p><strong>Erros na camada de ferramentas<\/strong> ocorrem ap\u00f3s a autentica\u00e7\u00e3o, durante o envio da ferramenta \u2014 a camada de seguran\u00e7a e os controles de capacidade. Eles utilizam o formato de erro JSON-RPC 2.0, no qual <code>c\u00f3digo<\/code> \u00e9 o valor gen\u00e9rico do JSON-RPC <code>-32603<\/code> e o identificador est\u00e1vel e compat\u00edvel \u00e9 <strong><code>data.mp_error_code<\/code><\/strong>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"As grava\u00e7\u00f5es destrutivas foram suspensas por um administrador. Tente novamente mais tarde ou entre em contato com o propriet\u00e1rio do site.\",\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>Jogo em andamento <code>data.mp_error_code<\/code>, n\u00e3o <code>c\u00f3digo<\/code>.<\/strong> Todo erro na camada de ferramentas retorna o mesmo resultado <code>-32603<\/code>; apenas <code>mp_error_code<\/code> \u00e9 o que os distingue. O <code>request_id<\/code> \u00e9 \u00fanico para cada chamada \u2014 \u00fatil para suporte, mas nunca para compara\u00e7\u00e3o.<\/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\">Vis\u00e3o geral das categorias de erros<\/a><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Categoria<\/th><th>Identificador<\/th><th>Camada<\/th><\/tr><\/thead><tbody><tr><td>Autentica\u00e7\u00e3o<\/td><td><code>auth_required<\/code> e erros de token<\/td><td>Transporte (<code>data.status: 401<\/code>)<\/td><\/tr><tr><td>Rota desativada ou links permanentes<\/td><td><code>rest_no_route<\/code><\/td><td>Transporte (<code>data.status: 404<\/code>)<\/td><\/tr><tr><td>\u00c2mbito e capacidade<\/td><td><code>SCOPE_INSUFICIENTE<\/code>, <code>CAPACIDADE_INSUFICIENTE<\/code><\/td><td>Ferramenta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Camada de seguran\u00e7a<\/td><td><code>WRITES_PAUSED<\/code>, <code>CONFIRMA\u00c7\u00c3O_INV\u00c1LIDA<\/code><\/td><td>Ferramenta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Limita\u00e7\u00e3o de taxa<\/td><td><code>RATE_LIMITED<\/code>, p\u00fablico, inscri\u00e7\u00e3o<\/td><td>Misto \u2014 consulte Erros de limite de taxa<\/td><\/tr><tr><td>Valida\u00e7\u00e3o<\/td><td><code>erro_de_valida\u00e7\u00e3o<\/code><\/td><td>Ferramenta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Recurso e estado<\/td><td><code>usu\u00e1rio_n\u00e3o_encontrado<\/code>, <code>nome_de_usu\u00e1rio_duplicado<\/code>, <code>j\u00e1_reembolsado<\/code>, o <code>*_n\u00e3o_encontrado_*<\/code> fam\u00edlia<\/td><td>Ferramenta (<code>-32603<\/code> + <code>mp_error_code<\/code>)<\/td><\/tr><tr><td>Cr\u00e9ditos<\/td><td><code>cr\u00e9ditos_insuficientes<\/code>, <code>cr\u00e9ditos_indispon\u00edveis<\/code><\/td><td>N\u00e3o est\u00e1 acess\u00edvel por meio das ferramentas do MCP \u2014 veja abaixo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"authentication-errors\"><a href=\"#authentication-errors\">Erros de autentica\u00e7\u00e3o<\/a><\/h2>\n\n\n\n<p>O servidor valida as credenciais em cada solicita\u00e7\u00e3o. Todas as rotas principais do MCP exigem um token Bearer ou autentica\u00e7\u00e3o Basic.<\/p>\n\n\n\n<p>Uma solicita\u00e7\u00e3o com <strong>sem cabe\u00e7alho de autoriza\u00e7\u00e3o<\/strong> \u00e9 rejeitado na camada de transporte:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": \"auth_required\",\n  \"message\": \"\u00c9 necess\u00e1rio o cabe\u00e7alho de autoriza\u00e7\u00e3o.\",\n  \"data\": { \"status\": 401 }\n}<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Gatilho<\/th><th>C\u00f3digo<\/th><th>Mensagem<\/th><\/tr><\/thead><tbody><tr><td>Sem credenciais<\/td><td><code>auth_required<\/code><\/td><td>\u201c\u00c9 necess\u00e1rio um cabe\u00e7alho de autoriza\u00e7\u00e3o.\u201d<\/td><\/tr><tr><td>Cabe\u00e7alho com formato incorreto (que n\u00e3o seja Bearer ou Basic)<\/td><td><code>auth_required<\/code><\/td><td>\u201c\u00c9 necess\u00e1ria autentica\u00e7\u00e3o por portador ou b\u00e1sica.\u201d<\/td><\/tr><tr><td>Token expirado<\/td><td><code>token_expired<\/code><\/td><td>\u201cO token expirou.\u201d<\/td><\/tr><tr><td>Token revogado ou inexistente<\/td><td><code>auth_required<\/code><\/td><td>\u201cToken inv\u00e1lido ou revogado.\u201d<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Um token expirado retorna um c\u00f3digo distinto. Um token revogado e um token que nunca existiu s\u00e3o <strong>deliberadamente indistingu\u00edveis<\/strong> \u2014 os filtros de consulta de tokens excluem as linhas revogadas; portanto, a resposta n\u00e3o revela se um determinado token j\u00e1 existiu.<\/p>\n\n\n\n<p><code>401<\/code> as respostas na rota MCP carregam um <code>WWW-Authenticate<\/code> cabe\u00e7alho com o valor exato <code>Portador realm=\"mcp\", resource_metadata=\"\"<\/code>, e o cabe\u00e7alho \u00e9 exposto por meio do CORS. Os endpoints do OAuth o omitem deliberadamente.<\/p>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> Gere um novo token pelo assistente ou reconecte o cliente para executar o fluxo OAuth novamente. Confirme se o token n\u00e3o foi revogado no <strong>Clientes conectados ao MCP<\/strong> guia.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"scope-and-capability-errors\"><a href=\"#scope-and-capability-errors\">Erros de escopo e capacidade<\/a><\/h2>\n\n\n\n<p>Dois gateways distintos rejeitam uma chamada de ferramenta ap\u00f3s a autentica\u00e7\u00e3o ter sido bem-sucedida. Ambos s\u00e3o exibidos como erros da camada de ferramentas.<\/p>\n\n\n\n<p><strong>Porta de escopo.<\/strong> Cada ferramenta declara um escopo obrigat\u00f3rio. O servidor compara esse escopo com os escopos concedidos ao token antes do despacho. Uma conex\u00e3o somente leitura que chama <code>memberpress_create_member<\/code> n\u00e3o passa por este port\u00e3o.<\/p>\n\n\n\n<p><strong>Porta de capacidade.<\/strong> Cada ferramenta de edi\u00e7\u00e3o tamb\u00e9m declara a capacidade do WordPress de que necessita \u2014 por exemplo <code>create_users<\/code>, <code>editar_usu\u00e1rios<\/code>, <code>excluir_usu\u00e1rios<\/code>ou <code>gerenciar_op\u00e7\u00f5es<\/code>. O servidor verifica a autoriza\u00e7\u00e3o do propriet\u00e1rio do token antes do envio. Um <code>completo<\/code>-token de escopo pertencente a um usu\u00e1rio sem <code>create_users<\/code> Ainda n\u00e3o consigo criar membros.<\/p>\n\n\n\n<p>Os port\u00f5es s\u00e3o executados em ordem \u2014 primeiro o scope \u2014 e retornam <strong>c\u00f3digos distintos<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Port\u00e3o<\/th><th><code>mp_error_code<\/code><\/th><th>Mensagem<\/th><\/tr><\/thead><tbody><tr><td>Escopo<\/td><td><code>SCOPE_INSUFICIENTE<\/code><\/td><td><code>O escopo obrigat\u00f3rio \"%s\" n\u00e3o est\u00e1 concedido a este token.<\/code><\/td><\/tr><tr><td>Capacidade<\/td><td><code>CAPACIDADE_INSUFICIENTE<\/code><\/td><td><code>Capacidade insuficiente para esta ferramenta. O usu\u00e1rio deve ter o \"%s\".<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Ambos utilizam o envelope da camada de ferramentas \u2014 <code>-32603<\/code> com o identificador do est\u00e1bulo em <code>data.mp_error_code<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"Permiss\u00e3o insuficiente para esta ferramenta. O usu\u00e1rio deve ter a permiss\u00e3o \\\"create_users\\\".\",\n  \"data\": { \"mp_error_code\": \"CAPABILITY_INSUFFICIENT\" },\n  \"request_id\": \"req_...\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Falhas no escopo:<\/strong> A conex\u00e3o precisa de uma autoriza\u00e7\u00e3o mais ampla. Revogue-a e emita uma nova conex\u00e3o com os escopos de grava\u00e7\u00e3o necess\u00e1rios. O limite de acesso deve ser \u201cAcesso Total\u201d para que novas conex\u00f5es recebam escopos de grava\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong>Falhas de capacidade:<\/strong> O usu\u00e1rio do WordPress associado ao token n\u00e3o possui a permiss\u00e3o de fun\u00e7\u00e3o necess\u00e1ria. Fa\u00e7a login como um usu\u00e1rio que possua essa permiss\u00e3o ou conceda-a a esse usu\u00e1rio.<\/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> As conex\u00f5es com senha de aplicativo s\u00e3o sempre somente para leitura. Por padr\u00e3o, todas as ferramentas de grava\u00e7\u00e3o falham na verifica\u00e7\u00e3o de escopo em uma conex\u00e3o com senha de aplicativo. Use uma conex\u00e3o OAuth para grava\u00e7\u00f5es.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"safety-layer-errors\"><a href=\"#safety-layer-errors\">Erros na camada de seguran\u00e7a<\/a><\/h2>\n\n\n\n<p>As medidas de seguran\u00e7a do agente geram seus pr\u00f3prios erros na camada de ferramentas. O <strong><a href=\"https:\/\/memberpress.com\/pt\/docs\/ai-foundation-safety-measures\/\" target=\"_blank\" rel=\"noopener\">Refer\u00eancia sobre medidas de seguran\u00e7a para agentes<\/a><\/strong> explica as medidas; esta se\u00e7\u00e3o lista as recusas.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"writespaused\"><a href=\"#writespaused\">WRITES_PAUSED<\/a><\/h3>\n\n\n\n<p>O kill switch suspende todas as grava\u00e7\u00f5es destrutivas. Enquanto estiver ativo, o servidor rejeita as ferramentas destrutivas com <code>WRITES_PAUSED<\/code> \u2014 independentemente dos escopos da conex\u00e3o e mesmo quando a chamada cont\u00e9m um token de confirma\u00e7\u00e3o v\u00e1lido.<\/p>\n\n\n\n<p>A recusa ataca o <strong>primeiro, chamada sem compromisso<\/strong>: a *pr\u00e9-visualiza\u00e7\u00e3o* de uma ferramenta destrutiva \u00e9 bloqueada, e n\u00e3o apenas sua execu\u00e7\u00e3o. O kill switch bloqueia todo o caminho de grava\u00e7\u00e3o destrutiva, de modo que um estado pausado nem mesmo consegue gerar um token de confirma\u00e7\u00e3o. As ferramentas de leitura continuam funcionando.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"As grava\u00e7\u00f5es destrutivas foram suspensas por um administrador. Tente novamente mais tarde ou entre em contato com o propriet\u00e1rio do site.\",\n  \"data\": { \"mp_error_code\": \"WRITES_PAUSED\" },\n  \"request_id\": \"req_011Cc7Bhv5NZnRMgQ9Bg2JBo\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> um administrador desativa o bot\u00e3o de emerg\u00eancia a partir do <strong>Clientes conectados ao MCP<\/strong> guia. A pausa \u00e9 uma a\u00e7\u00e3o administrativa deliberada; verifique o motivo pelo qual ela foi ativada antes de retomar as grava\u00e7\u00f5es.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"confirmationinvalid\"><a href=\"#confirmationinvalid\">CONFIRMA\u00c7\u00c3O_INV\u00c1LIDA<\/a><\/h3>\n\n\n\n<p>As ferramentas destrutivas exigem um fluxo de duas chamadas: a primeira chamada retorna uma pr\u00e9-visualiza\u00e7\u00e3o e um token de confirma\u00e7\u00e3o de uso \u00fanico; a segunda chamada passa o token na <code>confirmar<\/code> par\u00e2metro. <strong>Tr\u00eas causas distintas levam ao mesmo resultado <code>CONFIRMA\u00c7\u00c3O_INV\u00c1LIDA<\/code> erro<\/strong> \u2014 a mensagem n\u00e3o deixa claro o que ocorreu:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Causa<\/th><th>Detalhes<\/th><\/tr><\/thead><tbody><tr><td>O token expirou<\/td><td>O token j\u00e1 ultrapassou o prazo de validade de 60 segundos<\/td><\/tr><tr><td>Token j\u00e1 foi usado<\/td><td>Os tokens s\u00e3o de uso \u00fanico<\/td><\/tr><tr><td>Os argumentos foram alterados<\/td><td>O token est\u00e1 vinculado \u00e0 ferramenta, aos argumentos e ao usu\u00e1rio espec\u00edficos<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"code\": -32603,\n  \"message\": \"O token de confirma\u00e7\u00e3o \u00e9 inv\u00e1lido, est\u00e1 vencido ou os argumentos foram alterados. Chame a ferramenta sem `confirm` para receber uma nova visualiza\u00e7\u00e3o e um novo token.\",\n  \"data\": { \"mp_error_code\": \"CONFIRMATION_INVALID\" },\n  \"request_id\": \"req_011Cc7AK3jF4SA4VLs3qsmBD\"\n}<\/code><\/pre>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> chame a ferramenta novamente sem <code>confirmar<\/code> para obter uma pr\u00e9-visualiza\u00e7\u00e3o e um token novos e, em seguida, confirmar em at\u00e9 60 segundos usando os mesmos argumentos. Como um \u00fanico c\u00f3digo abrange tr\u00eas causas, um cliente que esteja solucionando problemas deve executar a pr\u00e9-visualiza\u00e7\u00e3o novamente, em vez de tentar diagnosticar qual prote\u00e7\u00e3o foi acionada.<\/p>\n\n\n\n<p>A falha \u00e9 intencional. Uma resposta simples do tipo \u201caprovado\/reprovado\u201d n\u00e3o revela se um determinado token chegou a existir, e a solu\u00e7\u00e3o \u00e9 a mesma em todos os casos: execute novamente a visualiza\u00e7\u00e3o.<\/p>\n\n\n\n<p>As respostas <code>error.data<\/code> tem um <code>raz\u00e3o<\/code> campo ao lado do c\u00f3digo de n\u00edvel superior, que permanece inalterado, com dois valores: <code>vencido_ou_utilizado<\/code> (o token n\u00e3o foi encontrado \u2014 expirou, j\u00e1 foi utilizado ou nunca foi emitido; nesses casos, permanece deliberadamente oculto) e <code>arguments_changed<\/code> (o token estava v\u00e1lido, mas a solicita\u00e7\u00e3o diferiu do que foi exibido na pr\u00e9-visualiza\u00e7\u00e3o \u2014 execute a pr\u00e9-visualiza\u00e7\u00e3o novamente e confirme o novo token).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"rate-limit-errors\"><a href=\"#rate-limit-errors\">Erros de limite de taxa<\/a><\/h2>\n\n\n\n<p>Os limites de taxa independentes protegem o servidor, e <strong>a forma da resposta varia de acordo com o ponto-final<\/strong> \u2014 o endpoint MCP autenticado n\u00e3o retorna <code>429<\/code> de jeito nenhum.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Superf\u00edcie<\/th><th>Limite<\/th><th>Resposta<\/th><\/tr><\/thead><tbody><tr><td>Ponto de extremidade MCP autenticado<\/td><td>120 solicita\u00e7\u00f5es por minuto por token (padr\u00e3o; configur\u00e1vel entre 1 e 1.000) \u2014 definido na guia \u201cConfigura\u00e7\u00f5es do MCP\u201d, onde a limita\u00e7\u00e3o de taxa tamb\u00e9m pode ser totalmente desativada<\/td><td>Erro de JSON-RPC no HTTP <strong>200<\/strong> \u2014 c\u00f3digo <code>-32029<\/code>, <code>mp_error_code: RATE_LIMITED<\/code><\/td><\/tr><tr><td>Endpoint p\u00fablico do MCP<\/td><td>60 solicita\u00e7\u00f5es por minuto por IP (fixo)<\/td><td>HTTP <strong>429<\/strong> com <code>Retry-After: 60<\/code><\/td><\/tr><tr><td>OAuth <code>\/registrar<\/code><\/td><td>60 registros por hora por endere\u00e7o IP<\/td><td>HTTP <strong>429<\/strong> com <code>Retry-After: 3600<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>O limite do endpoint autenticado \u00e9 exibido dentro do envelope JSON-RPC, e n\u00e3o como um erro HTTP:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"jsonrpc\":\"2.0\",\"id\":1,\"error\":{\"code\":-32029,\"message\":\"Limite de solicita\u00e7\u00f5es excedido.\",\"data\":{\"mp_error_code\":\"RATE_LIMITED\"}}}<\/code><\/pre>\n\n\n\n<p>O endpoint p\u00fablico retorna um corpo de erro em JSON-RPC simples com seu <code>429<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"jsonrpc\":\"2.0\",\"error\":{\"code\":-32000,\"message\":\"Limite de solicita\u00e7\u00f5es excedido. Tente novamente daqui a um minuto.\"}}<\/code><\/pre>\n\n\n\n<p>O endpoint de registro retorna um corpo no estilo OAuth com seu <code>429<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\"error\":\"too_many_requests\",\"error_description\":\"H\u00e1 um n\u00famero excessivo de registros de clientes a partir deste IP. Por favor, tente novamente daqui a uma 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>Observa\u00e7\u00e3o:<\/strong> Nenhum ponto final \u00e9 enviado <code>X-RateLimit-Limit<\/code> ou <code>X-RateLimit-Remaining<\/code> cabe\u00e7alhos. Os \u00fanicos cabe\u00e7alhos de limita\u00e7\u00e3o de taxa s\u00e3o os <code>Retry-After<\/code> valores apresentados acima.<\/p>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> aguarde at\u00e9 que a janela seja reinicializada. Para o endpoint autenticado, fa\u00e7a a correspond\u00eancia com <code>mp_error_code: RATE_LIMITED<\/code> \u2014 a <code>200<\/code> O status n\u00e3o significa sucesso \u2014 e d\u00ea um tempo de pelo menos um minuto. Respeito <code>Retry-After<\/code> para onde foram enviadas. Para manter um volume leg\u00edtimo constante, utilize solicita\u00e7\u00f5es em lote ou reduza a frequ\u00eancia de consulta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"validation-errors\"><a href=\"#validation-errors\">Erros de valida\u00e7\u00e3o<\/a><\/h2>\n\n\n\n<p>Falhas de valida\u00e7\u00e3o s\u00e3o erros na camada de ferramentas: <strong><code>-32603<\/code><\/strong> com <strong><code>mp_error_code: erro_de_valida\u00e7\u00e3o<\/code><\/strong>. O <strong><code>mensagem<\/code><\/strong> isso mesmo explica o problema \u2014 indica o valor rejeitado e, quando h\u00e1 um vocabul\u00e1rio aplic\u00e1vel, lista os valores aceitos. Por exemplo, ao criar um webhook com um evento desconhecido, \u00e9 exibido:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Eventos desconhecidos: member-added. Eventos conhecidos: transaction-completed, ...<\/code><\/pre>\n\n\n\n<p>As ferramentas de grava\u00e7\u00e3o validam os vocabul\u00e1rios de argumentos em rela\u00e7\u00e3o aos seus esquemas, e os valores legados s\u00e3o rejeitados em favor da enumera\u00e7\u00e3o aceita. As ferramentas de cupons s\u00e3o o exemplo documentado: <code>discount_mode<\/code> aceita <code>padr\u00e3o<\/code> ou <code>primeiro pagamento<\/code>e <code>tipo de desconto<\/code> aceita <code>por cento<\/code> ou <code>d\u00f3lar<\/code>. Os valores tradicionais <code>primeiro<\/code>, <code>todos<\/code>e <code>plano<\/code> s\u00e3o rejeitados.<\/p>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> corrija a entrada conforme descrito na mensagem \u2014 ou leia as instru\u00e7\u00f5es da ferramenta <code>esquema de entrada<\/code> em <code>ferramentas\/lista<\/code> \u2014 em seguida, reenvie com os valores can\u00f4nicos. N\u00e3o tente novamente com os mesmos argumentos.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"resource-and-state-errors\"><a href=\"#resource-and-state-errors\">Erros de recurso e de estado<\/a><\/h2>\n\n\n\n<p>Al\u00e9m da valida\u00e7\u00e3o, as ferramentas retornam c\u00f3digos voltados para o usu\u00e1rio quando uma solicita\u00e7\u00e3o est\u00e1 bem formada, mas n\u00e3o pode ser aplicada ao estado atual do site. Esses c\u00f3digos seguem o mesmo formato da camada da ferramenta (<strong><code>-32603<\/code><\/strong> + <strong><code>mp_error_code<\/code><\/strong>), e suas mensagens explicam o motivo diretamente:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>C\u00f3digo<\/th><th>Gatilho<\/th><\/tr><\/thead><tbody><tr><td><code>usu\u00e1rio_n\u00e3o_encontrado<\/code><\/td><td>O membro ou usu\u00e1rio mencionado n\u00e3o existe<\/td><\/tr><tr><td><code>*_n\u00e3o_encontrado_*<\/code> fam\u00edlia<\/td><td>O recurso mencionado (transa\u00e7\u00e3o, assinatura, webhook etc.) n\u00e3o existe<\/td><\/tr><tr><td><code>nome_de_usu\u00e1rio_duplicado<\/code><\/td><td>Cria\u00e7\u00e3o de usu\u00e1rio com um nome de usu\u00e1rio j\u00e1 em uso<\/td><\/tr><tr><td><code>j\u00e1_reembolsado<\/code><\/td><td>Tentativa de reembolso em uma transa\u00e7\u00e3o que j\u00e1 havia sido reembolsada<\/td><\/tr><tr><td><code>memberpress_not_active<\/code><\/td><td>O plug-in MemberPress n\u00e3o est\u00e1 ativo<\/td><\/tr><tr><td><code>auto_exclus\u00e3o_recusada<\/code><\/td><td><code>excluir_membro<\/code> visando o usu\u00e1rio que est\u00e1 fazendo a chamada \u2014 a exclus\u00e3o da conta associada ao token atual encerraria a sess\u00e3o. A verifica\u00e7\u00e3o autom\u00e1tica \u00e9 executada primeiro, portanto, tem prioridade sobre a prote\u00e7\u00e3o de administrador<\/td><\/tr><tr><td><code>admin_delete_refused<\/code><\/td><td><code>excluir_membro<\/code> direcionado a qualquer usu\u00e1rio com o <code>gerenciar_op\u00e7\u00f5es<\/code> capacidade. Primeiro, retire os privil\u00e9gios do usu\u00e1rio no painel de administra\u00e7\u00e3o do WordPress, caso a exclus\u00e3o seja intencional<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Resolu\u00e7\u00e3o:<\/strong> Essas s\u00e3o condi\u00e7\u00f5es de estado, n\u00e3o falhas transit\u00f3rias \u2014 verifique o recurso referenciado (ou o estado do site) e corrija a solicita\u00e7\u00e3o. Repetir a tentativa sem altera\u00e7\u00f5es n\u00e3o dar\u00e1 certo.<\/p>\n\n\n\n<p>Falhas genuinamente internas \u2014 <strong><code>falha ao salvar<\/code><\/strong>, <strong><code>falha na exclus\u00e3o<\/code><\/strong>, <strong><code>db_error<\/code><\/strong> \u2014 s\u00e3o gen\u00e9ricos por defini\u00e7\u00e3o, de modo que os detalhes da camada de armazenamento n\u00e3o sejam revelados aos clientes. Um cliente que receba uma dessas mensagens s\u00f3 pode tentar novamente mais tarde ou relatar a falha ao administrador do site.<\/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\">Erros de cr\u00e9dito \u2014 n\u00e3o acess\u00edveis por meio do MCP<\/a><\/h2>\n\n\n\n<p>As chamadas de pr\u00e9-visualiza\u00e7\u00e3o passam pelas mesmas restri\u00e7\u00f5es de lista de permiss\u00e3o que a execu\u00e7\u00e3o em produ\u00e7\u00e3o e apresentam as mesmas <code>mp_error_code<\/code> \u2014 uma ferramenta n\u00e3o pode revelar, em sua pr\u00e9-visualiza\u00e7\u00e3o, um erro interno que a execu\u00e7\u00e3o em tempo real mascararia.<\/p>\n\n\n\n<p>A lista de permiss\u00f5es de erros do servidor inclui dois c\u00f3digos relacionados a cr\u00e9dito: <code>cr\u00e9ditos_insuficientes<\/code> e <code>cr\u00e9ditos_indispon\u00edveis<\/code>. Nenhuma ferramenta do MCP consome cr\u00e9ditos de IA, e o servidor do MCP n\u00e3o chama nenhum m\u00e9todo relacionado a cr\u00e9ditos. Os c\u00f3digos existem para que os servi\u00e7os posteriores possam transmitir erros relacionados a cr\u00e9ditos por meio da resposta JSON-RPC; nenhum caminho de chamada das ferramentas do MCP os gera.<\/p>\n\n\n\n<p>Um cliente que utiliza as ferramentas do MCP nunca se depara com esses c\u00f3digos. Os saldos credores afetam os recursos de gera\u00e7\u00e3o baseados no Mastermind (por exemplo, o Course Copilot), e n\u00e3o as chamadas \u00e0s ferramentas do MCP.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"troubleshooting-setup-failures\"><a href=\"#troubleshooting-setup-failures\">Solu\u00e7\u00e3o de problemas relacionados a falhas na configura\u00e7\u00e3o<\/a><\/h2>\n\n\n\n<p>Modos de falha que surgem durante a conex\u00e3o inicial, na ordem em que os usu\u00e1rios normalmente os encontram:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>O endpoint MCP autenticado retorna <code>404<\/code>:<\/strong> Os permalinks est\u00e3o configurados como \u201cSimples\u201d. A API REST exige permalinks do tipo \u201cNome da postagem\u201d ou mais detalhados;<\/li>\n\n\n\n<li><strong>O endpoint p\u00fablico do MCP retorna <code>404<\/code> (<code>rest_no_route<\/code>):<\/strong> O cat\u00e1logo p\u00fablico est\u00e1 desativado. Quando desativado, a rota n\u00e3o \u00e9 montada; portanto, qualquer solicita\u00e7\u00e3o retorna <code>rest_no_route<\/code> \u2014 a exist\u00eancia do ponto final n\u00e3o \u00e9 revelada. Habilite o cat\u00e1logo no <strong>Configura\u00e7\u00f5es do MCP<\/strong> guia;<\/li>\n\n\n\n<li><strong>O endpoint retorna <code>401<\/code> (<code>auth_required<\/code>) em um navegador:<\/strong> comportamento esperado. O <code>401<\/code> confirma que o endpoint est\u00e1 ativo; o navegador n\u00e3o possui nenhum cabe\u00e7alho de autoriza\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong>O Claude Desktop mostra o conector, mas n\u00e3o exibe as ferramentas:<\/strong> a aprova\u00e7\u00e3o do OAuth n\u00e3o foi conclu\u00edda ou a conex\u00e3o foi revogada. Abra o conector e reconecte-se;<\/li>\n\n\n\n<li><strong><code>etapa=erro_inicial<\/code> durante a conex\u00e3o com o Claude Desktop:<\/strong> O registro via OAuth est\u00e1 limitado a 60 tentativas por hora por endere\u00e7o IP. Aguarde at\u00e9 que o limite seja reiniciado e tente novamente;<\/li>\n\n\n\n<li><strong>Um cliente de terceiros n\u00e3o pode se cadastrar via OAuth (<code>uri_de_redirecionamento_inv\u00e1lido<\/code>):<\/strong> O ponto de extremidade de registro din\u00e2mico aceita apenas URIs de redirecionamento inclu\u00eddas na lista de permiss\u00f5es (os clientes de IA conhecidos). Um cliente cuja URI de redirecionamento n\u00e3o conste na lista de permiss\u00f5es \u00e9 rejeitado em <code>\/registrar<\/code>;<\/li>\n\n\n\n<li><strong>Falta uma ferramenta esperada em <code>ferramentas\/lista<\/code>:<\/strong> a ferramenta pertence a um complemento inativo. As ferramentas de complementos s\u00f3 ficam registradas enquanto o respectivo complemento estiver ativo. Ao chamar uma ferramenta n\u00e3o registrada, \u00e9 retornado o erro padr\u00e3o de m\u00e9todo desconhecido do JSON-RPC;<\/li>\n\n\n\n<li><strong>Caixas de sele\u00e7\u00e3o que faltam no assistente:<\/strong> O limite de acesso est\u00e1 definido como \u201cSomente leitura\u201d. O assistente oculta os escopos de grava\u00e7\u00e3o e exibe um aviso. Aumente o limite do <strong>Configura\u00e7\u00f5es do MCP<\/strong> guia;<\/li>\n\n\n\n<li><strong>Uma ferramenta destrutiva exibe uma pr\u00e9-visualiza\u00e7\u00e3o em vez de executar:<\/strong> comportamento esperado. Ferramentas destrutivas exigem o fluxo de confirma\u00e7\u00e3o em duas etapas. Passe o token retornado no <code>confirmar<\/code> par\u00e2metro em at\u00e9 60 segundos.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"error-handling-guidance\"><a href=\"#error-handling-guidance\">Orienta\u00e7\u00f5es para o tratamento de erros<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Jogo em andamento <code>data.mp_error_code<\/code><\/strong> para erros na camada de ferramentas e em <code>c\u00f3digo<\/code> mais <code>data.status<\/code> para erros na camada de transporte. Nunca fa\u00e7a a correspond\u00eancia diretamente no <code>-32603<\/code>;<\/li>\n\n\n\n<li><strong><code>auth_required<\/code> \/ <code>401<\/code>:<\/strong> Fa\u00e7a uma nova autentica\u00e7\u00e3o. N\u00e3o tente novamente com as mesmas credenciais; falhas repetidas acionam o bloqueio por ataque de for\u00e7a bruta;<\/li>\n\n\n\n<li><strong><code>SCOPE_INSUFICIENTE<\/code> \/ <code>CAPACIDADE_INSUFICIENTE<\/code>:<\/strong> N\u00e3o tente novamente. A conex\u00e3o requer uma autoriza\u00e7\u00e3o de escopo mais amplo, ou o usu\u00e1rio por tr\u00e1s do token precisa da permiss\u00e3o do WordPress que est\u00e1 faltando \u2014 uma nova tentativa n\u00e3o ter\u00e1 sucesso;<\/li>\n\n\n\n<li><strong><code>WRITES_PAUSED<\/code>:<\/strong> n\u00e3o tentar novamente automaticamente. Um administrador suspendeu deliberadamente as grava\u00e7\u00f5es destrutivas; exibir o estado ao usu\u00e1rio;<\/li>\n\n\n\n<li><strong><code>erro_de_valida\u00e7\u00e3o<\/code>:<\/strong> corrija a entrada conforme descrito na mensagem e, em seguida, reenvie. N\u00e3o tente novamente com os mesmos argumentos \u2014 a mesma entrada gera a mesma rejei\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong><code>CONFIRMA\u00c7\u00c3O_INV\u00c1LIDA<\/code>:<\/strong> reinicie o fluxo de duas chamadas a partir da chamada de pr\u00e9-visualiza\u00e7\u00e3o. Um c\u00f3digo abrange tr\u00eas causas; portanto, execute novamente a pr\u00e9-visualiza\u00e7\u00e3o em vez de tentar diagnosticar qual delas foi acionada. Nunca armazene tokens de confirma\u00e7\u00e3o em cache;<\/li>\n\n\n\n<li><strong>Limites de taxa:<\/strong> Deixe isso pra l\u00e1. O ponto de extremidade autenticado sinaliza <code>RATE_LIMITED<\/code> dentro de um HTTP <code>200<\/code>; os endpoints p\u00fablicos e de registro retornam <code>429<\/code> com <code>Retry-After<\/code>. Respeito <code>Retry-After<\/code> se tiver sido enviado; caso contr\u00e1rio, aguarde pelo menos um minuto.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"related-documentation\"><a href=\"#related-documentation\">Documenta\u00e7\u00e3o relacionada<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"https:\/\/memberpress.com\/pt\/docs\/ai-foundation-overview\/\" target=\"_blank\" rel=\"noopener\">Vis\u00e3o geral e guia de configura\u00e7\u00e3o do MemberPress AI Foundation<\/a><\/strong> \u2014 instala\u00e7\u00e3o, pr\u00e9-requisitos e verifica\u00e7\u00f5es p\u00f3s-instala\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/pt\/docs\/connecting-ai-clients\/\" target=\"_blank\" rel=\"noopener\">Conectando clientes de IA ao MemberPress \u2013 Refer\u00eancia para desenvolvedores<\/a><\/strong> \u2014 m\u00e9todos de autentica\u00e7\u00e3o e configura\u00e7\u00e3o por cliente;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/pt\/docs\/mcp-tools-reference\/\" target=\"_blank\" rel=\"noopener\">Refer\u00eancia \u00e0s ferramentas MCP do MemberPress AI Foundation<\/a><\/strong> \u2014 escopos, recursos e esquemas por ferramenta;<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/memberpress.com\/pt\/docs\/ai-foundation-safety-measures\/\" target=\"_blank\" rel=\"noopener\">Medidas de seguran\u00e7a para agentes da MemberPress AI Foundation<\/a><\/strong> \u2014 as quatro medidas respons\u00e1veis pelos erros na camada de seguran\u00e7a.<\/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\/pt\/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=\"pt_BR\" \/>\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\/pt\/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\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#article\",\"name\":\"MemberPress MCP Errors and Troubleshooting | MemberPress\",\"headline\":\"MemberPress MCP Errors and Troubleshooting\",\"author\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\"},\"publisher\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/#organization\"},\"image\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/memberpress.com\\\/wp-content\\\/uploads\\\/2022\\\/10\\\/mp-icon-RGB_Icon-01.jpg\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/#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\":\"pt-BR\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\"},\"isPartOf\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\"},\"articleSection\":\"MCP\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#breadcrumblist\",\"itemListElement\":[{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt#listItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/memberpress.com\\\/pt\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"name\":\"Developer Documentation\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"position\":2,\"name\":\"Developer Documentation\",\"item\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/developer-docs\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/mcp\\\/#listItem\",\"name\":\"MCP\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt#listItem\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/mcp\\\/#listItem\",\"position\":3,\"name\":\"MCP\",\"item\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/mcp\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#listItem\",\"name\":\"MemberPress MCP Errors and Troubleshooting\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/developer-docs\\\/#listItem\",\"name\":\"Developer Documentation\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#listItem\",\"position\":4,\"name\":\"MemberPress MCP Errors and Troubleshooting\",\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/doc-categories\\\/mcp\\\/#listItem\",\"name\":\"MCP\"}}]},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/#organization\",\"name\":\"MemberPress\",\"description\":\"The All-In-One WordPress Membership Plugin\",\"url\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/memberpress.com\\\/wp-content\\\/uploads\\\/2022\\\/10\\\/mp-icon-RGB_Icon-01.jpg\",\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#organizationLogo\",\"width\":1650,\"height\":1275,\"caption\":\"memberpress logo icon\"},\"image\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/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\\\/pt\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\",\"url\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/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\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#webpage\",\"url\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/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\":\"pt-BR\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/#website\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/docs\\\/mcp-errors-troubleshooting\\\/#breadcrumblist\"},\"author\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/blog\\\/author\\\/nikolacaseproof-com\\\/#author\"},\"creator\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/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\\\/pt\\\/#website\",\"url\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/\",\"name\":\"MemberPress\",\"description\":\"The All-In-One WordPress Membership Plugin\",\"inLanguage\":\"pt-BR\",\"publisher\":{\"@id\":\"https:\\\/\\\/memberpress.com\\\/pt\\\/#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":"Erros e solu\u00e7\u00e3o de problemas do MCP MemberPress | MemberPress","description":"O servidor MCP da MemberPress AI Foundation retorna erros estruturados quando uma solicita\u00e7\u00e3o falha na autentica\u00e7\u00e3o, excede um limite de taxa, n\u00e3o possui escopo ou capacidade, ou chega enquanto as grava\u00e7\u00f5es destrutivas est\u00e3o em pausa. Cada erro cont\u00e9m um c\u00f3digo que um cliente de IA ou desenvolvedor pode identificar. Esta refer\u00eancia cataloga os c\u00f3digos de erro gerados pelo servidor MCP e mostra o que os aciona","canonical_url":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#article","name":"MemberPress MCP Errors and Troubleshooting | MemberPress","headline":"MemberPress MCP Errors and Troubleshooting","author":{"@id":"https:\/\/memberpress.com\/pt\/blog\/author\/nikolacaseproof-com\/#author"},"publisher":{"@id":"https:\/\/memberpress.com\/pt\/#organization"},"image":{"@type":"ImageObject","url":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","@id":"https:\/\/memberpress.com\/pt\/#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":"pt-BR","mainEntityOfPage":{"@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#webpage"},"isPartOf":{"@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#webpage"},"articleSection":"MCP"},{"@type":"BreadcrumbList","@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#breadcrumblist","itemListElement":[{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt#listItem","position":1,"name":"Home","item":"https:\/\/memberpress.com\/pt","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/developer-docs\/#listItem","name":"Developer Documentation"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/developer-docs\/#listItem","position":2,"name":"Developer Documentation","item":"https:\/\/memberpress.com\/pt\/doc-categories\/developer-docs\/","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/mcp\/#listItem","name":"MCP"},"previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt#listItem","name":"Home"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/mcp\/#listItem","position":3,"name":"MCP","item":"https:\/\/memberpress.com\/pt\/doc-categories\/mcp\/","nextItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#listItem","name":"MemberPress MCP Errors and Troubleshooting"},"previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/developer-docs\/#listItem","name":"Developer Documentation"}},{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#listItem","position":4,"name":"MemberPress MCP Errors and Troubleshooting","previousItem":{"@type":"ListItem","@id":"https:\/\/memberpress.com\/pt\/doc-categories\/mcp\/#listItem","name":"MCP"}}]},{"@type":"Organization","@id":"https:\/\/memberpress.com\/pt\/#organization","name":"MemberPress","description":"The All-In-One WordPress Membership Plugin","url":"https:\/\/memberpress.com\/pt\/","logo":{"@type":"ImageObject","url":"https:\/\/memberpress.com\/wp-content\/uploads\/2022\/10\/mp-icon-RGB_Icon-01.jpg","@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#organizationLogo","width":1650,"height":1275,"caption":"memberpress logo icon"},"image":{"@id":"https:\/\/memberpress.com\/pt\/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\/pt\/blog\/author\/nikolacaseproof-com\/#author","url":"https:\/\/memberpress.com\/pt\/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\/pt\/docs\/mcp-errors-troubleshooting\/#webpage","url":"https:\/\/memberpress.com\/pt\/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":"pt-BR","isPartOf":{"@id":"https:\/\/memberpress.com\/pt\/#website"},"breadcrumb":{"@id":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/#breadcrumblist"},"author":{"@id":"https:\/\/memberpress.com\/pt\/blog\/author\/nikolacaseproof-com\/#author"},"creator":{"@id":"https:\/\/memberpress.com\/pt\/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\/pt\/#website","url":"https:\/\/memberpress.com\/pt\/","name":"MemberPress","description":"The All-In-One WordPress Membership Plugin","inLanguage":"pt-BR","publisher":{"@id":"https:\/\/memberpress.com\/pt\/#organization"}}]},"og:locale":"pt_BR","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\/pt\/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\/pt\" title=\"Home\">Home<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/memberpress.com\/pt\/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\/pt\/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\/pt"},{"label":"Developer Documentation","link":"https:\/\/memberpress.com\/pt\/doc-categories\/developer-docs\/"},{"label":"MCP","link":"https:\/\/memberpress.com\/pt\/doc-categories\/mcp\/"},{"label":"MemberPress MCP Errors and Troubleshooting","link":"https:\/\/memberpress.com\/pt\/docs\/mcp-errors-troubleshooting\/"}],"_links":{"self":[{"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb\/81434","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/users\/62252"}],"replies":[{"embeddable":true,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/comments?post=81434"}],"version-history":[{"count":1,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb\/81434\/revisions"}],"predecessor-version":[{"id":81511,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb\/81434\/revisions\/81511"}],"wp:attachment":[{"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/media?parent=81434"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb-category?post=81434"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/memberpress.com\/pt\/wp-json\/wp\/v2\/ht-kb-tag?post=81434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}