allinkl-mcp

MCP-Server für die All-Inkl KAS-API — DNS, Domains, Subdomains, Mail-Postfächer, Mail-Weiterleitungen und Datenbanken verwalten, plus DB-Dump via SSH+mysqldump.

Die KAS-API kann Datenbanken nur anlegen/löschen — kein Dump. Deshalb läuft database_dump über SSH auf dem KAS-Paket.

Setup

cd ~/Projects/allinkl-mcp
pnpm install
cp .env.example .env      # dann .env ausfüllen
pnpm build

.env:

• KAS_LOGIN — Account-Nummer, z.B. wXXXXXX
• KAS_AUTH_DATA — API-Passwort (KAS → Tools → API, nicht das Login-Passwort)
• KAS_SSH_HOST — Host-Alias aus ~/.ssh/config, der auf die KAS-Shell führt (für database_dump)

Erstmal testen (ohne MCP)

pnpm kas get_databases
pnpm kas get_dns_settings '{"zone_host":"example.com"}'

Der erste Call ist der echte Test der SOAP-Signatur — falls KAS meckert, justieren wir src/kas/client.ts (Param-Name / Response-Unwrap).

In Claude Code einbinden

{
  "mcpServers": {
    "allinkl": {
      "command": "node",
      "args": ["/path/to/allinkl-mcp/dist/index.js"]
    }
  }
}

Sicherheit (wichtig — geteilter Produktiv-Account)

• Read-only per Default. add/update/delete sind gesperrt, bis KAS_ALLOW_WRITES=1 gesetzt ist (dann MCP neu starten). Reads + database_dump gehen immer.
• kas_raw: nur get_*-Actions ohne Flag; alles andere braucht Writes on.
• DB-Passwörter werden in database_list geschwärzt (opt-in via reveal_passwords: true).
• Calls werden serialisiert (kein Flood-Race), Flood-Fehler werden einmal automatisch wiederholt, SOAP-Calls haben Timeout.

Verifizierungs-Status der Schreib-Params:

• DNS add/update/delete — ✅ live verifiziert (add setzt automatisch den von KAS geforderten Trailing-Dot auf die Zone).
• subdomain / mail / mailforward / database / ftp / cronjob add/update/delete — ⚠️ noch nicht verifiziert. Vor erstem echten Einsatz an einem unkritischen Objekt testen; Feldnamen ggf. anpassen.

Tools

Tool	Aktion
dns_list / dns_add / dns_update / dns_delete	DNS-Records
subdomain_list / subdomain_add / subdomain_delete	Subdomains
mail_list / mail_add / mail_delete	Postfächer
mailforward_list / mailforward_add	Weiterleitungen
database_list / database_add / database_delete	MySQL-DBs (CRUD)
database_dump	Dump via SSH+mysqldump
kas_raw	beliebige KAS-Action (cronjobs, ftp, ddns, …)

Noch nicht als typed Tool (via kas_raw erreichbar)

FTP-User (get/add_ftpusers), Cronjobs (*_cronjob), Mail-Filter (*_mailstandardfilter), DDNS (*_ddnsuser), Domain-Move (move_domain). Bei Bedarf als eigene Tools nachziehen.