{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/mcp/mcp.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Troubleshooting and FAQ"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting-and-faq","__idx":0},"children":["Troubleshooting and FAQ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fixes for common connection problems, and answers to frequent questions about the iClosed MCP server."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":1},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Problem"},"children":["Problem"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"AI assistants are turned off for this workspace\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MCP is off for the workspace. Ask your account owner or a super admin to turn it on in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Developer → MCP"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow access is missing on the consent screen"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usually the same cause: MCP is off for this workspace. Read the notice on the consent screen."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection refused, timeout, or \"authentication not detected\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the URL is exactly ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.iclosed.io/mcp"]},", including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]},". Check that your VPN, proxy or firewall allows HTTPS to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.iclosed.io"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client asks for an API key or headers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Leave them empty. iClosed MCP uses OAuth sign-in only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consent screen never opens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Finish any \"continue connecting\" step in the browser. Allow pop-ups for your assistant and iClosed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connected to the wrong workspace"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revoke the connection, sign in to iClosed as the right user, and connect again. Pick the right workspace on the consent screen."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in loop or \"unauthorized\" after it worked before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your access was revoked or expired. Remove the server from your assistant, add it again, and sign in. In Cursor or VS Code, also clear the server's saved sign-in, or restart the app."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tools never run"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the server shows as connected. Mention iClosed in your prompt. In Cursor and VS Code, use Agent mode."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A tool fails with \"insufficient scope\" or \"forbidden\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You didn't approve that scope, or your iClosed role doesn't allow the action. Reconnect and approve the scope, or ask an admin about your role."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Writes don't happen"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the tool isn't blocked in your assistant's tool permissions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You hit the limit of 20 requests per 10 seconds. Wait for the time in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]},", then try again. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/rate-limiting"},"children":["Rate limiting"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client only supports local (stdio) servers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-remote"]}," bridge. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/mcp/mcp-connectors/other-clients#clients-that-only-support-local-stdio-servers"},"children":["Other clients"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"faq","__idx":2},"children":["FAQ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do I need an API key?"]}," ","No. You sign in with your iClosed account. API keys are for calling the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference"},"children":["REST API"]}," directly."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Which plans include MCP?"]}," ","All iClosed plans. An account owner or super admin still has to turn MCP on before members can connect."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do I need to register an OAuth client?"]}," ","No. Your assistant registers itself automatically. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Developer → OAuth Clients"]}," is for developers building their own apps."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can the assistant see data my role can't?"]}," ","No. It acts as you and can only do what your iClosed role allows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Is the tool list the same in every assistant?"]}," ","Yes. Clients may display the names differently. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/mcp/tools"},"children":["Tools"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can I connect more than one assistant?"]}," ","Yes. Each one appears separately in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Developer → Connected apps"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Does iClosed see my prompts?"]}," ","No. iClosed only receives the tool calls the assistant makes, such as \"list contacts\". Your conversation stays with the assistant's provider."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How do I disconnect?"]}," ","Revoke the app in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Developer → Connected apps"]},", and remove the connector from the assistant."]}]},"headings":[{"value":"Troubleshooting and FAQ","id":"troubleshooting-and-faq","depth":1},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"FAQ","id":"faq","depth":2}],"frontmatter":{"sidebar":{"path":"./mcp.sidebars.yaml"},"seo":{"title":"Troubleshooting and FAQ"}},"lastModified":"2026-10-07T07:39:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/mcp/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}