diff --git a/platform/hosted-mcp.mdx b/platform/hosted-mcp.mdx
index 960aa3e..525d3ef 100644
--- a/platform/hosted-mcp.mdx
+++ b/platform/hosted-mcp.mdx
@@ -294,6 +294,9 @@ Seeing the tools doesn't prove repository access. The last step does. For test p
   <Accordion title="The client shows &quot;needs authentication&quot;">
     Run the client's sign-in step: `/mcp` → Authenticate, or `codex mcp login graphify`.
   </Accordion>
+  <Accordion title="Verify your email to connect">
+    You're signed in, but the account's email isn't verified yet. Open the verification link Graphify emailed you (or use **Resend the verification email**), then connect again from your client. If you signed up with Google or GitHub, choose that option when you connect.
+  </Accordion>
   <Accordion title="list_repositories is empty">
     You're in a workspace with no indexed repositories. Switch with `set_workspace`.
   </Accordion>
diff --git a/platform/support/troubleshooting.mdx b/platform/support/troubleshooting.mdx
index 86fb4b2..03c0570 100644
--- a/platform/support/troubleshooting.mdx
+++ b/platform/support/troubleshooting.mdx
@@ -30,6 +30,10 @@ Your client hasn't finished the one-time browser sign-in. Graphify answers a req
 
 See [Hosted MCP](/platform/hosted-mcp#how-hosted-mcp-sign-in-works) for how sign-in works.
 
+### "Verify your email to connect"
+
+You're signed in, but your Graphify account's email address isn't verified yet. Open the verification link from the email Graphify sent, or select **Resend the verification email** on that page, then connect again from your app. If you signed up with Google or GitHub, choose that option when you connect instead of email and password.
+
 ### invalid_grant: "Refresh token superseded; retry the login."
 
 Several agent sessions shared one stored login and refreshed at the same time. Only one refresh wins. Sign in again from the client that failed.