@sota-io/mcp

MCP-Server für sota.io — Bereitstellung von Web-Apps über KI-Agenten.

Zwei Transports

Seit v1.4.0 enthält dieses Paket zwei Transports:

• sota-mcp (stdio, Standard) — für Claude Code, Cursor, Windsurf und jeden MCP-Client, der einen lokalen Prozess startet. Gib deinen SOTA_API_KEY über die Umgebungsvariable an.

• sota-mcp-http (Streamable HTTP) — zum Selbsthosten des entfernten Endpunkts, der mcp.sota.io betreibt (verwendet von Claude Desktop und Claude.ai Web). Liest SUPABASE_JWT_SECRET, DATABASE_URL usw. — die meisten Benutzer benötigen dies nicht; es ist derselbe Code, der auf mcp.sota.io läuft, falls du deinen eigenen hosten möchtest.

Die meisten Benutzer möchten den stdio-Transport.

Related MCP server: AppsAI MCP Server

Ein-Klick-Installation für Claude Desktop / Claude.ai Web

Wenn du Claude Desktop oder Claude.ai (Pro / Max / Team / Enterprise-Tarif) verwendest, ist die einfachste Installation nicht dieses npm-Paket — es ist der gehostete entfernte Endpunkt unter mcp.sota.io. Klicke hier:

Zu Claude hinzufügen →

OAuth übernimmt die Authentifizierung. Neue Benutzer können sich vollständig innerhalb von Claude über das Tool create_account anmelden — kein Browser-Tab-Wechsel nötig.

Siehe https://sota.io/docs/integrations/claude.

Schnellstart (stdio — Claude Code, Cursor, Windsurf, …)

1. Hole einen API-Schlüssel von sota.io/dashboard/settings

2. Konfiguriere deine IDE

3. Frage deine KI: "Bereitstellung meiner App auf sota.io"

Installation

Keine Installation erforderlich — direkt mit npx ausführen:

npx -y @sota-io/mcp

Oder global installieren:

npm install -g @sota-io/mcp
sota-mcp

Konfiguration

Claude Code

CLI-Methode:

claude mcp add sota -- npx -y @sota-io/mcp

Setze dann deinen API-Schlüssel in der Shell-Umgebung:

export SOTA_API_KEY=sota_your_api_key_here

Manuelles JSON (.claude/settings.json):

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Bearbeite claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

Erstelle .cursor/mcp.json im Projektstammverzeichnis:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

Bearbeite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Werkzeuge

deploy

Stellt eine Anwendung auf sota.io bereit. Erstellt ein tar.gz-Archiv des angegebenen Verzeichnisses und lädt es hoch.

"Deploy my app in the current directory to sota.io"

get-logs

Ruft Bau- und Laufzeit-Logs für ein Deployment ab. Wenn keine deployment_id angegeben wird, werden Logs für das letzte Deployment zurückgegeben.

"Show me the build logs for my sota.io project"

set-env

Setzt eine Umgebungsvariable für ein Projekt.

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

Listet Umgebungsvariablen für ein Projekt auf.

"Show all environment variables for my project"

rollback

Setzt ein Projekt auf das vorherige Deployment zurück. Dabei wird das Container-Image ausgetauscht, ohne neu zu bauen.

"Roll back my app to the previous version"

get-status

Ruft den aktuellen Deployment-Status für ein Projekt ab, einschließlich URL und letzter Deployment-Verlauf.

"What's the status of my sota.io deployment?"

list-projects

Listet alle Projekte auf deinem sota.io-Konto auf.

Keine Parameter erforderlich.

"List my sota.io projects"

create-project

Erstellt ein neues Projekt auf sota.io. Der Projekt-Slug wird automatisch aus dem Namen generiert (Kleinbuchstaben, Bindestriche, max. 63 Zeichen) und als Subdomain verwendet ({slug}.sota.io). Zum Beispiel wird "My API" zu my-api.sota.io.

"Create a new sota.io project called my-api"

delete-project

Löscht ein Projekt und alle seine Deployments von sota.io. Diese Aktion ist endgültig.

"Delete my sota.io project abc123"

add-domain

Fügt einem Projekt eine benutzerdefinierte Domain hinzu. Gibt DNS-Anweisungen zum Ausrichten der Domain zurück.

"Add example.com as a custom domain to my project"

list-domains

Listet alle benutzerdefinierten Domains eines Projekts auf.

"Show all custom domains for my project"

get-domain

Ruft Domaindetails einschließlich DNS-Überprüfungsstatus und SSL-Zustand ab.

"Check the DNS status of my custom domain"

remove-domain

Entfernt eine benutzerdefinierte Domain von einem Projekt.

"Remove the custom domain from my project"

Umgebungsvariablen

Fehlerbehebung

"npx: Befehl nicht gefunden"

Problem: Deine IDE erbt nicht den Shell-PATH, in dem nvm/fnm geladen ist.

Lösung: Verwende den absoluten Pfad zu npx. Finde ihn mit:

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

Aktualisiere dann deine MCP-Konfiguration, um den absoluten Pfad zu verwenden:

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"SOTA_API_KEY environment variable is required"

Problem: Der API-Schlüssel ist in deiner MCP-Konfiguration nicht gesetzt.

Lösung: Füge den env-Block zu deiner MCP-Serverkonfiguration hinzu. Shell-Umgebungsvariablen werden nicht automatisch an MCP-Server weitergegeben – der env-Block in der Konfiguration ist erforderlich:

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

Verbindungsfehler oder Zeitüberschreitung

Problem: Netzwerkproblem oder falsche API-URL.

Lösung: Überprüfe deine Internetverbindung. Wenn du eine benutzerdefinierte API-URL verwendest, stelle sicher, dass SOTA_API_URL korrekt gesetzt ist. Der Standardwert ist https://api.sota.io.

Lizenz

MIT

Links

• Website

• Dokumentation

• Dashboard

• Probleme