SosoAPI installieren: Pakete, Clients und Remote-MCP

Welches npm-Paket soll ich installieren?

Installiere für neue Einrichtungen sosoapi. @sosoapi/cli, sosoapi-cli und sosoapi-mcp sind Aliase derselben exakten sosoapi-Version. Sie bieten dieselben CLI- und MCP-Tools; ein Paket reicht.

Lokales MCP braucht Node.js 20 oder neuer und npm/npx. Gehostetes MCP braucht kein lokales Paket. Melde dich nach Installation oder Verbindung an, um Kontozugriff zu erteilen.

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

Lokalen MCP-Client verbinden

Ergänze mit den folgenden Befehlen eine Verbindung mit core-Profil. Ist SosoAPI bereits verbunden und funktionsfähig, behalte diese Verbindung. sosoapi ohne Argumente startet den stdio-MCP-Server; er wartet auf stdin auf den Client.

Füge für Claude Desktop, Cursor oder andere stdio-Clients das folgende JSON in die MCP-Einstellungen ein. Ort und Freigabeschritte variieren je Client. Starte oder verbinde bei Bedarf neu und prüfe verfügbare SosoAPI-Tools im Gespräch.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• MCP-Tool-Referenz

Remote-MCP mit OAuth verbinden

Füge in einem Client mit Remote-MCP-, OAuth- und dynamischer Clientregistrierungsunterstützung die folgende URL hinzu. Melde dich im Browser an und wähle erlaubte Workspaces und Aktionen. Du musst keinen API-Schlüssel, keine Client-ID und kein Client-Geheimnis einfügen. Importiere Medien über HTTP per öffentlicher URL; lokale Dateiuploads benötigen den lokalen MCP-Server.

Eigene ChatGPT-Apps und Claude-Remote-Verbindungen hängen von Tarif und verfügbaren Client-Einstellungen ab. Diese Anleitung richtet eine eigene Verbindung ein; sie beschreibt keinen App-Verzeichniseintrag.

https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp

• Authentifizierung und Berechtigungen

Einrichtung ohne Veröffentlichung prüfen

Prüfe den Authentifizierungsstatus und melde dich bei Bedarf an. Lies Workspace-Kontext und verbundene Konten und bestätige, dass das zurückgegebene Konto und der Workspace den gewünschten entsprechen. Dies prüft Zugriff ohne Beitragseinreichung; Veröffentlichung hängt weiterhin von den Kontoberechtigungen ab.

Du musst zur Einrichtung keinen Testbeitrag veröffentlichen. Setze die ursprüngliche Aufgabe mit ihren bestehenden Inhalten fort. Der Nutzer erteilt die Anbieterzustimmung und prüft Ziel, Inhalt und Zeitpunkt vor jedem angeforderten Schreibvorgang.

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

Version aktualisieren oder festlegen

Führe npx -y sosoapi@latest --help aus, um die aktuelle CLI abzurufen, und starte deinen MCP-Client neu. Ist ein Befehl im Client gespeichert, trage die gewünschte Version in dessen args ein. Aliase bleiben an ihre genaue sosoapi-Version gebunden; das Aktualisieren einer separaten globalen Installation aktualisiert sie nicht.

Vergleiche bei Versionsabweichungsfehlern den installierten Vertrag mit der benötigten Operation. Aktualisiere das Paket im tatsächlich vom MCP-Client verwendeten Befehl, verbinde neu und versuche die Operation erneut. Schemaabweichungen erfordern keine neuen Zugangsdaten oder breiteren Zugriff.

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• Fehlerbehebung