HireLab Screener — Persönlicher MCP-Connector

Ermöglicht Claude, aus deinem HireLab Screener ATS zu lesen. Nur-Lese-Zugriff und sicher: Claude meldet sich über ein Dienstkonto an und ruft deine bestehende Owner-spezifische API auf, sodass alle Mandantenisolationsregeln gelten. Claude kann suchen und lesen; bearbeiten oder löschen ist nicht möglich.

Was Claude kann (15 Tools)

Lesen (immer aktiv)

Schreiben / Aktionen (aktiv, wenn MCP_ALLOW_WRITES=true, der Standard)

Du kannst Claude jetzt einfach sagen, was getan werden soll – z. B.: „Füge Ravi Kumar (ABB, 18 LPA, Pune) zur L&T-SPS-Vakanz hinzu und setze eine Erinnerung, ihn morgen anzurufen.“

Sicherheit

• Alle Aktionen laufen über die Owner-spezifische API deines ATS; Claude berührt nur die Daten deines Unternehmens.

• Schreib-Tools tragen MCP-Anmerkungen, sodass Claude bei Bearbeitungen und E-Mail-Versand vorher bestätigt/nachfragt.

• Es gibt keine Lösch-Tools – löschen bleibt in der App.

• Setze jederzeit in Render MCP_ALLOW_WRITES=false, um sofort wieder auf Nur-Lese-Modus umzustellen.

Related MCP server: Lever ATS MCP Server

Einmalige Einrichtung

1. Dienstkonto in deinem ATS erstellen

Erstelle einen normalen ATS-Benutzer (z. B. Benutzername claude-mcp) mit einem sicheren Passwort. Ein dediziertes Konto ermöglicht es dir, den MCP-Zugriff jederzeit zu widerrufen, ohne deinen eigenen Login zu berühren. Es muss deinem Unternehmen gehören, damit es deine Daten sehen kann.

2. Diesen Ordner als NEUEN Render-Dienst bereitstellen

• Lege diesen Ordner in ein Git-Repository (oder einen Unterordner) und erstelle einen neuen Render Web Service, der darauf zeigt (getrennt von der DateiService).

• Render verwendet render.yaml (Build: Abhängigkeiten installieren; Start: python mcp_server.py).

• Setze in der Umgebung des neuen Dienstes:

  • ATS_BASE_URL = die URL deines ATS-Systems, z.B. https://hirelabscreener.onrender.com (ohne abschließenden Schrägstrich)

  • ATS_USERNAME = claude-mcp

  • ATS_PASSWORD = das Passwort des Kontos

  • MCP_SECRET = eine lange zufällige Zeichenfolge (min. 30 Zeichen). Halte sie sicher.

  • MCP_ALLOW_WRITES = true, um Aktionen zu erlauben (Hinzufügen/Bearbeiten/E-Mail), oder false für Nur-Lesen-Modus. Standard: true.

• Deploye. Prüfe, ob https://<your-mcp-service>.onrender.com/health {"status":"ok"} liefert.

3. Hinzufügen zu Claude

• Claude.ai → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen.

• Name: HireLab Screener

• URL: https://<your-mcp-service>.onrender.com/mcp – nur /mcp, keine Secret in der URL.

• OAuth Client ID / Secret – leer lassen. Klicke Hinzufügen.

• Claude öffnet die Seite „Connect HireLab Screener“ – gib dort einmal dein MCP_SECRET ein und klicke Autorisieren. Claude ist jetzt verbunden.

• Öffne im Chat das Connectors-Menü, aktiviere es und frage: „Liste meine offenen Vakanzen.“

Warum die Secret-Seite? Der Web-Connector-Flow von claude.ai erfordert auch für private Server einen OAuth-Anmeldeschritt. Der Connector führt daher einen smarten OAuth-Handshake durch. Dein MCP_SECRET ist die einmalige Anmeldung. Tokens sind 30 Tage gültig; MCP_SECRET ändern, widerruft den Zugriff sofort.

Sicherheitshinweise

• Der MCP-Endpunkt ist über deinen geheimen Pfad versteckt; ohne ihn erhalten Anfragen den Status 404.

• Die Tools sind schreibgeschützt. Um spätere Schreibaktionen (mit Bestätigung) hinzuzufügen, erweitere TOOLS in mcp_server.py.

• Rotiere den Zugriff, indem du MCP_SECRET änderst (Connector-URL aktualisieren) oder das Konto im Dienstsystem deaktivierst.

• Kostenlose Render-Dienste schlafen bei Inaktivität; nach dem Schlaak kann eine Anfrage bis zu 30 s dauern, bis sie aufwacht. Wenn du einen Dauerbetrieb möchtest, wähle den Upgrade-Plan.