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)

Related MCP server: dynadot-mcp

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

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.