HostTracker MCP-Server

Verbinden Sie einen KI-Assistenten mit HostTracker über das Model Context Protocol und lassen Sie ihn Ihr Überwachungskonto im Gespräch bedienen: führen Sie einen Live-Check von über 300 globalen Standorten aus, sehen Sie, was nicht erreichbar ist, erstellen oder pausieren Sie einen Monitor, planen Sie ein Wartungsfenster, prüfen Sie Vorfälle, verwalten Sie, wer benachrichtigt wird, verdrahten Sie einen Webhook, veröffentlichen Sie ein Statusseiten-Update.

Endpoint   https://mcp.host-tracker.com/mcp
Transport  streamable HTTP
Auth       Authorization: Bearer <your HostTracker API token>

Dieses Repository ist die öffentliche Seite dieses gehosteten Servers: die Verbindungsmetadaten (server.json), der Einrichtungsleitfaden pro Client (CLIENT.md) und die Sicherheitsrichtlinie (SECURITY.md). Der Server selbst ist ein gehosteter Dienst, daher gibt es hier nichts zu installieren oder auszuführen.

Verfügbarkeit: Die unten beschriebene vollständige Tool-Oberfläche wird schrittweise eingeführt. Wenn Ihr Client nach dem Verbinden nur die drei Sofortprüf-Tools auflistet, hat er die vorherige Version des Endpunkts erreicht; verbinden Sie sich erneut, nachdem die Einführung abgeschlossen ist.

In zwei Minuten verbinden

1. Token erstellen. Gehen Sie zu Integrationen → API und erstellen Sie ein Token mit den Berechtigungen, die der Assistent haben soll (beginnen Sie mit check und monitor:read).

2. Richten Sie Ihren Client auf den Endpunkt mit diesem Token in einem Authorization-Header. Konfigurationsblöcke für jeden gängigen Client finden Sie unten.

3. Laden Sie den Client neu, damit er die Tools erkennt, und fragen Sie dann in einfacher Sprache: „Ist example.com gerade erreichbar, geprüft von Europa und Asien?", „Welche meiner Monitore sind ausgefallen?", „Pausiere den Staging-Monitor bis morgen."

Claude Code

.mcp.json in Ihrem Projekt (oder ~/.claude.json für einen benutzerweiten Connector):

