Server MCP

Cos'è MCP?

Model Context Protocol (MCP) è uno standard aperto sviluppato da Anthropic che consente agli assistenti AI di interagire con strumenti esterni e fonti di dati in modo standardizzato. Pensa a MCP come un adattatore universale: permette agli IDE basati sull'AI come Cursor, Claude Desktop e Claude Code di connettersi facilmente con servizi, API e dati di terze parti.

Utilizzando MCP, gli sviluppatori possono estendere le capacità del loro assistente AI ben oltre il semplice completamento del codice: possono cercare documentazione, generare immagini, video, audio e modelli 3D, interagire con LLM e molto altro — il tutto tramite comandi in linguaggio naturale all'interno del loro ambiente di sviluppo.

Server MCP di Atlas Cloud

Atlas Cloud fornisce un server MCP ufficiale (atlascloud-mcp su npm) che porta tutta la potenza della piattaforma API AI di Atlas Cloud direttamente nel tuo IDE. Con oltre 400 modelli AI disponibili — che coprono immagini, video, 3D, audio (TTS) e modelli linguistici di grandi dimensioni — puoi accedere a tutto senza passare da una scheda del browser all'altra o scrivere manualmente chiamate API.

Repository GitHub: AtlasCloudAI/mcp-server

Modelli supportati

• 🎬 Video — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
• 🎨 Immagini — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
• 🧊 3D — Hunyuan 3D image-to-3D / text-to-3D
• 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
• 🔊 Audio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

Esplora il catalogo completo nella nostra pagina Models.

Funzionalità principali

• Ricerca documentazione — Cerca nella documentazione, nei modelli e nei riferimenti API di Atlas Cloud direttamente dal tuo IDE
• Scoperta dei modelli — Elenca ed esplora oltre 400 modelli AI disponibili con prezzi e funzionalità, filtrabili per tipo (Testo/Immagine/Video/Audio)
• Generazione di immagini — Genera immagini utilizzando modelli come Nano Banana, GPT Image 2, Flux 2, Seedream, ecc.
• Generazione di video — Genera video utilizzando modelli come Seedance, Kling, Sora, Veo, Wan, ecc.
• Generazione 3D — Trasforma testo o foto in modelli 3D (GLB/OBJ/USDZ) con Hunyuan 3D
• Generazione audio (TTS) — Sintetizza il parlato con Seed Audio, xAI/Grok TTS, ElevenLabs, ecc.
• Generazione rapida — Generazione di immagini/video/audio in un solo passaggio, che trova automaticamente il modello giusto per parola chiave e costruisce i parametri
• Caricamento di media — Carica file locali per ottenere un URL da usare nei flussi di lavoro di modifica immagini o image-to-video
• Chat con LLM — Chatta con modelli LLM (compatibili OpenAI) inclusi Claude, GPT, DeepSeek, Qwen, Kimi, GLM, ecc.
• Saldo e utilizzo — Controlla il saldo del tuo account, l'utilizzo giornaliero e la ripartizione dei costi tramite la Public API di Atlas Cloud
• Schema dinamico — Recupera automaticamente lo schema dei parametri di ciascun modello e convalida i parametri prima dell'invio, così le richieste non valide falliscono subito senza consumare crediti

Prerequisiti

Prima di configurare il server MCP di Atlas Cloud, assicurati di avere:

• Node.js 18 o superiore — Scarica Node.js
• Chiave API di Atlas Cloud — Registrati e ottieni la tua chiave su atlascloud.ai

Configurazione

Agenti CLI (installazione in un solo comando)

Il percorso più rapido — questi agenti di coding AI aggiungono il server con un unico comando:

# Claude Code
claude mcp add atlascloud -- npx -y atlascloud-mcp

# OpenAI Codex CLI
codex mcp add atlascloud -- npx -y atlascloud-mcp

# Gemini CLI
gemini mcp add atlascloud -- npx -y atlascloud-mcp

