contratando-mcp

MCP-Server, damit ein KI-Agent (Hermes) Contratando steuern kann — vollständiges Lesen und Schreiben der Plattform: Stellenangebote, Unternehmen, Kandidaten, Bewerbungen, Credits, Abonnements, Provisionen, Benutzer und Konfiguration.

So funktioniert es

Dieses Repo hat keinen Zugriff auf die Datenbank. Es ist ein dünner Client: Jedes Tool, das der Agent aufruft, wird per HTTPS an POST {MCP_BRIDGE_URL}/api/mcp weitergeleitet, eine geschützte Route innerhalb der Contratando-App selbst (bereits in Produktion). Die Produktionsdatenbank ist bewusst privat — diese Brücke ist der Weg, sie zu steuern, ohne sie dem Internet auszusetzen.

Hermes → contratando-mcp (stdio, local) → HTTPS + secreto → contratandord.com/api/mcp → Postgres (privada)

Die eigentliche Logik (welche Mutation jedes Tool ausführt, Validierung, Auditierung) lebt im Repo von Contratando (src/lib/mcp/registro.ts). Dieses Repo deklariert nur die 46 Tools (Name, Beschreibung, Eingabeschema), damit der Agent weiß, was er anfragen kann.

Wenn du scraper_mensajes_pendientes + vacantes_importar_lote verwenden willst (der Ablauf Scraper → Entwurf → Moderation), sieh dir PARSING.md für die genaue Struktur an, die jedes Element des Stapels erwartet.

Related MCP server: HeadHunter API MCP Server

Setup

npm install
cp .env.example .env

.env ausfüllen:

• MCP_BRIDGE_URL — https://contratandord.com (oder http://localhost:3200 zum Testen gegen die lokale Umgebung).

• MCP_API_SECRET — derselbe Wert wie MCP_API_SECRET im .env von Contratando. Wenn sie nicht übereinstimmen, lehnt die Brücke alles mit 401 ab.

npm start

Mit einem Agenten verbinden

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "contratando": {
      "command": "npx",
      "args": ["tsx", "C:\\ruta\\a\\contratando-mcp\\src\\server.ts"],
      "env": {
        "MCP_BRIDGE_URL": "https://contratandord.com",
        "MCP_API_SECRET": "..."
      }
    }
  }
}

Claude Code:

claude mcp add contratando -- npx tsx C:\ruta\a\contratando-mcp\src\server.ts

Für Hermes oder eine andere MCP-Runtime: Weise ihn auf npm start (oder node --import tsx src/server.ts) in diesem Verzeichnis hin, mit MCP_BRIDGE_URL/MCP_API_SECRET in der Umgebung.

Was es NICHT tut

• Es lädt keine Dateien hoch (Logo, Belege, RNC-Dokumente).

• Es bearbeitet den Lebenslauf eines Kandidaten nicht Abschnitt für Abschnitt (Erfahrung/Bildung/Sprachen einzeln) — nur das Wesentliche für Bewerbungen und Unternehmensprofil.

• talento_ficha liefert niemals Telefon/E-Mail/Ausweis — die echte Talentsuche erfordert einen auditierten Freischaltungsablauf, den diese Brücke nicht nachbildet.

• Es sendet beim Mutieren keine E-Mails und benachrichtigt Google nicht — nur In-App-Benachrichtigung. Die Website übernimmt die Änderungen von selbst (Konfigurations-Cache bis zu 30s, normales Sitemap/Crawling für SEO).

Sicherheit

• Das Geheimnis wird serverseitig mit timingSafeEqual verglichen (ohne Rückschlüsse über die Antwortzeit).

• Rate-Limit von 30 Aufrufen / 5 min pro IP an der Brücke.

• Jede Mutation wird im Audit-Log von Contratando mit datos.via: "mcp" festgehalten, dem Superadmin zugeordnet, der serverseitig in SEED_ADMIN_EMAIL konfiguriert ist.

• Wenn das Geheimnis durchsickert, rotiere es auf BEIDEN Seiten: MCP_API_SECRET im .env von Contratando (Redeploy) und hier.