{
  "mcpServers": {
    "hosttracker": {
      "type": "http",
      "url": "https://mcp.host-tracker.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

Oder über die Befehlszeile:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp \
  --header "Authorization: Bearer YOUR_HOSTTRACKER_API_TOKEN"

Claude Desktop

Der Dialog „Add connector" akzeptiert nur OAuth-Connectors, und dieser Server authentifiziert sich mit einem Bearer-Token, daher verbindet sich Desktop über die mcp-remote-Brücke. Bearbeiten Sie claude_desktop_config.json:

{
  "mcpServers": {
    "hosttracker": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.host-tracker.com/mcp",
        "--header", "Authorization:${HT_AUTH}"
      ],
      "env": { "HT_AUTH": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

Die ${HT_AUTH}-Indirektion ist beabsichtigt: Einige mcp-remote-Builds teilen ein Argument an seinem ersten Leerzeichen, was ein wörtliches Authorization: Bearer ... bricht. Node.js 18 oder neuer ist erforderlich.

Cursor

~/.cursor/mcp.json für jedes Projekt oder .cursor/mcp.json für eines:

{
  "mcpServers": {
    "hosttracker": {
      "url": "https://mcp.host-tracker.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

VS Code (GitHub Copilot-Agentenmodus)

.vscode/mcp.json im Arbeitsbereich. Der inputs-Block hält das Token aus der Datei heraus, fragt einmal danach und speichert es im geheimen Speicher des Editors:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ht-token",
      "description": "HostTracker API token",
      "password": true
    }
  ],
  "servers": {
    "hosttracker": {
      "type": "http",
      "url": "https://mcp.host-tracker.com/mcp",
      "headers": { "Authorization": "Bearer ${input:ht-token}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hosttracker": {
      "serverUrl": "https://mcp.host-tracker.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_HOSTTRACKER_API_TOKEN" }
    }
  }
}

Docker (stdio-Brücke)

Für einen Client, der nur stdio spricht, oder um den Server ohne Installation von Node.js auszuprobieren, verpackt das Dockerfile des Repositorys die mcp-remote-Brücke vor dem gehosteten Endpunkt:

docker build -t hosttracker-mcp https://github.com/HostTracker/mcp.git
docker run -i --rm -e HT_TOKEN=YOUR_HOSTTRACKER_API_TOKEN hosttracker-mcp

Richten Sie den Client auf diesen docker run-Befehl als stdio-Server. Nichts von dem Dienst läuft im Container; er leitet an https://mcp.host-tracker.com/mcp unter Ihrem Token weiter.

ChatGPT und andere Clients

Jeder Client, der MCP über streambares HTTP spricht und einen statischen Header senden kann, funktioniert. Geben Sie ihm den Endpunkt https://mcp.host-tracker.com/mcp und den Header Authorization: Bearer YOUR_HOSTTRACKER_API_TOKEN. Wenn das Connector-Formular eines Clients einen API-Schlüssel- oder benutzerdefinierten Header-Authentifizierungsmodus anbietet, gehört das Token dorthin; wenn es nur OAuth anbietet, verwenden Sie die unter Claude Desktop gezeigte mcp-remote-Brücke.

Eine generische, abhängigkeitsfreie Brücke für alles, was nur einen Befehl starten kann:

npx -y mcp-remote https://mcp.host-tracker.com/mcp --header "Authorization:${HT_AUTH}"

Ausführlichere Anleitungen, Verifizierungsbefehle und Fehlerbehebung finden Sie in CLIENT.md.

Related MCP server: uptrack-mcp

Was der Assistent tun kann

Der Server stellt die HostTracker-v2-REST-API als MCP-Tools bereit. Jedes Listen-Tool akzeptiert limit (maximal 50) und cursor und gibt den nächsten Cursor zurück; jeder Zeitstempel ist in beide Richtungen in Unix-Sekunden angegeben; IDs sind undurchsichtige Zeichenfolgen.

Drei Verhaltensweisen, die Sie vor dem ersten Aufruf kennen sollten:

• Massenoperationen validieren zuerst. Ein Massenwerkzeug gibt einen Validierungsbericht zurück; der Schreibvorgang benötigt einen expliziten zweiten Aufruf mit submit=true. Massenlöschung benötigt zusätzlich confirmed=true und die Anzahl, die der Validierungslauf gemeldet hat, sodass eine Auswahl, die in der Zwischenzeit abweicht, abgelehnt wird.

• Massenoperationen und Berichte sind asynchron. Sie antworten mit einer Auftrags-ID; fragen Sie sie mit wait_for_job ab.

• Das Löschen von etwas ist nicht rückgängig zu machen, daher sind immer zwei Aufrufe erforderlich. Der erste Aufruf eines Löschwerkzeugs entfernt nichts – er gibt die Ressource zurück, damit der Assistent Ihnen zeigen kann, was gelöscht werden soll – und nur ein wiederholter Aufruf mit confirmed=true löscht. Die API gibt eine Quittung zurück, die auflistet, was entfernt wurde.

Authentifizierung und Scopes

Erstellen Sie Token unter Integrationen → API. Scopes sind pro Familie mit :read- und :write-Blättern, die sich nicht gegenseitig implizieren; ein bloßer Familienname erfüllt jedes Blatt darunter.

Gewähren Sie den engsten Satz, der die Arbeit abdeckt. Es gibt nie einen Grund, account:write zu gewähren: Der Server lehnt jeden Schreibvorgang unter /account ab, unabhängig davon, was das Token erlaubt. Wenn ein Aufruf abgelehnt wird, bitten Sie den Assistenten, get_account_quota auszuführen, das die tatsächlich vom Token getragenen Scopes meldet.

Grenzen und Kontingent

• Der Endpunkt begrenzt die Rate für jede Client-IP auf /mcp. Eine begrenzte Antwort enthält Retry-After, das der Server als Wert durchreicht; er schläft nie oder wiederholt nicht in Ihrem Namen, also entscheidet der Assistent, was zu tun ist.

• Das Kontingent Ihres API-Plans wird gegen Ihr eigenes Token durchgesetzt, genau wie bei direkten REST-Aufrufen. get_account_usage und get_account_quota melden, wo Sie stehen. Details im Leitfaden zu Fehlern und Grenzen.

• Anwendungsfehler (kein Token, falscher Scope, Kontingent erschöpft, ungültige Eingabe) kommen als gewöhnliche Tool-Ergebnisse mit einer umsetzbaren Meldung zurück, nicht als Protokollfehler.

Sicherheit

Der Server ist zustandslos und speichert nichts: Jeder Aufruf wird unter Ihrem eigenen Token an die API weitergeleitet, und die gesamte Eigentümerschaft, Kontingent- und Ratenbegrenzung erfolgt dort. Darüber hinaus verweigert er auf dem Server, unabhängig vom Token: jeden Schreibvorgang unter /account und alles, was Zahlungen, Pläne, Passwörter, Anmeldung oder die Erstellung von API-Tokens betrifft. Inhalte, die ein geprüftes Ziel kontrolliert, werden in einen begrenzten, in der Länge begrenzten Block eingebettet, bevor sie das Modell erreichen, sodass ein feindliches Ziel keine Anweisungen in Ihren Assistenten einschleusen kann. Vollständige Richtlinie in SECURITY.md.

Links

• MCP-Server-Übersicht

• API-Token erstellen

• API-v2-Referenz und Leitfäden

• Alle Integrationen

• Offizielle Clients: JavaScript · Python · Go · .NET · CLI · OpenAPI-Beschreibung · GitHub Action

• Support: ht2support@host-tracker.com

Lizenz

Der Inhalt dieses Repositorys (Dokumentation und Metadaten) ist unter der MIT-Lizenz veröffentlicht. Der gehostete MCP-Server und der HostTracker-Dienst selbst sind proprietär.