Master MCP Server

import{_ as o,c as a,o as t,a6 as i}from"./chunks/framework.CHl2ywxc.js";const m=JSON.parse('{"title":"Troubleshooting: Common Issues","description":"","frontmatter":{},"headers":[],"relativePath":"troubleshooting/common-issues.md","filePath":"troubleshooting/common-issues.md","lastUpdated":1755281500000}'),r={name:"troubleshooting/common-issues.md"};function s(n,e,l,d,c,u){return t(),a("div",null,e[0]||(e[0]=[i('<h1 id="troubleshooting-common-issues" tabindex="-1">Troubleshooting: Common Issues <a class="header-anchor" href="#troubleshooting-common-issues" aria-label="Permalink to &quot;Troubleshooting: Common Issues&quot;">​</a></h1><h2 id="config-validation-failed" tabindex="-1">Config validation failed <a class="header-anchor" href="#config-validation-failed" aria-label="Permalink to &quot;Config validation failed&quot;">​</a></h2><ul><li>Error shows <code>&lt;path&gt;: &lt;reason&gt;</code> from <code>SchemaValidator</code></li><li>Verify your file is valid JSON/YAML</li><li>Check required fields under <code>master_oauth</code>, <code>hosting</code>, <code>servers</code></li></ul><h2 id="missing-token-enc-key-in-production" tabindex="-1">Missing TOKEN_ENC_KEY in production <a class="header-anchor" href="#missing-token-enc-key-in-production" aria-label="Permalink to &quot;Missing TOKEN_ENC_KEY in production&quot;">​</a></h2><ul><li>Set <code>TOKEN_ENC_KEY</code> to a strong random string</li><li>In development, an ephemeral key is generated with a warning</li></ul><h2 id="oauth-callback-mismatch" tabindex="-1">OAuth callback mismatch <a class="header-anchor" href="#oauth-callback-mismatch" aria-label="Permalink to &quot;OAuth callback mismatch&quot;">​</a></h2><ul><li>Ensure <code>master_oauth.redirect_uri</code> matches your runtime base URL</li><li>If behind a proxy, set <code>MASTER_BASE_URL</code> to the external URL</li></ul><h2 id="_401-unauthorized-to-backends" tabindex="-1">401 Unauthorized to backends <a class="header-anchor" href="#_401-unauthorized-to-backends" aria-label="Permalink to &quot;401 Unauthorized to backends&quot;">​</a></h2><ul><li>Ensure client token is valid or delegated tokens are stored</li><li>For delegated flows, complete <code>/oauth/authorize</code> and <code>/oauth/callback</code> first</li></ul><h2 id="workers-runtime-odd-redirects" tabindex="-1">Workers runtime odd redirects <a class="header-anchor" href="#workers-runtime-odd-redirects" aria-label="Permalink to &quot;Workers runtime odd redirects&quot;">​</a></h2><ul><li>Always set <code>hosting.base_url</code> in Workers to generate correct absolute URLs</li></ul>',11)]))}const _=o(r,[["render",s]]);export{m as __pageData,_ as default};