Skip to main content
If your client can’t establish a connection, work through the checks below in order.

​
1. Verify your server is published

Only published versions can be accessed by MCP clients. If your server only has draft changes, publish a version before attempting to connect.
Creating or editing a draft does not update the live MCP endpoint.

​
2. Check that serving is enabled

If your server is paused, it won’t accept incoming MCP requests. Resume serving and try connecting again.

​
3. Verify the endpoint

Open the Setup page and copy the endpoint again. Small differences in the URL, such as an incorrect hostname or path, can prevent clients from connecting.

​
4. Verify the transport

0mcp uses Streamable HTTP. Make sure your MCP client is configured to use the hosted HTTP endpoint instead of a local command or an unsupported transport.
Do not place a hosted 0mcp URL in a client field that expects a local command.

​
5. Review authentication

If your server requires authentication, confirm that:
  • Required environment variables are configured.
  • Authentication headers are present.
  • Credentials are valid.
See Authentication errors if requests are being rejected with 401 or 403.

​
6. Restart your client

Many MCP clients load their configuration only when they start. After updating your configuration or credentials, restart or reconnect the client before testing again.

​
7. Check the logs

Open Logs and look for activity at the time you attempted to connect.
  • A matching log entry exists: The request reached 0mcp. Review the error details to continue troubleshooting.
  • No log entry exists: The request never reached 0mcp. The problem is likely in the client configuration, network, DNS, or endpoint URL.
No matching log entry is a useful signal. Check the client and network path before changing your tools or upstream API.

​
Common HTTP responses

StatusWhat it usually means
404 Not FoundThe endpoint or hostname is incorrect.
401 UnauthorizedAuthentication credentials are missing or invalid.
403 ForbiddenThe credentials don’t have permission to access the requested resource.
503 Service UnavailableThe server is paused or temporarily unavailable.

​
Using a custom domain

If you’re connecting through a custom domain:
  • Wait until the domain status is Active.
  • Update your client to use the custom endpoint.
  • Verify that DNS propagation and TLS provisioning have completed before reconnecting.