SSH Teams Integration
Maverick SSH MCP can register as an SSH Teams device and use short-lived certificates for SSH authentication.
For SSH Teams platform setup and administration, start with the SSH Teams documentation.
Why Use SSH Teams with Maverick SSH MCP
- Centralize trust and access rules.
- Avoid long-lived static private keys on automation hosts.
- Use OAuth device flow for runtime registration.
- Let
ssh_connectattempt certificate-based auth first, then fall back to standard auth.
Registration Flow
- Call
sshteam_registerwithwaitForAuthorization=false. - Open the returned
verificationUriand enter the returneduserCode. - Call
sshteam_register_pollwithserverUrlanddeviceCode. - Confirm registration with
sshteam_status.
Core SSH Teams Tools
| Tool | Purpose |
|---|---|
sshteam_register |
Start device registration and optionally wait for authorization. |
sshteam_register_poll |
Continue polling until authorization and token issuance complete. |
sshteam_status |
Show registrations and token state on this runtime. |
sshteam_revoke_device |
Revoke a registered device from the server. |
Using SSH Teams During Connection
ssh_connect includes SSH Teams options:
sshTeamEnabled(defaulttrue)sshTeamServer(optional override)sshTeamIgnoreSslTrust(defaultfalse)sshTeamCertificateType(ED25519orRSA, defaultED25519)sshTeamTimezone(optional IANA timezone)
When enabled and a registration exists, Maverick SSH MCP attempts SSH Teams certificate auth before trying configured password or key auth.
Security Notes
- Keep
ignoreSslTrust=falseunless you are in a controlled development environment. - Protect local runtime state on hosts where registration credentials are stored.
- Revoke devices you no longer use with
sshteam_revoke_device.