diff --git a/docs/ai/mcp.mdx b/docs/ai/mcp.mdx
index 4212d424e7068..0fc009555f85a 100644
--- a/docs/ai/mcp.mdx
+++ b/docs/ai/mcp.mdx
@@ -41,7 +41,7 @@ Or add it manually to your client's MCP configuration:
 ```json
 {
   "mcpServers": {
-    "Sentry": {
+    "sentry": {
       "url": "https://mcp.sentry.dev/mcp"
     }
   }
@@ -50,6 +50,8 @@ Or add it manually to your client's MCP configuration:
 
 When you first connect, you'll be prompted to log in with your Sentry organization and grant access. During authentication, you select which tool groups to expose — this keeps the context window focused on the tools you actually need.
 
+The Cloud transport requires your client to support OAuth and Streamable HTTP. All clients listed under [Client Instructions](#client-instructions) support this natively — if yours doesn't, use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge or the [Stdio Transport](#stdio-transport) instead.
+
 ![Available Sentry MCP Tools](./img/mcp-tools.png)
 
 See [Client Instructions](#client-instructions) for setup steps specific to your editor or IDE.
@@ -78,7 +80,7 @@ Add the server to your client's MCP configuration:
 ```json
 {
   "mcpServers": {
-    "Sentry": {
+    "sentry": {
       "command": "npx",
       "args": ["@sentry/mcp-server@latest"]
     }
@@ -141,7 +143,7 @@ JSON config for clients that support it:
 ```json
 {
   "mcpServers": {
-    "Sentry": {
+    "sentry": {
       "command": "npx",
       "args": [
         "@sentry/mcp-server@latest",
@@ -208,7 +210,7 @@ You can also edit your `mcp.json` directly:
 ```json
 {
   "mcpServers": {
-    "Sentry": {
+    "sentry": {
       "url": "https://mcp.sentry.dev/mcp"
     }
   }
@@ -226,7 +228,7 @@ Open `CMD + ,` → `Developer` → `Edit Config`, then add to `claude_desktop_co
 ```json
 {
   "mcpServers": {
-    "Sentry": {
+    "sentry": {
       "url": "https://mcp.sentry.dev/mcp"
     }
   }
@@ -293,7 +295,7 @@ Go to `Settings` → `MCP Servers` → `+ Add` → **Streamable HTTP or SSE Serv
 
 ```json
 {
-  "Sentry": {
+  "sentry": {
     "url": "https://mcp.sentry.dev/mcp"
   }
 }
@@ -335,7 +337,7 @@ Open the MCP menu with `/mcp` → `Add MCP Server from Registry` → search for
 
 <Expandable title="Setup Instructions" group="clients">
 
-In the [v0.app](https://v0.app) UI: `Prompt Tools` → `Add MCP` → select Sentry.
+In the [v0.app](https://v0.app) UI: `Account Settings` → `Integrations` → under **MCP Connections** click `Add MCP` → search for Sentry.
 
 </Expandable>
 
@@ -388,14 +390,15 @@ The [Sentry MCP page](https://mcp.sentry.dev) has a web interface where you can
 
 **OAuth Authentication Problems**
 
-- Ensure your client supports OAuth
+- Ensure your client supports OAuth and Streamable HTTP — if it doesn't, use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge or the [Stdio Transport](#stdio-transport)
 - Check that you have the right permissions in your Sentry organization
+- Verify the URL is exactly `https://mcp.sentry.dev/mcp`
 - Try reauthenticating (see below)
 
 **Reauthenticating in Claude Code**
 
 1. Type `/mcp` in the Claude Code prompt
-2. Select the **Sentry** server
+2. Select the **sentry** server
 3. Choose **"Clear authentication"** or **"Authenticate"** to re-trigger OAuth
 
 **Reauthenticating in OpenCode**
@@ -406,7 +409,7 @@ The [Sentry MCP page](https://mcp.sentry.dev) has a web interface where you can
 
 **Reauthenticating in Factory Droid**
 
-1. Type `/mcp` → select **Sentry** → **"Reauthenticate"**
+1. Type `/mcp` → select **sentry** → **"Reauthenticate"**
 
 **Connection Issues**