Connect Claude Code to your VPS

The Ulo MCP server lets AI coding tools work directly on your server

Ulo runs an MCP server at https://cloud.ulo.gg/mcp. Connect Claude Code (or any MCP client) with an API key and you can just ask: “deploy this project to my Ulo server”, “why is my Minecraft server not starting?” or “open port 8080”. No SSH setup needed.

1. Create an API key

Log in at cloud.ulo.gg, click your email at the bottom of the sidebar, then Account. Under API keys, name the key, pick its access and servers, and click Create key. Copy it right away: it is only shown once.

• Read-only keys can see status, logs, files and backups, but can't change anything.
• Full access keys can also run commands as root, write and upload files, power the server on and off, make backups and open firewall ports.

2. Add it to Claude Code

Run this once in a terminal, with your key in place of ulo_...:

claude mcp add --transport http ulo https://cloud.ulo.gg/mcp --header "Authorization: Bearer ulo_..."

Start Claude Code and ask it to list your Ulo servers to check it worked. Other MCP clients (Cursor, Claude Desktop and others) work too: use the same URL and send the key in an Authorization: Bearer header.

3. What it can do

• list_servers, server_status: your servers, IPs, status, CPU and memory
• power: start, stop, restart or force-stop
• run_command: run a shell command as root and get the output
• read_file, write_file: view and edit files such as configs
• upload_files: send a whole local project folder (up to 50 MB) to the server
• get_logs: recent logs from a service or file
• list_backups, create_backup, restore_backup: with the backups add-on
• get_firewall, open_port: the Ulo firewall

Commands run through the QEMU guest agent, which every Ulo OS image includes. If you installed your own OS from an ISO, install qemu-guest-agent for these tools to work.

4. Staying safe

• A full-access key is as powerful as your root password. Keep it private and never commit it to a repository.
• Limit each key to the servers it needs and give it an expiry date. Revoke keys you stop using; they stop working immediately.
• Everything a key does appears in Account > Recent activity, labelled with the key's name.
• Restoring a backup replaces the server's disk, so the tool makes your AI assistant ask you first.
• AI tools make mistakes. You are responsible for what they do with your key (see our Terms), so take a backup before big changes.

Need help?

Ask in our Discord or email [email protected].