feat: multi-remote server selection for external MCPs (#1792)

## Summary
- Adds support for MCP servers that have multiple remote endpoints (like
Salesforce which has different remotes for different sub apis)
- Users can now select which remote endpoints to include when adding
such servers to their project
- Adds new `selectRemotes` workflow phase for configuring multi-remote
servers before deployment
- **Backend now stores and uses selected remotes during deployment
processing**

## Changes
- **API**: Added `ExternalMCPRemote` type and `remotes` field to
`ExternalMCPServer` in Goa design
- **API**: Added `selected_remotes` field to `AddExternalMCPForm` for
storing user selections
- **Backend**: Updated SQL queries to store `selected_remotes` in
`external_mcp_attachments`
- **Backend**: Modified `GetServerDetails` to filter remotes based on
user selection
- **Backend**: Pass selected remotes through ToolExtractor during
deployment
- **Frontend**: Added `selectRemotes` phase to the workflow for
multi-remote server configuration
- **Frontend**: Added UI for selecting which remote endpoints to
include, with friendly display names for known services (Salesforce
sub-APIs)
- **Frontend**: Added `goBack` navigation to return from configure phase
to selectRemotes phase
- **Frontend**: Now sends selected remote URLs to backend on deployment

## Dependencies
- Requires migration PR #1793 to be merged first (adds
`selected_remotes` column)

## Test plan
- [ ] Merge migration PR #1793 first
- [ ] Add a Salesforce MCP server from the catalog
- [ ] Verify the remote selection UI appears with all available
endpoints
- [ ] Verify friendly names are shown for Salesforce environments
- [ ] Verify deselecting some endpoints and deploying works correctly
- [ ] Verify the backend uses only the selected remotes during tool
extraction
- [ ] Verify the "Back" button returns to remote selection from the
configure phase

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Quinn Stearns <quinn@speakeasy.com>

Author: 3 people

.speakeasy/out.openapi.yaml

@@ -5869,6 +5869,120 @@ paths:
       tags:
         - mcpMetadata
       x-speakeasy-name-override: set
+  /rpc/mcpRegistries.getServerDetails:
+    get:
+      description: Get detailed information about an MCP server including remotes
+      operationId: getMCPServerDetails
+      parameters:
+        - allowEmptyValue: true
+          description: ID of the registry
+          in: query
+          name: registry_id
+          required: true
+          schema:
+            description: ID of the registry
+            format: uuid
+            type: string
+        - allowEmptyValue: true
+          description: Server specifier (e.g., 'io.github.user/server')
+          in: query
+          name: server_specifier
+          required: true
+          schema:
+            description: Server specifier (e.g., 'io.github.user/server')
+            type: string
+        - allowEmptyValue: true
+          description: Session header
+          in: header
+          name: Gram-Session
+          schema:
+            description: Session header
+            type: string
+        - allowEmptyValue: true
+          description: API Key header
+          in: header
+          name: Gram-Key
+          schema:
+            description: API Key header
+            type: string
+        - allowEmptyValue: true
+          description: project header
+          in: header
+          name: Gram-Project
+          schema:
+            description: project header
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ExternalMCPServer'
+          description: OK response.
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'bad_request: request is invalid'
+        "401":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'unauthorized: unauthorized access'
+        "403":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'forbidden: permission denied'
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'not_found: resource not found'
+        "409":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'conflict: resource already exists'
+        "415":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'unsupported_media: unsupported media type'
+        "422":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'invalid: request contains one or more invalidation fields'
+        "500":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'unexpected: an unexpected error occurred'
+        "502":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+          description: 'gateway_error: an unexpected error occurred'
+      security:
+        - project_slug_header_Gram-Project: []
+          session_header_Gram-Session: []
+        - apikey_header_Gram-Key: []
+          project_slug_header_Gram-Project: []
+        - {}
+      summary: getServerDetails mcpRegistries
+      tags:
+        - mcpRegistries
+      x-speakeasy-name-override: getServerDetails
   /rpc/mcpRegistries.listCatalog:
     get:
       description: List available MCP servers from configured registries
