{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Troubleshooting"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common issues with the eGain MCP and how to fix them."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact Support before you set up Remote MCP"]}," ","For versions 21.24 and earlier, Remote MCP is not available in all customer environments. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]}," to enable Remote MCP for your tenant or to confirm availability for your environment."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection-and-sign-in","__idx":1},"children":["Connection and Sign-In"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-connector-fails-to-connect","__idx":2},"children":["The connector fails to connect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most common cause: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remote MCP is not enabled in your eGain Administration Console."]}," Enabling it is what registers your tenant with the MCP server — including the details your AI client needs to sign you in. Until then, authentication cannot start."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fix:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Administration Console, confirm the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Remote MCP"]}," toggle is on."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Re-copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server URL"]}," and reconnect in your AI client."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]}," page or the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Remote MCP"]}," toggle isn't in your Administration Console, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]}," to enable Remote MCP or confirm availability."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mcp-is-disabled-for-this-tenant","__idx":3},"children":["\"MCP is disabled for this tenant\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remote MCP was turned off in the Administration Console. Turn the toggle back on and retry."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tenant-not-found","__idx":4},"children":["Tenant not found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tenant not found"]}," usually means the MCP Server URL does not match a registered tenant. Check for a typo in the tenant ID, a typo in the MCP hostname, the wrong environment, or extra whitespace when pasting the URL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If Remote MCP was never enabled for that partition, the tenant is not registered with the MCP server. Turn on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Remote MCP"]},", re-copy the MCP Server URL from the Administration Console, and reconnect."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"asked-to-sign-in-again","__idx":5},"children":["Asked to sign in again"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sessions expire by design. Your AI client may prompt you to sign in again automatically — just complete the sign-in. If it keeps looping, disconnect the connector and reconnect."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-log-out-or-reconnect","__idx":6},"children":["How to log out or reconnect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Disconnect the connector in your AI client (in Claude: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connectors"]}," → disconnect), then reconnect and sign in again. This is also the fix when switching to a different eGain tenant — reconnect with the new tenant's MCP Server URL."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"access-and-results","__idx":7},"children":["Access and Results"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"forbidden-or-permission-errors","__idx":8},"children":["Forbidden or permission errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your eGain account doesn't have access to that portal or article. The MCP only sees what your account can see. Ask your eGain administrator to check your portal access and your client app's API permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"signed-in-but-only-seeing-public-content","__idx":9},"children":["Signed in, but only seeing public content"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You likely connected with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["anonymous"]}," MCP URL. Anonymous connections only return publicly available content — even if you signed in. Disconnect and reconnect using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["authenticated"]}," MCP Server URL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authoring-tools-are-missing","__idx":10},"children":["Authoring tools are missing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If authoring tools such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create-article"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-folders"]}," don't appear or don't work, check that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authoring early access is enabled for your tenant. To request it, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You connected with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent"]}," MCP Server URL. Authenticated Customer and Anonymous Customer connections don't include authoring tools."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your eGain user has the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Author"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Knowledge Base Manager"]}," role."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors-and-getting-help","__idx":11},"children":["Errors and Getting Help"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sign-in-and-server-errors","__idx":12},"children":["Sign-in and server errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token_exchange_failed"]}," means sign-in could not be completed during the OAuth token exchange. Check the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_description"]}," shown by your AI client. Retry once after a moment. If it persists, disconnect and reconnect using a freshly copied MCP Server URL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Persistent failures usually point to a misconfigured client app or an expired authorization code, not a temporary server issue."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reporting-an-issue","__idx":13},"children":["Reporting an issue"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remote MCP server logs are not user-accessible. When contacting support, include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The full error code and message shown by your AI client or tool result"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The MCP Server URL you connected with"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What you were trying to do, including the tool and portal if known"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When it happened, including your timezone"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://media.egain.com/support/self-provisioned.asp"},"children":["Contact Support"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"local-mcp","__idx":14},"children":["Local MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These apply only if you run the open-source MCP server locally. For the full local guide, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/eGain/egain-mcp-server/blob/main/help/faq.md"},"children":["FAQ & Troubleshooting page on GitHub"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-fails","__idx":15},"children":["Authentication fails"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The most common cause is a wrong or missing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--api-domain"]}," in your MCP configuration file. Find your API Domain in the Administration Console under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partition"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Application"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metadata"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The browser sign-in window times out after ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2 minutes"]}," for security. If you miss it, retry and complete sign-in promptly."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-log-out","__idx":16},"children":["How to log out"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any of these works:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run the logout script: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["node scripts/logout.js"]}," (removes the saved token and cached files)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delete the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".bearer_token"]}," files manually"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the token to expire (about 1 hour default) — the next request triggers a fresh sign-in"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"where-to-find-logs","__idx":17},"children":["Where to find logs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The local server writes logs through your AI client's MCP integration. Common locations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Desktop (macOS):"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/Library/Logs/Claude/mcp*.log"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Desktop (Windows):"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["%APPDATA%\\Claude\\logs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other clients, including Cursor:"]}," check your client's MCP or developer documentation for log paths"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more detail, start the server with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--log-level debug"]},". See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/eGain/egain-mcp-server/blob/main/help/faq.md"},"children":["FAQ & Troubleshooting page on GitHub"]}," for client-specific guidance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"other-known-issues","__idx":18},"children":["Other known issues"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Covered in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/eGain/egain-mcp-server/blob/main/help/faq.md"},"children":["GitHub FAQ"]},": Node version conflicts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx"]},", Safari not being supported for sign-in, macOS Automation permissions, and needing to fully restart your AI client after configuration changes."]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Connection and Sign-In","id":"connection-and-sign-in","depth":2},{"value":"The connector fails to connect","id":"the-connector-fails-to-connect","depth":3},{"value":"\"MCP is disabled for this tenant\"","id":"mcp-is-disabled-for-this-tenant","depth":3},{"value":"Tenant not found","id":"tenant-not-found","depth":3},{"value":"Asked to sign in again","id":"asked-to-sign-in-again","depth":3},{"value":"How to log out or reconnect","id":"how-to-log-out-or-reconnect","depth":3},{"value":"Access and Results","id":"access-and-results","depth":2},{"value":"Forbidden or permission errors","id":"forbidden-or-permission-errors","depth":3},{"value":"Signed in, but only seeing public content","id":"signed-in-but-only-seeing-public-content","depth":3},{"value":"Authoring tools are missing","id":"authoring-tools-are-missing","depth":3},{"value":"Errors and Getting Help","id":"errors-and-getting-help","depth":2},{"value":"Sign-in and server errors","id":"sign-in-and-server-errors","depth":3},{"value":"Reporting an issue","id":"reporting-an-issue","depth":3},{"value":"Local MCP","id":"local-mcp","depth":2},{"value":"Authentication fails","id":"authentication-fails","depth":3},{"value":"How to log out","id":"how-to-log-out","depth":3},{"value":"Where to find logs","id":"where-to-find-logs","depth":3},{"value":"Other known issues","id":"other-known-issues","depth":3}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-10-12T19:03:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/mcp/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}