molecule-ai/docs
38
0
Fork 0
Code Issues Pull Requests 14 Actions Packages Projects Releases Wiki Activity

docs(mcp): add MCP_SERVER_PORT and MOLECULE_API_KEY to env vars #42

Closed
technical-writer wants to merge 1 commits from docs/mcp-server-port-env-var into main
pull from: docs/mcp-server-port-env-var
merge into: molecule-ai:main
Conversation 3 Commits 1 Files Changed 1 +8 -3
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
content/docs/mcp-server.mdx
View File

@ -25,7 +25,8 @@ npx @molecule-ai/mcp-server@1.0.0
"command": "npx",
"args": ["@molecule-ai/mcp-server@1.0.0"],
"env": {
"MOLECULE_URL": "http://localhost:8080"
"MOLECULE_URL": "http://localhost:8080",
"MOLECULE_API_KEY": "your-bearer-token"
}
}
}
@ -36,10 +37,11 @@ npx @molecule-ai/mcp-server@1.0.0
**Pin the package version.** The examples above use `@1.0.0` — always specify an exact version and omit the `-y` flag. An unpinned `npx -y @molecule-ai/mcp-server` (no version) silently installs whatever npm serves on the next restart; if the package is ever compromised, it runs with your full MCP client permissions. Check [npm](https://www.npmjs.com/package/@molecule-ai/mcp-server) for the latest stable release before upgrading.
</Callout>
For SaaS deployments, set `MOLECULE_URL` to your tenant URL:
For SaaS deployments, set `MOLECULE_URL` to your tenant URL and add your API key:
```json
"MOLECULE_URL": "https://your-org.moleculesai.app"
"MOLECULE_URL": "https://your-org.moleculesai.app",
"MOLECULE_API_KEY": "your-bearer-token"
```
### Verify
@ -152,6 +154,8 @@ 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 |
| `MCP_SERVER_PORT` | `3000` | TCP port the MCP server listens on (HTTP/SSE transport) |
## Troubleshooting
@ -159,4 +163,5 @@ The MCP server exposes tools across these categories:
|---|---|
| Connection refused | Check `MOLECULE_URL` points to running platform |
| 401 Unauthorized | Token expired or revoked — create a new one |
| Port already in use | Set `MCP_SERVER_PORT` to an available port if 3000 is taken |
| Tools not showing | Run `npx @molecule-ai/mcp-server@1.0.0` standalone to check errors |