Repository navigation
0.4.0
0.4.0 — 2026-09-20
Connecting a vault no longer involves copying anything. Ask the assistant to
tidy your vault, authorize it in the ShieldFive tab that opens, and carry on.
Added
vault_connect: opens ShieldFive in the user's browser, where the owner
chooses folders, permissions and expiry as before, and receives the new
connection over127.0.0.1. It is stored in the system keychain. The tool
reports back while the owner is still deciding and picks up the result on the
next call, because a tool call cannot wait ten minutes.npx @shieldfive/mcp loginnow opens that same page;login --pastekeeps
the old behaviour for a machine with no browser.- The server suggests a name for the connection, taken from the AI client's
own name, so the settings list says "Claude Code" rather than "Other MCP
client". The page sanitizes it and the owner can change it. SHIELDFIVE_GRANT=nonekeeps one client local-only on a machine whose
keychain holds a connection for another.
Changed
- The vault tools are registered as soon as a connection exists, including one
made mid-conversation, which the server announces with
notifications/tools/list_changed. Until then onlyvault_connectis
registered: a tool that cannot work is still not offered. - A revoked or expired connection now tells the assistant to call
vault_connect, instead of sending the user to the terminal.
Security
- The hand-off is the only inbound socket in this package and the only
subprocess it starts. The listener binds a random loopback port, accepts one
POST to/callbackwith the loopbackHost, noOriginother than
ShieldFive's and a 256-bit state compared in constant time, then closes. It
opens no connection of its own, and the browser is launched with a fixed
command and no shell. - The ShieldFive page builds the callback address from a port number and
accepts no callback URL, so a crafted link cannot deliver a connection
anywhere but the machine the browser runs on. The connection string is sent
in a form body, never in a URL, so it does not reach browser history.