MCP-Endpunkt für Service-Account-Reviews

Einrichtung

1. Registriere dich oder logge dich ein und öffne „Agent Setup“ in der App (die App ist auf Englisch).
2. Erzeuge ein Token. Es wird nur einmal angezeigt, gespeichert wird nur sein Hash. Jedes Token gehört zu genau einem Workspace und lässt sich widerrufen.
3. Trage den Server in deinem MCP-Client ein, mit dem Token im Authorization-Header.

{
  "mcpServers": {
    "the-it-lead": {
      "url": "https://theitlead.com/api/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Der Client muss eigene Authorization-Header unterstützen, wie es Claude Code und Cursor tun. OAuth-Anmeldung wird nicht unterstützt, deshalb können gehostete Chat-Apps, die OAuth verlangen, sich nicht verbinden. So testest du die Verbindung im Terminal:

curl -X POST https://theitlead.com/api/mcp \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

list_service_accounts

Listet die Accounts des Workspace, gefiltert nach Status oder Quellsystem.

get_service_account_record

Liest einen Account mit Owner, Zweck und Review-Terminen.

list_owner_review_gaps

Findet Accounts ohne Owner-E-Mail oder mit fehlendem oder fälligem Review. Optional nur privilegierte Accounts.

get_attestation_history

Liest alle Owner-Antworten und Reviewer-Entscheidungen zu einem Account.

export_review_summary

Liest Summen und den Status je Account für eine Kampagne.

draft_owner_followups

Liefert Entwürfe für Erinnerungstexte an Owner, die noch nicht geantwortet haben. Es wird nichts gesendet.

create_owner_review_campaign

Legt einen Kampagnenentwurf für ausgewählte Accounts an. Veröffentlichen muss ihn ein Mensch in der Web-App.

Zugriff und Grenzen

Jeder Aufruf gilt für den Workspace des Tokens. Lesende Tools liefern nur Daten aus diesem Workspace. Das einzige schreibende Tool legt einen Kampagnenentwurf an und kann keine E-Mails senden. Über MCP angelegte Entwürfe werden im Aktivitätsprotokoll mit dem Kanal MCP festgehalten. Der Endpunkt funktioniert, solange der Workspace ein aktives Abo hat.