Claude connector (MCP)

Updated on November 12, 2026

Konsolity is a remote MCP server (Model Context Protocol) that you add as a connector in Claude. Claude can then list your SSH hosts, sessions and snippets, and ask to run a command on a server: every command waits for your approval in the Konsolity app.

Connector address https://mcp.konsolity.com/mcp
Transport Streamable HTTP (MCP)
Authentication OAuth 2.1 with PKCE (S256) and dynamic client registration, consent with a code confirmed in the app
Clients claude.ai (web), Claude Desktop (macOS, Windows), Claude on mobile once added, Claude Code
Plan Studio (€99 a month or €999 a year) and its 7-day free trial; two-factor authentication required

What the connector does

Claude gets six tools:

Tool Action Type
list_hosts Vault hosts: label, group, tags, address, port, user, whether a tab is connected Read
list_sessions Tabs open in the computer's app and sessions kept on hosts (tmux, screen) Read
list_snippets Saved command snippets Read
list_devices Devices of the account, and which one relays for Claude right now Read
run_command Runs a shell command on a host after your approval; returns the exit code, stdout and stderr (64 KiB each at most) Run
run_snippet Runs a saved snippet on a host after your approval Run

Example requests: "list my production servers", "how full is the disk on web-01?", "restart nginx on web-02", "run my deploy snippet on staging".

Installation

In claude.ai or Claude Desktop

  1. Open Settings › Connectors › Add custom connector.
  2. Name: Konsolity; address: https://mcp.konsolity.com/mcp.
  3. Claude opens Konsolity's consent page, which shows an XXXX-XXXX code.
  4. In the Konsolity app on a computer: Settings › Integrations › Claude › Confirm a code. The client name and its return address are shown: check them, then confirm.
  5. Back in Claude, turn the connector on in the conversation (tools menu).

No password is asked on the web. Once added on claude.ai, the connector is also available in the Claude apps of the same account.

In Claude Code

claude mcp add --transport http konsolity https://mcp.konsolity.com/mcp

Then /mcp in Claude Code to start the authorization: the browser opens the consent page, confirm the code in the app as above. For a machine without the Konsolity app (server, CI), prefer the local MCP of Konsolity CLI: claude mcp add konsolity -- konsolity mcp.

Security

  • Every command, your approval. The computer's app shows "Claude asks to run a command" with the exact command and host. Allow once runs it; without an answer, it is refused after 60 seconds.
  • The server never reads the vault. SSH passwords and keys stay encrypted on your devices. The server relays an encrypted request to your computer; the app makes the connection, with the key from the vault.
  • Dedicated, bounded connection. Each command goes through a short non-interactive SSH connection, with the pinned host key only; 30 seconds by default, 60 at most; output capped.
  • No secret to Claude. The read tools never return a password, a key or vault content.
  • Short, revocable tokens. Access token valid 60 minutes, renewable for 60 days; the Studio plan is checked on every call.
  • Minimal traces. Requests are encrypted at rest and purged after one hour; no command text is logged on the server. Every authorization given to Claude shows in the account activity.

Always allow

When you approve, you can tick Always allow for Claude: commands from that client then run without confirmation, with a notification in the bell and an auto: line in the log. You can undo it at any time in Settings › Integrations › Claude.

Revoke

Settings › Integrations › Claude lists the authorizations; revoke one, or all at once. Removing the connector in Claude revokes access too.

Without the app open

Commands go through the Konsolity app open on a computer of the account (list_devices shows which one relays). For Claude to act while your computer is off, install Konsolity CLI on a server and run konsolity serve: connector requests are then handled within that machine's scope and rules.

Troubleshooting

  • "Subscription required": the Claude integration is included in the Studio plan; Claude gets the link to the pricing page.
  • No answer to a command: no computer has the app open; check with list_devices, or use konsolity serve.
  • The code is refused: it expires after 10 minutes; add the connector again. Two-factor authentication must be on for the account.
  • Claude rejects the address: use exactly https://mcp.konsolity.com/mcp (with /mcp).

Privacy

The server relays requests encrypted at rest, purged after one hour; the vault is never read by the server; no command text is logged on the server. See also the privacy policy.