User Guide: Claude Desktop Quickstart - EyevinnOSC/community GitHub Wiki

Connect Claude Desktop to OSC — No-Code Quickstart

This guide is for anyone who wants to use AI to build and manage cloud services without touching a terminal. In a few minutes you will have Claude Desktop connected to Open Source Cloud (OSC) and ready to deploy services on your behalf.

What you need

  • A computer running macOS or Windows
  • Claude Desktop installed
  • A free OSC account (sign up below)

Step 1: Sign up for OSC

Visit app.osaas.io and register with your email address. After confirming your email, create a workspace when prompted. A free plan gives you access to one running service at a time.

Step 2: Get your MCP token

Your MCP token lets Claude Desktop act on your OSC account.

  1. Sign in at app.osaas.io
  2. Click your avatar/email in the top-right corner and select API Access, or go directly to app.osaas.io/dashboard/profile/api
  3. In Access Tokens, click Create New Token
  4. Enter a Token Name (Description and Purpose are optional), pick an expiry date, and click Create Token
  5. Copy the token immediately, you will not be able to see it again

Keep this token somewhere safe. You will paste it in the next step.

Step 3: Add OSC to Claude Desktop

Open Claude Desktop, then open its settings:

  • macOS: click the Claude menu in the menu bar and choose Settings
  • Windows: click the hamburger menu in the top-left corner and choose Settings

In settings, select Developer from the left sidebar, then click Edit Config. This opens a configuration file in your default text editor.

Replace the entire contents of the file with the following, substituting YOUR_TOKEN_HERE with the token you copied in Step 2:

{
  "mcpServers": {
    "osc": {
      "type": "streamable-http",
      "url": "https://mcp.osaas.io/mcp",
      "headers": {
        "x-pat-jwt": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Save the file and close the text editor.

Where is the config file?

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

If you already have other MCP servers configured, add the "osc" block inside the existing "mcpServers" section instead of replacing the whole file.

Step 4: Restart Claude Desktop

Quit Claude Desktop completely and reopen it. Claude reads the configuration file on startup, so a restart is required to pick up the new connector.

Step 5: Try it out

Start a new conversation in Claude Desktop and try one of these prompts:

  • "What OSC services are available?"
  • "Create a Valkey instance called mystore"
  • "What is my current token balance?"
  • "List my running service instances"

Claude will ask for your confirmation before taking any action that creates or modifies a service.

Step 6: Verify in the dashboard

After asking Claude to create a service, open app.osaas.io/dashboard to confirm the instance appears. From there you can also monitor its status, view logs, and manage settings through the web interface.

What's next?