MCP Server

Verwenden Sie Atlas Cloud KI-Modelle direkt in Ihrer IDE mit dem offiziellen MCP Server. Unterstützt Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI und mehr.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der von Anthropic entwickelt wurde und es KI-Assistenten ermöglicht, auf standardisierte Weise mit externen Tools und Datenquellen zu interagieren. Stellen Sie sich MCP als einen universellen Adapter vor — er ermöglicht es KI-gestützten IDEs wie Cursor, Claude Desktop und Claude Code, sich nahtlos mit Drittanbieter-Diensten, APIs und Daten zu verbinden.

Durch die Verwendung von MCP können Entwickler die Fähigkeiten ihres KI-Assistenten weit über die einfache Code-Vervollständigung hinaus erweitern: Sie können Dokumentation durchsuchen, Bilder generieren, Videos erstellen, mit LLMs interagieren und vieles mehr — alles durch natürliche Sprachbefehle innerhalb ihrer Entwicklungsumgebung.

Atlas Cloud MCP Server

Atlas Cloud bietet einen offiziellen MCP Server (atlascloud-mcp auf npm), der die volle Leistungsfähigkeit der Atlas Cloud KI-API-Plattform direkt in Ihre IDE bringt. Mit über 300 verfügbaren KI-Modellen — darunter Bildgeneratoren, Videoersteller und große Sprachmodelle — können Sie auf alles zugreifen, ohne zwischen Browser-Tabs zu wechseln oder API-Aufrufe manuell zu schreiben.

GitHub-Repository: AtlasCloudAI/mcp-server

Hauptfunktionen

  • Dokumentationssuche — Durchsuchen Sie Atlas Cloud-Dokumentation, Modelle und API-Referenzen direkt aus Ihrer IDE
  • Modellerkennung — Über 300 verfügbare KI-Modelle mit Preisen und Funktionen auflisten und erkunden
  • Bildgenerierung — Bilder generieren mit Modellen wie Seedream, Qwen-Image, FLUX usw.
  • Videogenerierung — Videos generieren mit Modellen wie Kling, Vidu, Seedance, Wan usw.
  • LLM-Chat — Mit LLM-Modellen chatten (OpenAI-kompatibel), darunter DeepSeek, Qwen, GLM usw.
  • Dynamisches Schema — Ruft automatisch das Parameterschema jedes Modells für eine korrekte API-Nutzung ab

Voraussetzungen

Bevor Sie den Atlas Cloud MCP Server einrichten, stellen Sie sicher, dass Sie Folgendes haben:

Konfiguration

Cursor

Öffnen oder erstellen Sie die Datei ~/.cursor/mcp.json und fügen Sie Folgendes hinzu:

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

Starten Sie Cursor neu, um die Änderungen zu übernehmen.

Claude Desktop

Öffnen Sie die Konfigurationsdatei:

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

Fügen Sie die MCP-Server-Konfiguration hinzu:

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

Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

Claude Code

Führen Sie den folgenden Befehl aus, um den Atlas Cloud MCP Server hinzuzufügen:

claude mcp add atlascloud -- npx -y atlascloud-mcp

Setzen Sie dann Ihren API-Schlüssel als Umgebungsvariable:

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

Um den API-Schlüssel über Terminal-Sitzungen hinweg beizubehalten, fügen Sie den Export-Befehl zu Ihrem Shell-Profil hinzu (~/.bashrc, ~/.zshrc usw.).

Windsurf

Fügen Sie Folgendes zu Ihrer Windsurf MCP-Konfiguration hinzu:

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

Codex

Öffnen oder erstellen Sie die Codex-Konfigurationsdatei ~/.codex/config.toml und fügen Sie hinzu:

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

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

Gemini CLI

Öffnen oder erstellen Sie die Gemini-Einstellungsdatei ~/.gemini/settings.json und fügen Sie hinzu:

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

Kilo Code

Öffnen oder erstellen Sie die projektspezifische Konfiguration .kilocode/mcp.json und fügen Sie hinzu:

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

OpenCode

Öffnen oder erstellen Sie die OpenCode-Konfigurationsdatei opencode.json und fügen Sie hinzu:

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

Verfügbare Tools

Der Atlas Cloud MCP Server stellt 7 Tools bereit, die Ihr KI-Assistent verwenden kann:

