ALSO Cloud Marketplace MCP

MCP-Server für die ALSO Cloud Marketplace Simple API — damit KI-Assistenten (Cursor, Claude, Gemini CLI, OpenAI Codex, …) direkt auf Companies, Subscriptions, Users, Invoices usw. zugreifen können.

Schnellstart

git clone https://github.com/pitwch/also-cloud-marketplace-mcp.git
cd also-cloud-marketplace-mcp
npm install
npm run build

Benötigte Umgebungsvariablen:

ALSO_CLOUD_MARKETPLACE akzeptiert eine volle URL oder einen Country-Key:
Switzerland, Germany, Austria, Debug, …

Related MCP server: SMB AI Command Platform MCP Server

Installation in Clients

Überall gilt: Server lokal starten (stdio), Credentials als env setzen.
Pfad unten durch deinen Clone ersetzen, z. B. C:/DEV/also-cloud-marketplace-mcp oder /home/you/also-cloud-marketplace-mcp.

Empfohlene Variante (gebaut)

command: node
args:    [<REPO>/dist/index.js]

Alternative (ohne Build, via tsx)

command: npx
args:    [tsx, <REPO>/src/index.ts]

Voraussetzung: zuvor npm install im Repo.

Cursor

1. Settings → MCP → Add new MCP server (oder mcp.json bearbeiten).

2. Eintrag hinzufügen:

{
  "mcpServers": {
    "also-cloud": {
      "command": "node",
      "args": ["C:/DEV/also-cloud-marketplace-mcp/dist/index.js"],
      "env": {
        "ALSO_CLOUD_MARKETPLACE": "Switzerland",
        "ALSO_CLOUDUSER": "you@example.com",
        "ALSO_CLOUDPW": "your-password"
      }
    }
  }
}

3. Server aktivieren / Cursor neu laden.

4. Im Chat Tools von also-cloud nutzen, z. B. „Liste Companies unter Parent 12345“.

Claude Desktop

1. Config öffnen: Settings → Developer → Edit Config

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

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

2. Gleichen mcpServers-Block wie bei Cursor einfügen.

3. Claude Desktop vollständig neu starten.

4. Im Chat das Hammer-/Tools-Icon prüfen — also-cloud sollte erscheinen.

Claude Code (CLI)

claude mcp add also-cloud --env ALSO_CLOUD_MARKETPLACE=Switzerland --env ALSO_CLOUDUSER=you@example.com --env ALSO_CLOUDPW=secret -- node /path/to/also-cloud-marketplace-mcp/dist/index.js

Prüfen:

claude mcp list

Gemini CLI

Config in ~/.gemini/settings.json (oder projektbezogen .gemini/settings.json):

{
  "mcpServers": {
    "also-cloud": {
      "command": "node",
      "args": ["/path/to/also-cloud-marketplace-mcp/dist/index.js"],
      "env": {
        "ALSO_CLOUD_MARKETPLACE": "Switzerland",
        "ALSO_CLOUDUSER": "you@example.com",
        "ALSO_CLOUDPW": "your-password"
      }
    }
  }
}

Oder per CLI:

gemini mcp add also-cloud --env ALSO_CLOUD_MARKETPLACE=Switzerland --env ALSO_CLOUDUSER=you@example.com --env ALSO_CLOUDPW=secret -- node /path/to/also-cloud-marketplace-mcp/dist/index.js

Docs: MCP servers with Gemini CLI

OpenAI — Codex CLI / ChatGPT Desktop / IDE

Codex nutzt TOML (~/.codex/config.toml), geteilt mit ChatGPT Desktop & Codex-IDE:

[mcp_servers.also-cloud]
command = "node"
args = ["/path/to/also-cloud-marketplace-mcp/dist/index.js"]

[mcp_servers.also-cloud.env]
ALSO_CLOUD_MARKETPLACE = "Switzerland"
ALSO_CLOUDUSER = "you@example.com"
ALSO_CLOUDPW = "your-password"

Oder:

codex mcp add also-cloud \
  --env ALSO_CLOUD_MARKETPLACE=Switzerland \
  --env ALSO_CLOUDUSER=you@example.com \
  --env ALSO_CLOUDPW=secret \
  -- node /path/to/also-cloud-marketplace-mcp/dist/index.js

codex mcp list

In der TUI: /mcp zeigt verbundene Server.

Hinweis ChatGPT Web: Custom MCP dort braucht i. d. R. einen öffentlichen HTTPS-Endpoint (Remote/Tunnel), kein lokales stdio. Für lokalen Betrieb Codex CLI / Desktop verwenden.

Docs: OpenAI MCP / Codex

VS Code (GitHub Copilot / MCP)

Je nach Extension analog Cursor: MCP-Server mit command/args/env eintragen.
Pfad auf dist/index.js zeigen und Credentials setzen.

Verwendung (Beispiele)

Nach der Anbindung kannst du natürlichsprachlich fragen:

• „Welche Marketplaces gibt es?“ → list_marketplaces

• „Zeig Companies unter Parent 523525“ → get_companies

• „Hole Subscriptions für Account …“ → get_subscriptions

• „Latest Invoices für März 2026“ → get_latest_invoices_for_period

• „Lege einen User unter Company X an“ → create_user (Write)

Discovery aller API-Endpoints:

• Tool list_api_endpoints (optional Filter tag, onlyReadable)

Tools (Überblick)

~58 Tools. Vollständige Liste inkl. Risiko-Flags: Tool list_api_endpoints.

Session & Meta

Lesen

Schreiben (gezielt freigeschaltet)

Nur über api_request (destruktiv / selten)

TerminateAccount, DeleteMarketplace*, DeleteSpecialDeal, Marketplace-Create/Delete, …
→ bewusst kein eigenes Tool, damit die KI sie nicht versehentlich aufruft.

Entwicklung

npm run dev        # stdio via tsx
npm run typecheck
npm run build
npm start          # node dist/index.js

Wichtig: Auf stdout nur MCP-JSON-RPC schreiben — Logs nur mit console.error.

Sicherheit

• Credentials nie committen; nur in Client-env oder lokaler .env (nicht für stdio-Hosts nötig, wenn env in der MCP-Config steht).

• Write-Tools ändern Produktivdaten — Clients mit Tool-Bestätigung nutzen (Cursor/Claude/Gemini Prompt).

• Destruktive Operationen bewusst hinter api_request belassen.

Links

• Repo: https://github.com/pitwch/also-cloud-marketplace-mcp

• Go-Wrapper: https://github.com/pitwch/go-also-cloud-wrapper

• Swagger: https://app.swaggerhub.com/apis-docs/MarketplaceSimpleAPI/MarketplaceSimpleAPI/1.0.0

License

MIT © Pedrett IT+Web AG