> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keinsaas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Configuration

> Reference examples for configuring stdio, SSE, and streamable HTTP MCP servers.

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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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:

```dotenv theme={null}
MCP_MAX_TOTAL_TIMEOUT=600000
```

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

## Security notes

<Warning>
  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.
</Warning>