Aircraft hangar workshop illustrating precision engineering

Strumenti per sviluppatori

Costruisci con OpenFactory

Integra la creazione di OS assistita da IA nei tuoi workflow. Collega Claude Code, crea automazioni personalizzate o integra OpenFactory nelle tue applicazioni.

Integrazione IA

Model Context Protocol

OpenFactory espone un server MCP completo che assistenti come Claude possono usare per creare e gestire immagini OS per tuo conto.

🤖

Claude Code

Collega Claude Code direttamente a OpenFactory. Chiedi a Claude di creare immagini Linux, eseguire test o gestire la tua flotta.

"Costruiscimi un server Ubuntu con Docker e SSH abilitato"

🚀

Agenti personalizzati

Costruisci i tuoi agenti IA sopra OpenFactory. Crea pipeline, integrazioni CI/CD o strumenti interni.

Usa il Claude Agent SDK con gli strumenti OpenFactory

Avvio rapido: Claude Code

1. Aggiungi il server MCP

Avvia Claude Code con il server MCP di OpenFactory:

Terminal
claude mcp add --transport http openfactory \
  "https://console.openfactory.tech/mcp-stream/mcp" \
  --header "Authorization: Bearer of_mcp_your_key_here"

2. Crea il file di configurazione (opzionale)

Oppure aggiungilo al file .mcp.json del progetto:

.mcp.json
{
  "mcpServers": {
    "openfactory": {
      "url": "https://console.openfactory.tech/mcp-stream/mcp",
      "headers": {
        "Authorization": "Bearer of_mcp_your_key_here"
      }
    }
  }
}

Usa una API key MCP dalle impostazioni della console OpenFactory.

3. Inizia a costruire

Chiedi a Claude di creare un'immagine OS. I build appaiono sia in Claude Code sia nella web UI di OpenFactory automaticamente.

Opzionale: usa una API key

Per collegare in modo persistente l'account o lavorare in team, genera una API key dalla tua pagina impostazioni:

.mcp.json with API key
{
  "mcpServers": {
    "openfactory": {
      "url": "https://console.openfactory.tech/mcp-stream/mcp",
      "headers": {
        "Authorization": "Bearer of_mcp_your_key_here"
      }
    }
  }
}

Strumenti disponibili

Riferimento strumenti MCP

Questi strumenti sono disponibili per gli assistenti IA collegati via MCP. La disponibilita dipende dal piano e dai permessi.

Gestione build

list_buildsElenca i build con stato e informazioni di base
get_buildOttieni i dettagli completi inclusi ricetta e configurazione
create_buildCrea un nuovo build da una ricetta JSON
get_build_statusOttieni fase attuale e progresso del build
get_iso_download_urlOttieni l'URL di download per build completati
retry_buildRiprova un build fallito con la stessa ricetta

Template ricette

list_recipesSfoglia template di ricette predefiniti
get_recipeOttieni i dettagli completi di una ricetta e della configurazione
validate_recipeValida una ricetta senza costruirla
create_recipe_from_templatePersonalizza un template per il tuo caso

Esecuzione test

run_testsEsegui test su una ISO costruita
get_test_resultsOttieni risultati dettagliati e log dei test
list_test_runsElenca le esecuzioni di test dei tuoi build

Gestione VM

list_vmsElenca le VM in esecuzione create dai tuoi build
create_vmCrea una VM da una ISO costruita
start_vm / stop_vmControlla lo stato di alimentazione della VM

Esempi

Cosa puoi costruire

Costruzione conversazionale di OS

Chiedi a Claude di creare un OS personalizzato in linguaggio naturale:

"Crea un'immagine server Debian per una web app. Mi servono nginx, Node.js 20 e PostgreSQL. Abilita SSH sulla porta 2222 e imposta un IP statico 192.168.1.100."

Claude usera create_build con una ricetta completa

Integrazione CI/CD

Usa gli strumenti MCP nelle tue pipeline di automazione:

Example: Build and test workflow
# 1. Create build from recipe
build = await create_build(recipe={
    "name": "web-server-v2",
    "base_image": "ubuntu-noble",
    "features": ["ssh", "nginx", "docker"],
    "packages": ["nodejs", "npm"]
})

# 2. Wait for build completion
while status != "built":
    status = await get_build_status(build_id)
    await sleep(30)

# 3. Run tests
test_run = await run_tests(build_id)

# 4. Check results
results = await get_test_results(run_id)
if results.all_passed:
    deploy(build_id)

Template di ricette

Parti da template collaudati e personalizzali:

"Mostrami ricette healthcare con conformita GxP"

"Prendi la ricetta AI workstation e aggiungi supporto ROS 2"

Claude usera list_recipes e create_recipe_from_template

Autenticazione

API key (opzionali)

Le API key sono opzionali. Usane una per collegamento persistente o collaborazione di team.

🌐

Sessioni condivise

Build, VM e test restano associati all'account o all'organizzazione della chiave.

🔑

Sicuro

Le chiavi vengono hashate alla creazione. Non salviamo mai la chiave grezza.

🗑

Revocabile

Elimina le chiavi in qualsiasi momento per revocare subito l'accesso.

Developer workspace illustrating modern software development

Pronto per iniziare?

Crea un account e genera la tua prima API key per costruire con l'IA.