How do I install the ssh session mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

The recorded environment keys are `DEVICE_A_ID`, `DEVICE_A_HOST`, `VIEWER_HOST`, `SSH_MCP_REDIS_URL`, `SSH_MCP_NODE_ID`, `SSH_MCP_PUBLIC_BASE_URL`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

SSH Session MCP Server

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.

Local serverstdioTypeScript

What is the SSH Session MCP Server?

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.

What you get

Persistent shared-terminal runtime for MCP clients over SSH.

One shared PTY for both the human and the AI
Browser terminal for live inspection and manual intervention
Input lock so the AI does not type over the user
Safe/full execution modes for risky commands
Configurable default policy rules plus session-level custom rule overrides
Async command tracking for long-running remote work

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
ssh-quick-connect	Connect or reuse the default target and optionally open the viewer
ssh-run	Execute a command with completion detection and exit-code capture
ssh-status	Inspect sessions, viewer state, and operation mode
ssh-command-status	Poll async command progress
ssh-retry	Retry flaky commands with backoff
ssh-session-policy-list	Inspect inherited defaults and current session custom policy rules
ssh-session-policy-upsert	Add or update a session-level custom policy rule
ssh-session-policy-remove	Remove a session-level custom policy rule
ssh-session-policy-reset	Reset session custom rules back to inherited defaults

Configuration

Variable	Description	Required
DEVICE_A_ID	Configuration value read at startup.	Optional
DEVICE_A_HOST	Endpoint or connection string the server talks to.	Optional
VIEWER_HOST	Endpoint or connection string the server talks to.	Optional
SSH_MCP_REDIS_URL	Endpoint or connection string the server talks to.	Yes
SSH_MCP_NODE_ID	Configuration value read at startup.	Optional
SSH_MCP_PUBLIC_BASE_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use SSH Session MCP to ssh-quick-connect.”
“Use SSH Session MCP to ssh-run.”
“Use SSH Session MCP to ssh-status.”

Frequently asked questions

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.