@@ -12164,6 +12278,13 @@ components:
           type: string
           description: The canonical server name used to look up the server in the registry (e.g., 'slack', 'ai.exa/exa').
           example: slack
+        selected_remotes:
+          type: array
+          items:
+            type: string
+          description: URLs of the remotes to use for this MCP server. If not provided, the backend will auto-select based on transport type preference.
+          example:
+            - https://mcp.example.com/sse
         slug:
           type: string
           description: A short url-friendly label that uniquely identifies a resource.
@@ -13853,6 +13974,23 @@ components:
         - header_name
         - required
         - secret
+    ExternalMCPRemote:
+      type: object
+      properties:
+        transport_type:
+          type: string
+          description: Transport type (sse or streamable-http)
+          enum:
+            - sse
+            - streamable-http
+        url:
+          type: string
+          description: URL of the remote endpoint
+          format: uri
+      description: A remote endpoint for an MCP server
+      required:
+        - url
+        - transport_type
     ExternalMCPServer:
       type: object
       properties:
@@ -13873,6 +14011,11 @@ components:
           type: string
           description: Server specifier used to look up in the registry (e.g., 'io.github.user/server')
           example: io.modelcontextprotocol.anonymous/exa
+        remotes:
+          type: array
+          items:
+            $ref: '#/components/schemas/ExternalMCPRemote'
+          description: Available remote endpoints for the server
         title:
           type: string
           description: Display name for the server

.speakeasy/workflow.lock

@@ -2,19 +2,17 @@ speakeasyVersion: 1.700.2
 sources:
     Gram-Internal:
         sourceNamespace: gram-api-description
-        sourceRevisionDigest: sha256:62b46b18ae06f666f1a67c0de57aceab4645753f186576c9b21110a9ae41cab1
-        sourceBlobDigest: sha256:33c27aa018dc73e73a35889d75cee2d352788284794361f0194c3d24ba7d5c7f
+        sourceRevisionDigest: sha256:c747d9b735a72b0efa38e98bebf8551d87ce6845103a26c5832d48351777e5ce
+        sourceBlobDigest: sha256:3cc940413a9ed86217b0f103a47bb8d9f628cbb9f97b3476ca237d95aff1b0b4
         tags:
             - latest
             - 0.0.1
 targets:
     gram-internal:
         source: Gram-Internal
         sourceNamespace: gram-api-description
-        sourceRevisionDigest: sha256:62b46b18ae06f666f1a67c0de57aceab4645753f186576c9b21110a9ae41cab1
-        sourceBlobDigest: sha256:33c27aa018dc73e73a35889d75cee2d352788284794361f0194c3d24ba7d5c7f
-        codeSamplesNamespace: gram-api-description-typescript-code-samples
-        codeSamplesRevisionDigest: sha256:3226bb17f37d693bdee3cb0bf7865d766e95249cb1ec0f68de7cf7fd1bc1ee3f
+        sourceRevisionDigest: sha256:c747d9b735a72b0efa38e98bebf8551d87ce6845103a26c5832d48351777e5ce
+        sourceBlobDigest: sha256:3cc940413a9ed86217b0f103a47bb8d9f628cbb9f97b3476ca237d95aff1b0b4
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: pinned

client/dashboard/src/App.css

@@ -85,3 +85,18 @@
   transition-duration: 200ms;
   transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
 }
+
+/* Dotted background scroll animation for catalog cards */
+@keyframes scroll-dots {
+  from {
+    background-position: 0 0;
+  }
+  to {
+    background-position: 64px 64px;
+  }
+}
+
+.server-card:hover .scroll-dots-target {
+  animation: scroll-dots 3s linear infinite;
+  color: oklch(0.553 0.013 58.071 / 0.4);
+}