Claude connector (MCP)
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
- Open Settings › Connectors › Add custom connector.
- Name:
Konsolity; address:https://mcp.konsolity.com/mcp. - Claude opens Konsolity's consent page, which shows an
XXXX-XXXXcode. - 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.
- 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 usekonsolity 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.