# Goose CLI
goose mcp add atlascloud -- npx -y atlascloud-mcp

Poi imposta la tua chiave API come variabile d'ambiente:

export ATLASCLOUD_API_KEY="your-api-key-here"

Per mantenere la chiave API tra le sessioni del terminale, aggiungi il comando export al profilo della tua shell (~/.bashrc, ~/.zshrc, ecc.).

Cursor

Apri o crea il file ~/.cursor/mcp.json e aggiungi quanto segue:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Riavvia Cursor per applicare le modifiche.

Claude Desktop

Apri il file di configurazione:

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

Aggiungi la configurazione del server MCP:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Riavvia Claude Desktop per applicare le modifiche.

Windsurf

Aggiungi quanto segue alla configurazione MCP di Windsurf:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Codex

Preferisci l'installazione in un solo comando qui sopra, oppure apri/crea il file di configurazione Codex ~/.codex/config.toml e aggiungi:

[mcp_servers.atlascloud]
command = "npx"
args = ["-y", "atlascloud-mcp"]

[mcp_servers.atlascloud.env]
ATLASCLOUD_API_KEY = "your-api-key-here"

Gemini CLI

Preferisci l'installazione in un solo comando qui sopra, oppure apri/crea il file di impostazioni Gemini ~/.gemini/settings.json e aggiungi:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kilo Code

Apri o crea il file di configurazione a livello di progetto .kilocode/mcp.json e aggiungi:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenCode

Apri o crea il file di configurazione OpenCode opencode.json e aggiungi:

