From 990519715439f8297134b72b9cabef9020eff2a2 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sun, 26 Jul 2026 07:14:41 +0000
Subject: [PATCH] Update docs/installation.mdx

Generated-By: mintlify-agent

Mintlify-Source: dashboard-editor
---
 docs/installation.mdx | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/installation.mdx b/docs/installation.mdx
index 07bc1bd619..4dcddd05b5 100644
--- a/docs/installation.mdx
+++ b/docs/installation.mdx
@@ -232,7 +232,12 @@ Declaring both `mcp_servers` and `mcpServers` in the same file is an error. A ba
 
 ### Mixing STDIO and HTTP/SHTTP servers
 
-You can mix STDIO and HTTP (Streamable HTTP / SHTTP) server entries in the same config. Each entry's transport is inferred from its fields: `command` + `args` means STDIO, `url` means HTTP/SHTTP.
+You can mix STDIO and HTTP (Streamable HTTP / SHTTP) server entries in the same config. Transport is determined as follows:
+
+1. If the entry has an explicit `type` or `transport` field, that wins.
+2. Otherwise it is inferred from the other fields: `command` means STDIO, `url` means HTTP/SHTTP.
+
+Accepted values for `type`/`transport` are `stdio`, `http`, `sse`, and all common spellings of Streamable HTTP (`streamable-http`, `streamable_http`, `streamableHttp`). An unrecognised value causes that server entry to be skipped.
 
 ```json config.json
 {
@@ -254,6 +259,8 @@ You can mix STDIO and HTTP (Streamable HTTP / SHTTP) server entries in the same
 }
 ```
 
+`headers` on HTTP entries and `env` on STDIO entries are preserved through the import and kept for subsequent connections — re-importing a config will not clear credentials already stored for a server of the same name.
+
 The terminal and desktop installs accept both shapes in the same file. The hosted web app accepts HTTP/SHTTP entries only — STDIO entries are ignored because the hosted runtime cannot spawn local processes.
 
 For per-server `Authorization` headers, see [API keys → Playground BYOK](/reference/api-keys#3-playground-byok-bring-your-own-key).