Getting started
Add your first server
Host, user, key or password. Then one look at the server's fingerprint, and you're in.
On this page
The first time you open Mucq, it asks for the server where Claude runs. Choose Add Server… to begin; later, the same command is in the File menu (⌘N).
The server
| Field | What goes in |
|---|---|
| Host | The server's name or IP address, such as devbox.example.com. |
| Port | 22 unless your server listens elsewhere. |
| User | The account Claude runs as. On the Mac it starts as your Mac's username. |
| Name | What the sidebar calls it. Leave it empty and Mucq uses the host. |
Mucq has no ~/.ssh/config, so put the real host, port and user here, not a Host alias.
Sign in with a key or a password
Sign in with offers SSH Key and Password.
SSH Key
The default is Device Key: a key Mucq makes in this device's Secure Enclave the first time you need one. Its private half never leaves the chip, so there's nothing to copy, back up or lose.
The server has to know the key once. Under the key, choose Copy Install Command, then run it in a shell on the server, through an SSH session you already have or your provider's web console. The command adds the key to ~/.ssh/authorized_keys and sets the permissions sshd expects:
mkdir -p ~/.ssh && chmod 700 ~/.ssh && printf '\n%s\n' 'ecdsa-sha2-nistp256 AAAA… mucq@mac-20261112' >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys
Yours carries your device's real key. The comment at the end says which device made it and when. Copy Public Key copies just the key line, if you'd rather add it yourself; on iPhone and iPad, Share Public Key… sends it on.
Each device has its own key. Your iPhone's key is not your Mac's, so add each device's key to the server once.
Tip
Already have an Ed25519 or ECDSA key the server trusts? Import it in the key menu instead. RSA keys can't be used.
Password
Choose Password. With Remember password in Keychain on (the default), Mucq asks once and keeps it in your Keychain. Turn it off, and Mucq asks for every new connection.
The projects folder
Projects folder is the folder on the server that holds your projects, such as ~/projects. Every folder inside it becomes a project you can pin to the sidebar.
The first connection
Choose Add Server, and Mucq opens Pin Projects to list the folders on the server. That's the first connection, so Mucq asks first:
Connect to devbox?
Mucq hasn't connected to devbox.example.com before.
Its ED25519 key fingerprint is SHA256:…
Check it before you choose Connect. On the server, this prints the same fingerprint:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
If the dialog names an ECDSA key, read ssh_host_ecdsa_key.pub instead. When they match, connect. Mucq remembers the key and checks it on every connection after this one. If it ever changes, Mucq won't connect until you say so: see Host key changed.
Then pin the folders you work in and choose Save. Next: your first session.