{
  "mcp": {
    "atlascloud": {
      "type": "local",
      "command": ["npx", "-y", "atlascloud-mcp"],
      "enabled": true,
      "environment": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Altri client MCP

La stessa configurazione JSON funziona con qualsiasi client compatibile MCP:

Strumenti disponibili

Il server MCP di Atlas Cloud fornisce 13 strumenti che il tuo assistente AI può utilizzare:

Nota: gli strumenti per saldo, utilizzo e costi sono basati sulla Public API di Atlas Cloud (https://api.atlascloud.ai/public/v1), così puoi verificare spesa e quota senza uscire dal tuo IDE.

Esempi d'uso

Una volta configurato, puoi interagire con Atlas Cloud tramite linguaggio naturale:

Cercare modelli

• "Cerca su Atlas Cloud modelli di generazione video"
• "Elenca tutti i modelli di generazione immagini con i relativi prezzi"
• "Mostrami i dettagli sul modello DeepSeek V3"

Generare un'immagine

"Genera un'immagine di un gatto nello spazio usando Seedream"

L'assistente:

1. Usa atlas_list_models per trovare i modelli immagine Seedream
2. Usa atlas_get_model_info per ottenere i parametri del modello
3. Usa atlas_generate_image con i parametri corretti

Generare un video

"Crea un video del lancio di un razzo usando Kling v3"

L'assistente:

1. Trova il modello video Kling
2. Ottiene lo schema per comprendere i parametri richiesti
3. Usa atlas_generate_video con i parametri appropriati

Caricare un'immagine locale per modificarla o generare un video

"Modifica questa immagine /Users/me/photos/cat.jpg per aggiungere un cappello"

L'assistente:

1. Usa atlas_upload_media per caricare il file locale e ottenere un URL
2. Trova un modello di modifica immagini
3. Usa atlas_generate_image con l'URL caricato

Nota: i file caricati sono destinati esclusivamente a un uso temporaneo con le attività di generazione di Atlas Cloud. I file possono essere eliminati periodicamente. Non usare questa funzione come hosting permanente di file — un uso improprio può comportare la sospensione della chiave API.

Generare il parlato (TTS)

"Leggi ad alta voce questa frase con Seed Audio: Welcome to Atlas Cloud"

L'assistente:

1. Usa atlas_list_models con type="Audio" per trovare il modello TTS
2. Usa atlas_generate_audio con il testo da sintetizzare
3. Usa atlas_get_prediction per recuperare l'URL dell'audio generato

Generare un modello 3D

"Trasforma questa foto di prodotto in un modello 3D con Hunyuan 3D"

I modelli 3D sono modelli di tipo Immagine, quindi l'assistente usa atlas_generate_image con il parametro image e recupera un file GLB/OBJ/USDZ tramite atlas_get_prediction.

Chattare con un LLM

"Chiedi a DeepSeek V3 di spiegare l'informatica quantistica"

L'assistente userà atlas_chat con il modello DeepSeek.

Controllare saldo e utilizzo

"Quanto credito Atlas Cloud mi rimane e quanto ho speso questo mese?"

L'assistente userà atlas_get_balance per il saldo attuale e atlas_get_model_costs per la ripartizione della spesa.

Risoluzione dei problemi

Problemi comuni

Errore "Command not found" durante l'esecuzione di npx

Assicurati che Node.js 18+ sia installato e che npx sia disponibile nel tuo PATH:

node --version  # Should be 18.x or higher
npx --version   # Should output a version number

Errore "Invalid API Key"

Verifica che la tua chiave API sia impostata correttamente:

echo $ATLASCLOUD_API_KEY  # Should output your key

Se vuoto, impostala di nuovo e assicurati che non ci siano spazi o virgolette extra.

Il server MCP non appare nell'IDE

• Assicurati di aver riavviato il tuo IDE dopo aver aggiunto la configurazione
• Ricontrolla la sintassi JSON nel tuo file di configurazione
• Verifica che il file di configurazione sia nella posizione corretta per il tuo IDE

Ottenere aiuto

• Problemi su GitHub: AtlasCloudAI/mcp-server/issues
• Supporto Atlas Cloud: Contattaci

Altri strumenti di Atlas Cloud

Preferisci un'integrazione diversa? Atlas Cloud offre anche:

• CLI — usa Atlas Cloud dal terminale: atlascloud-cli
• Skills — un pacchetto di Skills per Claude Code e altri agenti compatibili con le skill: atlas-cloud-skills
• Nodi ComfyUI — atlascloud_comfyui
• Nodi n8n — n8n-nodes-atlascloud

FAQ

Il server MCP è gratuito?

Il server MCP stesso è gratuito e open-source (licenza MIT). Paghi solo per l'utilizzo dell'API di Atlas Cloud in base ai modelli che usi. Consulta i prezzi dei modelli per i dettagli.

A quali modelli AI posso accedere?

Puoi accedere a tutti gli oltre 400 modelli disponibili su Atlas Cloud, inclusi modelli video (Seedance, Kling, Sora, Veo, Wan), modelli di immagini (Nano Banana, GPT Image, FLUX, Seedream), modelli 3D (Hunyuan 3D), modelli TTS (Seed Audio, xAI/Grok TTS, ElevenLabs) e LLM (Claude, GPT, DeepSeek, Qwen, Kimi, GLM, MiniMax). Visita la nostra pagina Modelli per un elenco completo.

Devo installare qualcosa oltre a Node.js?

No. Il server MCP è distribuito tramite npm e viene eseguito usando npx, che scarica ed esegue il pacchetto automaticamente. Non è richiesta alcuna installazione globale.

Posso usare il server MCP con altri IDE?

Il server MCP funziona con qualsiasi IDE o applicazione che supporti il Model Context Protocol, inclusi Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI, Goose, Windsurf, Kilo Code, OpenCode, Cline, Continue, VS Code (Copilot), Trae, JetBrains IDEs, ChatGPT Desktop, Amazon Q Developer e Roo Code.

La mia chiave API è sicura?

La tua chiave API è memorizzata localmente nel file di configurazione del tuo IDE e viene inviata solo agli endpoint API di Atlas Cloud. Il server MCP non raccoglie, registra o trasmette la tua chiave API a servizi di terze parti.