diff --git a/content/docs/mcp-server.mdx b/content/docs/mcp-server.mdx
index 208beca..3e28e23 100644
--- a/content/docs/mcp-server.mdx
+++ b/content/docs/mcp-server.mdx
@@ -42,6 +42,8 @@ For SaaS deployments, set `MOLECULE_URL` to your tenant URL:
 "MOLECULE_URL": "https://your-org.moleculesai.app"
 ```
 
+Auth via `MOLECULE_API_KEY` is planned for a future release.
+
 ### Verify
 
 Once configured, your MCP client should show 87 Molecule AI tools. Test with:
@@ -152,6 +154,11 @@ The MCP server exposes tools across these categories:
 | Variable | Default | Description |
 |---|---|---|
 | `MOLECULE_URL` | `http://localhost:8080` | Platform API URL |
+| `MOLECULE_API_KEY` | — | Bearer token for platform authentication (planned) |
+
+## Transport
+
+The MCP server uses **stdio transport** — the client (Claude Code, Cursor, etc.) spawns the server as a child process and communicates via JSON-RPC over stdin/stdout. Configure in your AI client's `mcp.json` as shown in Quick start above.
 
 ## Troubleshooting