MCP Configuration - KeinSaaS Navigator

Navigator stores MCP server definitions as structured configuration. A server definition describes how to connect, what to call it, and which environment values it needs.

Common fields

Field	Purpose
`name`	Stable identifier shown in Navigator
`description`	Human-readable explanation of the server
`transport`	`stdio`, `sse`, or `streamable-http`
`command`	Executable for `stdio` servers
`args`	Arguments for the `stdio` command
`url`	Remote endpoint for SSE or streamable HTTP
`headers`	Optional request headers for remote servers
`env`	Environment variables for local server processes

stdio

Use stdio when Navigator launches a local process and communicates over standard input/output.

{
  "name": "filesystem",
  "description": "Local file tools",
  "transport": "stdio",
  "command": "node",
  "args": ["/absolute/path/to/server.js"],
  "env": {
    "ROOT_DIR": "/Users/example/workspace"
  }
}

SSE

Use SSE when the server exposes a server-sent-events endpoint.

{
  "name": "analytics",
  "description": "Analytics lookup tools",
  "transport": "sse",
  "url": "https://tools.example.com/sse",
  "headers": {
    "Authorization": "Bearer ${ANALYTICS_MCP_TOKEN}"
  }
}

Streamable HTTP

Use streamable HTTP for modern remote MCP servers that accept normal HTTP requests and stream responses.

{
  "name": "crm",
  "description": "CRM account tools",
  "transport": "streamable-http",
  "url": "https://tools.example.com/mcp",
  "headers": {
    "Authorization": "Bearer ${CRM_MCP_TOKEN}"
  }
}

Timeouts

Long browser or data jobs may need more time than a default model response. Set:

MCP_MAX_TOTAL_TIMEOUT=600000

The example above allows up to 10 minutes for a full MCP tool call sequence.

Security notes

Store tokens in environment variables, not directly in committed JSON. Use manual tool mode for tools that write data, send messages, place orders, or mutate production systems.

​Common fields

​stdio

​SSE

​Streamable HTTP

​Timeouts

​Security notes

Common fields

stdio

SSE

Streamable HTTP

Timeouts

Security notes