ToolBeschreibung
atlas_search_docsAtlas Cloud-Dokumentation und Modelle nach Schlüsselwörtern durchsuchen
atlas_list_modelsAlle verfügbaren Modelle auflisten, optional nach Typ gefiltert (Text/Bild/Video)
atlas_get_model_infoDetaillierte Modellinformationen einschließlich API-Schema, Parameter und Nutzungsbeispiele abrufen
atlas_generate_imageBilder mit jedem unterstützten Bildmodell generieren
atlas_generate_videoVideos mit jedem unterstützten Videomodell generieren
atlas_chatMit LLM-Modellen chatten (OpenAI-kompatibles Format)
atlas_get_predictionStatus und Ergebnis von Bild-/Videogenerierungsaufgaben überprüfen

Nutzungsbeispiele

Nach der Konfiguration können Sie über natürliche Sprache mit Atlas Cloud interagieren:

Modelle suchen

  • "Durchsuche Atlas Cloud nach Videogenerierungsmodellen"
  • "Liste alle Bildgenerierungsmodelle mit ihren Preisen auf"
  • "Zeige mir Details zum DeepSeek V3 Modell"

Ein Bild generieren

"Generiere ein Bild einer Katze im Weltraum mit Seedream"

Der Assistent wird:

  1. atlas_list_models verwenden, um Seedream-Bildmodelle zu finden
  2. atlas_get_model_info verwenden, um die Parameter des Modells abzurufen
  3. atlas_generate_image mit den korrekten Parametern ausführen

Ein Video generieren

"Erstelle ein Video eines Raketenstarts mit Kling v3"

Der Assistent wird:

  1. Das Kling-Videomodell finden
  2. Das Schema abrufen, um die erforderlichen Parameter zu verstehen
  3. atlas_generate_video mit den passenden Parametern ausführen

Mit einem LLM chatten

"Frage DeepSeek V3, Quantencomputing zu erklären"

Der Assistent wird atlas_chat mit dem DeepSeek-Modell verwenden.

Fehlerbehebung

Häufige Probleme

Fehler "Befehl nicht gefunden" beim Ausführen von npx

Stellen Sie sicher, dass Node.js 18+ installiert ist und npx in Ihrem PATH verfügbar ist:

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

Fehler "Ungültiger API-Schlüssel"

Überprüfen Sie, ob Ihr API-Schlüssel korrekt gesetzt ist:

echo $ATLASCLOUD_API_KEY  # Should output your key

Falls leer, setzen Sie ihn erneut und stellen Sie sicher, dass keine zusätzlichen Leerzeichen oder Anführungszeichen vorhanden sind.

MCP Server wird in der IDE nicht angezeigt

  • Stellen Sie sicher, dass Sie Ihre IDE nach dem Hinzufügen der Konfiguration neu gestartet haben
  • Überprüfen Sie die JSON-Syntax in Ihrer Konfigurationsdatei
  • Vergewissern Sie sich, dass sich die Konfigurationsdatei am richtigen Speicherort für Ihre IDE befindet

Hilfe erhalten

FAQ

Ist der MCP Server kostenlos nutzbar?

Der MCP Server selbst ist kostenlos und Open Source (MIT-Lizenz). Sie zahlen nur für die Atlas Cloud API-Nutzung basierend auf den von Ihnen verwendeten Modellen. Details finden Sie in unserer Modellpreisliste.

Auf welche KI-Modelle kann ich zugreifen?

Sie können auf alle über 300 Modelle zugreifen, die auf Atlas Cloud verfügbar sind, darunter Modelle von OpenAI, Anthropic, DeepSeek, Google, Meta, Mistral, ByteDance (Seedream, Kling), Alibaba (Qwen) und mehr. Besuchen Sie unsere Modelle-Seite für eine vollständige Liste.

Muss ich neben Node.js noch etwas installieren?

Nein. Der MCP Server wird über npm verteilt und läuft mit npx, das das Paket automatisch herunterlädt und ausführt. Eine globale Installation ist nicht erforderlich.

Kann ich den MCP Server mit anderen IDEs verwenden?

Der MCP Server funktioniert mit jeder IDE oder Anwendung, die das Model Context Protocol unterstützt. Derzeit unterstützt: Cursor, Claude Desktop, Claude Code, Windsurf, Codex, Gemini CLI, Kilo Code und OpenCode.

Ist mein API-Schlüssel sicher?

Ihr API-Schlüssel wird lokal in der Konfigurationsdatei Ihrer IDE gespeichert und nur an die API-Endpunkte von Atlas Cloud gesendet. Der MCP Server sammelt, protokolliert oder übermittelt Ihren API-Schlüssel nicht an Drittanbieter-Dienste.