REST-API inklusive · MCP mit der Power-Option

REST API und MCP-Server von JOBSON 3

Übertragen Sie Kandidaten von Ihrer eigenen Website, synchronisieren Sie die Personenkartei mit einem anderen System oder verbinden Sie JOBSON mit Claude oder ChatGPT.

Registrieren und API-Schlüssel erhalten OpenAPI-Dokumentation

Die Dokumentation ist für Administratoren der Agentur nach der Anmeldung verfügbar.

JOBSON 3 bietet eine REST API für Recruiting und Personenkartei sowie einen MCP-Server für die KI-Clients Claude und ChatGPT.Die REST API ist ohne Aufpreis und ohne Kontingent im Preis enthalten. Die Authentifizierung erfolgt per API-Schlüssel der Agentur, Fehler folgen RFC 9457. Der MCP-Server ist in der Power-Option enthalten. Die OpenAPI-Dokumentation finden Sie nach der Anmeldung in der App.

Aktualisiert am 22. Oktober 2026

REST API: Recruiting, Personenkartei · im Preis · ohne Kontingent
MCP: Claude, ChatGPT · Power-Option · 10.000 bis 50.000 Aufrufe pro Monat
Authentifizierung: Bearer-API-Schlüssel der Agentur mit Berechtigungsumfang (Scopes)
Fehler: RFC 9457 (problem+json)
Dokumentation: OpenAPI in der App für Administratoren der Agentur

REST API

Typische Anwendung: Das Formular auf der Karriereseite der Agentur sendet Kandidaten direkt an JOBSON, oder die Personenkartei wird regelmäßig mit einem anderen System synchronisiert.

POST/api/recruitment/inbound
sendet einen Kandidaten in den Eingang (Duplikatprüfung, Quelle, DSGVO-Einwilligung)
GET/api/recruitment/vacancies
Liste der Aufträge
GET/api/recruitment/candidacies?zakazka={id}
Bewerbungen in Aufträgen
GET/api/recruitment/hired?od={YYYY-MM-DD}
eingestellte Kandidaten

POST/api/v1/people
legt Personen an oder aktualisiert sie (Upsert)
GET/api/v1/people
Export von Personen
GET/api/v1/people/schema
Feldschema einschließlich eigener Felder der Agentur
GET/api/v1/people/{internal_number}
eine Person nach interner Nummer
GET/api/v1/import-runs/{id}
Status eines Imports

Power-Option

MCP-Server für Claude und ChatGPT

MCP (Model Context Protocol) ist ein offener Standard, um KI-Assistenten mit Anwendungen zu verbinden. JOBSON hat einen eigenen MCP-Server: Sie verbinden ihn in Claude oder ChatGPT als Connector, und der Assistent arbeitet mit den Daten der Agentur über dieselben Werkzeuge wie der KI-Assistent in der App.

Endpoint
POST /mcp
Token an eine Person gebunden
Erstellt wird es von einem Nutzer mit entsprechender Berechtigung in der App. Ein Token kann Rechte nur einschränken, nie erweitern. Gültigkeit 30, 90 oder 365 Tage.
Schreiben nur mit ausdrücklicher Berechtigung
Ohne sie liest das Token nur.
Kontingente je Power-Option
10.000 / 20.000 / 50.000 Werkzeugaufrufe pro Monat. initialize, ping und tools/list zählen nicht. Ab 90 % kommt eine Benachrichtigung, nach Ausschöpfung werden Aufrufe abgelehnt.
Credits
KI-Vorgänge, die Werkzeuge auslösen, werden wie in der App mit Credits bezahlt.
Log
Jeder Aufruf ist in der Änderungshistorie nachvollziehbar.

Authentifizierung und Fehler

Die REST API verwendet den API-Schlüssel der Agentur im Header Authorization: Bearer. Den Schlüssel erstellt ein Administrator in den Recruiting- oder Import-Einstellungen, er gehört immer zu genau einer Gruppe von Scopes. Fehler gibt die API im Format RFC 9457 mit Code und Meldungsschlüssel zurück.

bashFiktiver Schlüssel · Beispiel

curl -X POST https://my.jobson.cloud/api/recruitment/inbound \  -H "Authorization: Bearer jb_live_XXXX" \  -H "Content-Type: application/json" \  -d '{       "fields": {         "given_name": "Max",         "family_name": "Mustermann",         "phone1": "+491511234567",         "email": "max@example.com"       },       "source_code": "web",       "consent": {         "granted": true,         "text_version": "v1",         "evidence": "web form"       }     }'

Der Schlüssel im Beispiel ist erfunden. Fügen Sie einen echten Schlüssel nie in Code ein, der im Browser läuft.

OpenAPI-Dokumentation

Die vollständige Beschreibung aller Pfade und Datenstrukturen finden Sie in der App als OpenAPI (Swagger). Die Dokumentation ist für Administratoren der Agentur nach der Anmeldung verfügbar.

OpenAPI-Dokumentation

Verfügbar nach Anmeldung als Administrator der Agentur. Eine öffentliche Referenz ist in Vorbereitung.

Integrationen

Verfügbar

Firmenregister ARES (CZ), RPO (SK), Biała Lista (PL)
Bankdateien SEPA pain.001 (EUR) und ABO (CZK) für Vorschüsse
Bewerbungseingang per weitergeleiteter E-Mail
Import und Export als CSV, JSON (Import auch XLSX, ODS, XML)
Spiegelung von Interviews in den Google Kalender
SMS und Telegram für die Kommunikation mit Kandidaten

Import von Arbeitszeiten per API direkt aus den Zeiterfassungssystemen der Kunden (Werke)
Anbindung an Ina.work
Exporte in Lohnprogramme

Erstellen Sie Ihren API-Schlüssel

Registrieren Sie Ihre Agentur kostenlos, erstellen Sie in den Einstellungen einen Schlüssel und senden Sie die erste Anfrage. 30 Tage testen ohne Kreditkarte, einschließlich Power-Option.

Registrieren und API-Schlüssel erhalten