Troubleshooting

Common issues when connecting to ZopNight's MCP server and how to resolve them.

401 Unauthorized

Your token is invalid or expired. Go to Developer Settings and create a new token.

"MCP server is not enabled for this organisation"

An admin needs to enable MCP for this organisation. Go to Settings → Organisation and toggle MCP Server to ON. See the overview for detailed steps.

"org_id is required"

The tool call is missing the org_id argument. Ask your AI assistant to call list_organisations first, then use the org ID in subsequent calls.

"you don't have access to this organisation"

You are not a member of the requested organisation, or you have been removed. Check your organisation membership in ZopNight.

Connection refused or timeout

Make sure you are using the correct Server URL. The URL is shown in the Developer Settings page after creating a token, and in Settings → Organisation when MCP is enabled. Ensure you are using HTTP transport, not SSE or WebSocket.

Claude Code shows "not authenticated"

Claude Code's HTTP transport may try OAuth before using headers. Use the CLI command with -t http flag to force HTTP transport:

claude mcp add zopnight <url> -t http -H "Authorization: Bearer <token>"

See the Claude Code setup guide for full instructions.