Fixes for common connection problems, and answers to frequent questions about the iClosed MCP server.
| Problem | What to do |
|---|---|
| "AI assistants are turned off for this workspace" | MCP is off for the workspace. Ask your account owner or a super admin to turn it on in Settings → Developer → MCP. |
| Allow access is missing on the consent screen | Usually the same cause: MCP is off for this workspace. Read the notice on the consent screen. |
| Connection refused, timeout, or "authentication not detected" | Check the URL is exactly https://mcp.iclosed.io/mcp, including /mcp. Check that your VPN, proxy or firewall allows HTTPS to mcp.iclosed.io. |
| Client asks for an API key or headers | Leave them empty. iClosed MCP uses OAuth sign-in only. |
| Consent screen never opens | Finish any "continue connecting" step in the browser. Allow pop-ups for your assistant and iClosed. |
| Connected to the wrong workspace | Revoke the connection, sign in to iClosed as the right user, and connect again. Pick the right workspace on the consent screen. |
| Sign-in loop or "unauthorized" after it worked before | 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. |
| Tools never run | Check the server shows as connected. Mention iClosed in your prompt. In Cursor and VS Code, use Agent mode. |
| A tool fails with "insufficient scope" or "forbidden" | 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. |
| Writes don't happen | Check the tool isn't blocked in your assistant's tool permissions. |
429 Too Many Requests | You hit the limit of 20 requests per 10 seconds. Wait for the time in Retry-After, then try again. See Rate limiting. |
| Client only supports local (stdio) servers | Use the mcp-remote bridge. See Other clients. |
Do I need an API key? No. You sign in with your iClosed account. API keys are for calling the REST API directly.
Which plans include MCP? All iClosed plans. An account owner or super admin still has to turn MCP on before members can connect.
Do I need to register an OAuth client? No. Your assistant registers itself automatically. Settings → Developer → OAuth Clients is for developers building their own apps.
Can the assistant see data my role can't? No. It acts as you and can only do what your iClosed role allows.
Is the tool list the same in every assistant? Yes. Clients may display the names differently. See Tools.
Can I connect more than one assistant? Yes. Each one appears separately in Settings → Developer → Connected apps.
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.
How do I disconnect? Revoke the app in Settings → Developer → Connected apps, and remove the connector from the assistant.