Skip to Content
Get StartedQuickstart

Quickstart

The fastest way to use redu is to connect the redu MCP to your AI agent and let it deploy for you. Three steps: create an account, connect the MCP, deploy.

The console lives at https://console.redu.cloud, that is where you sign up and manage resources. (redu.cloud is the marketing site.)

1. Create your account

  1. Open console.redu.cloud 
  2. Click Sign up and register with your email
  3. You land in the dashboard, with a default private network already created for you

No credit card is required to create an account and explore. You add a payment method later, under Account → Payment, when you are ready to run paid resources.

2. Connect the redu MCP to your agent

This is the main path. The MCP server gives your agent the tools to deploy, provision, and operate your infrastructure in natural language. It works with any MCP client:

claude mcp add --transport http redu https://mcp.redu.cloud/mcp --client-id redu-mcp

A browser opens so you sign in to your redu.cloud account. If it does not prompt, run /mcp to start the login.

On Claude.ai or ChatGPT, add the same server and sign in with OAuth. See MCP Server for those clients, and for an API-key setup for CI.

Check it is connected:

What can you do on redu? Call whoami.

Your agent should list the redu tools and confirm your account.

3. Deploy with your agent

Deploy an app. From your project folder, just ask:

Deploy this project to redu.

Your agent scans the repo with plan_deploy, shows you a costed plan, and on approval provisions real infrastructure and returns a live URL at https://<name>.redu.cloud. Full walkthrough: Deploy an app.

Or create an instance. A VM needs an SSH keypair. If you have none, ask your agent to set one up: it can import your existing key or generate a new one. Then ask for the VM:

Set up an SSH key for me if I don't have one, then create a medium Ubuntu instance called web-01 on the first available network.

Your agent sorts out the keypair (import_keypair), calls plan_instance to resolve image, flavor, and network IDs, then create_instance. When it is ready:

Give me the SSH command for web-01.

Prefer the raw API?

You do not need the MCP to use redu. Generate an API key and call the REST API directly.

  1. Go to console.redu.cloud/category/user/api-keys 
  2. Click Generate API Key, then copy it immediately (it is shown only once)

Verify it works with a read-only call:

curl https://api.redu.cloud/v1/me -H "x-api-key: YOUR_API_KEY"

A JSON object with your username means you are authenticated. The full sequence to create an instance (image, flavor, network, keypair) is in the API reference; all requests use the base URL https://api.redu.cloud/v1.

The same API key also connects the MCP in CI or headless setups. See MCP Server.

What’s next

Stuck on any step? support@redu.cloud

Last updated on
Deploy an app