Server MCP

Usa i modelli AI di Atlas Cloud direttamente nel tuo IDE con il server MCP ufficiale. Supporta Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI e altro ancora.

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, creare video, 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 300 modelli AI disponibili — inclusi generatori di immagini, creatori di video 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

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 300 modelli AI disponibili con prezzi e funzionalità
Generazione di immagini — Genera immagini utilizzando modelli come Seedream, Qwen-Image, FLUX, ecc.
Generazione di video — Genera video utilizzando modelli come Kling, Vidu, Seedance, Wan, ecc.
Chat con LLM — Chatta con modelli LLM (compatibili OpenAI) inclusi DeepSeek, Qwen, GLM, ecc.
Schema dinamico — Recupera automaticamente lo schema dei parametri di ciascun modello per un utilizzo accurato dell'API

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

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.

Claude Code

Esegui il seguente comando per aggiungere il server MCP di Atlas Cloud:

claude 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.).

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

Apri o 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

Apri o 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"
      }
    }
  }
}

Strumenti disponibili

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

Strumento	Descrizione
`atlas_search_docs`	Cerca nella documentazione e nei modelli di Atlas Cloud per parola chiave
`atlas_list_models`	Elenca tutti i modelli disponibili, con filtro opzionale per tipo (Testo/Immagine/Video)
`atlas_get_model_info`	Ottieni informazioni dettagliate sul modello inclusi schema API, parametri ed esempi d'uso
`atlas_generate_image`	Genera immagini con qualsiasi modello di immagini supportato
`atlas_generate_video`	Genera video con qualsiasi modello video supportato
`atlas_chat`	Chatta con modelli LLM (formato compatibile OpenAI)
`atlas_get_prediction`	Controlla lo stato e i risultati delle attività di generazione immagini/video

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:

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

Generare un video

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

L'assistente:

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

Chattare con un LLM

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

L'assistente userà atlas_chat con il modello DeepSeek.

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

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 300 modelli disponibili su Atlas Cloud, inclusi modelli di OpenAI, Anthropic, DeepSeek, Google, Meta, Mistral, ByteDance (Seedream, Kling), Alibaba (Qwen) e altri. Visita la nostra pagina Modelli per un elenco completo.