🎋

docs/publishing/guides/existing-openapi-service.mdx

@@ -139,6 +139,12 @@ Every time you make a change to your project, you can run `agentic deploy` which
   prioritize this feature.
 </Info>
 
+<Note>
+  The returned deployment will not have any information about your origin
+  server, because the origin is considered hidden once deployed to Agentic's MCP
+  gateway.
+</Note>
+
 <Expandable title="example output">
 
 <Note>

packages/platform/src/origin-adapters/mcp.ts

@@ -28,7 +28,14 @@ export async function resolveMCPOriginAdapter({
   )
   const transport = new StreamableHTTPClientTransport(new URL(origin.url))
   const client = new McpClient({ name, version })
-  await client.connect(transport)
+  try {
+    await client.connect(transport)
+  } catch (err: any) {
+    throw new Error(
+      `Failed to connect to MCP server at ${origin.url} using the Streamable HTTP transport.Make sure your MCP server is running and accessible, and that your URL is using the correct path (/, /mcp, etc): ${err.message}`,
+      { cause: err }
+    )
+  }
 
   const serverInfo = {
     name,