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.