User Guide: Enable OSC with AI agents - EyevinnOSC/community GitHub Wiki

Connect AI Agents with OSC

The integration of Model Context Protocol (MCP) into Eyevinn Open Source Cloud (OSC) now enables anyone โ€“ regardless of technical expertise โ€“ to deploy and manage sophisticated web services simply by describing their needs in plain language.

In this guide we describe how you enable this in your favorite AI agent.

For Claude Desktop Users

Configure and extend your Claude for Desktop so that it can get access to all the tools provided by Open Source Cloud. Don't worry it will ask for your permissions before executing any actions.

Step 1: Download Claude for Desktop

Start by downloading Claude for Desktop, choosing either macOS or Windows.

Follow the installation instructions.

If you already have Claude for Desktop, make sure itโ€™s on the latest version by clicking on the Claude menu on your computer and selecting โ€œCheck for Updatesโ€ฆโ€œ

Step 2: Connect Claude with OSC

Open up the Claude menu on your computer and select "Settings...".

Select the menu alternative on the left labelled "Connectors".

In the bottom of the list you find a button "Add custom connector"

Click on it and give the connector a name, for example "OSC" and enter the URL https://ai.svc.prod.osaas.io/mcp.

Then press Add.

Go to the connector and press the button "Connect". You are now prompted to authenticate with Open Source Cloud and allow access for Claude to access your OSC account on your behalf. Press the button "Allow" to allow this.

Step 3: Try it out!

You can now talk to Claude to help you perform various tasks and it will complete the tasks using all the open source tools that Eyevinn Open Source Cloud are making available.

Here are some things you might try to ask Claude:

  • Can you help me setup a stream for live streaming?
  • Can you create English subtitles in VTT format for my video file?
  • Can you take my video file and turn it into a black and white movie?

As needed, Claude will call the relevant tools and seek your approval before taking an action.

For Claude Code Users

In your terminal run the following command.

% Claude mcp add --transport http osc https://ai.svc.prod.osaas.io/mcp
Added HTTP MCP server osc with URL: https://ai.svc.prod.osaas.io/mcp to local config

Then start Claude Code

% claude
โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ โœป Welcome to Claude Code!                         โ”‚
โ”‚                                                   โ”‚
โ”‚   /help for help, /status for your current setup  โ”‚
โ”‚                                                   โ”‚
โ”‚   cwd: /Users/birme/Code/eyevinn/infra-osaas      โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

 Tips for getting started:

  Run /init to create a CLAUDE.md file with instructions for Claude
  Use Claude to help with file analysis, editing, bash commands and git
  Be as specific as you would with another engineer for the best results
  โœ” Run /terminal-setup to set up terminal integration

Now connect with OSC by entering this command.

> /mcp osc
 โŽฟ ย Authentication successful. Reconnected to osc.

Troubleshooting

If no web browser opens up you can use your personal access token instead. Navigate to Settings/API in the Open Source Cloud web console, and add this to your Claude configuration file ~/.claude.json. Replace <personal-access-token> below with the token you find on the settings page.

"mcpServers": {
  "osc": {
    "type": "http",
    "url": "https://ai.svc.prod.osaas.io/mcp",
    "headers": {
      "Authorization": "Bearer <personal-access-token>"
  }
},

For VS Code Users

Click on View and Command Palette menu item.

Start typing "MCP" and choose Add server.

Choose HTTP.

Enter the following URL: https://ai.svc.prod.osaas.io/mcp

Give it a name, for example "Open Source Cloud".

Choose whether it should be globally available or only the current workspace. Then choose Allow when asked for allowing authentication.

Authenticate in Open Source Cloud and give VS Code access to your account. Once authenticated you should have the tools available for your agent.