ComposioHQ/Ashby-Automation

Ashby-Automatisierung

Automatisieren Sie Ihre Ashby-ATS-Rekrutierungsvorgänge direkt über Claude Code. Erstellen Sie Kandidaten, veröffentlichen Sie Jobs, verwalten Sie Bewerbungen, sehen Sie sich Interviewzeitpläne an und durchsuchen Sie Ihre Talentpipeline – alles ohne Ihre Terminal-Umgebung zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/ashby

---

Einrichtung

1. Fügen Sie den Rube MCP-Server zu Ihrer Claude Code-Konfiguration hinzu, mit der URL: https://rube.app/mcp
2. Authentifizieren Sie Ihr Ashby-Konto nach Aufforderung über den bereitgestellten Verbindungslink
3. Beginnen Sie mit der Automatisierung Ihrer Rekrutierungsworkflows mit natürlicher Sprache

---

Kernworkflows

1. Kandidaten verwalten

Erstellen, auflisten, suchen, aktualisieren und detaillierte Kandidateninformationen abrufen.

Tools: ASHBY_CREATE_CANDIDATE, ASHBY_LIST_CANDIDATES, ASHBY_SEARCH_CANDIDATES, ASHBY_GET_CANDIDATE_INFO, ASHBY_UPDATE_CANDIDATE

Erstelle einen Kandidaten namens „Max Mustermann” mit der E-Mail [email protected] und dem LinkedIn-Profil https://linkedin.com/in/maxmustermann

Wichtige Parameter für ASHBY_CREATE_CANDIDATE:

• name (erforderlich) – Vollständiger Name des Kandidaten
• email – Primäre E-Mail-Adresse
• phoneNumber, linkedInUrl, githubUrl, websiteUrl – Kontakt-/Social-Profile

Wichtige Parameter für ASHBY_SEARCH_CANDIDATES:

• email – Exakte E-Mail-Übereinstimmung
• name – Partielle Namensübereinstimmung

Wichtige Parameter für ASHBY_LIST_CANDIDATES:

• perPage (max. 100) / cursor – Paginierung
• syncToken – Für inkrementelle Updates seit der letzten Synchronisation

2. Jobs erstellen und auflisten

Neue Stellenausschreibungen veröffentlichen und bestehende Positionen durchsuchen.

Tools: ASHBY_CREATE_JOB, ASHBY_LIST_JOBS, ASHBY_GET_JOB_INFO

Erstelle einen neuen „Senior Software Engineer“-Job im Team dept-123 am Standort loc-456 mit der Brand brand-789

Wichtige Parameter für ASHBY_CREATE_JOB:

• title (erforderlich) – Jobtitel
• teamId (erforderlich) – Abteilungs-/Team-ID (aus Liste der Abteilungen)
• locationId (erforderlich) – Bürostandort-ID (aus Liste der Standorte)
• brandId (erforderlich) – Arbeitgebermarken-ID (aus Liste der Marken)
• defaultInterviewPlanId – Erforderlich, um den Job für Bewerbungen zu öffnen
• jobTemplateId – Vorlage zur Vorausfüllung

Wichtige Parameter für ASHBY_LIST_JOBS:

• perPage (max. 100) / cursor / syncToken – Paginierung und inkrementelle Synchronisation

Hinweis: Neu erstellte Jobs beginnen im Status „Entwurf”. Sie müssen eine defaultInterviewPlanId festlegen, um den Job zu öffnen/zu veröffentlichen.

3. Bewerbungen verwalten

Erstellen Sie Bewerbungen, um Kandidaten mit Jobs zu verknüpfen und deren Fortschritt zu verfolgen.

Tools: ASHBY_CREATE_APPLICATION, ASHBY_LIST_APPLICATIONS

Bewerbe Kandidat cand-abc123 auf Job job-xyz789 mit Quelle src-referral

Wichtige Parameter für ASHBY_CREATE_APPLICATION:

• candidateId (erforderlich) – UUID eines vorhandenen Kandidaten
• jobId (erforderlich) – UUID eines vorhandenen Jobs
• sourceId – UUID der Bewerbungsquelle (LinkedIn, Empfehlung, etc.)
• creditedToUserId – UUID des verantwortlichen Recruiters/Referenten
• interviewStageId – Direkte Platzierung in eine bestimmte Phase (Standard ist die erste Phase)

Wichtige Parameter für ASHBY_LIST_APPLICATIONS:

• perPage (max. 100) / cursor / syncToken – Paginierung und inkrementelle Synchronisation

4. Interviewzeitpläne anzeigen

Listen Sie geplante Vorstellungsgespräche mit Zeitplan, Interviewer und Kandidatendetails auf.

Tool: ASHBY_LIST_INTERVIEW_SCHEDULES

Zeige mir alle anstehenden Interviewzeitpläne

Wichtige Parameter:

• perPage (max. 100) / cursor – Paginierung
• syncToken – Inkrementelle Synchronisation für geänderte Zeitpläne

5. Kandidatennotizen

Zeigen Sie interne Notizen, Beobachtungen und Recruiter-Kommentare zu Kandidaten an.

Tool: ASHBY_LIST_CANDIDATE_NOTES

Zeige mir alle Notizen für Kandidat cand-abc123

• Ruft alle Notizen ab, die von Recruitern und Teammitgliedern hinzugefügt wurden
• Nützlich zum Überprüfen von Interview-Feedback und internen Bewertungen

6. Pipeline-Berichterstattung

Kombinieren Sie Auflistungstools, um Einstellungspipeline-Berichte zu erstellen.

Tools: ASHBY_LIST_CANDIDATES, ASHBY_LIST_APPLICATIONS, ASHBY_LIST_JOBS

Liste alle Bewerbungen auf, um den aktuellen Stand unserer Einstellungspipeline zu sehen

• Verwenden Sie syncToken für inkrementelle Datenabrufe (effizient für wiederkehrende Berichte)
• Kombinieren Sie Kandidaten-, Bewerbungs- und Jobdaten für vollständige Pipeline-Transparenz
• Durchsuchen Sie alle Ergebnisse mit cursor für vollständige Datensätze

---

Bekannte Fallstricke

• Jobs beginnen im Entwurf: Neu erstellte Jobs über ASHBY_CREATE_JOB beginnen im Status „Entwurf” und können erst Bewerbungen annehmen, wenn eine defaultInterviewPlanId festgelegt und der Job geöffnet wurde.
• Vier Pflichtfelder für Jobs: ASHBY_CREATE_JOB erfordert title, teamId, locationId und brandId. Verwenden Sie die Endpunkte zum Auflisten von Abteilungen, Standorten und Marken, um gültige IDs zu finden.
• Kandidat vor Bewerbung: Ein Kandidat muss existieren, bevor eine Bewerbung erstellt werden kann. Erstellen oder finden Sie zuerst den Kandidaten, dann erstellen Sie die Bewerbung.
• Cursor-basierte Paginierung: Alle Auflistungsendpunkte verwenden cursor-basierte Paginierung mit perPage (max. 100) und cursor. Sie können nicht zu beliebigen Seiten springen – Sie müssen sequenziell iterieren.
• syncToken für Effizienz: Verwenden Sie den syncToken aus vorherigen Antworten, um nur geänderte Datensätze abzurufen. Dies reduziert die Anzahl der API-Aufrufe für wiederkehrende Workflows drastisch.
• UUID-Format überall: Alle IDs (Kandidaten, Jobs, Bewerbungen, Phasen) sind UUIDs. Die Übergabe fehlerhafter IDs führt zu 400-Fehlern.
• Sucheinschränkungen: ASHBY_SEARCH_CANDIDATES unterstützt die exakte E-Mail-Übereinstimmung oder partielle Namensübereinstimmung, aber keine kombinierten Abfragen oder andere Felder. Für umfassendere Suchen verwenden Sie ASHBY_LIST_CANDIDATES mit Paginierung.

---

Kurzübersicht

Tool-Slug	Beschreibung
ASHBY_CREATE_CANDIDATE	Erstellen Sie einen neuen Kandidaten (erfordert name)
ASHBY_LIST_CANDIDATES	Listen Sie alle Kandidaten mit Paginierung und Synchronisation auf
ASHBY_SEARCH_CANDIDATES	Durchsuchen Sie Kandidaten per E-Mail oder Name
ASHBY_GET_CANDIDATE_INFO	Rufen Sie vollständige Kandidatendetails ab (erfordert candidateId)
ASHBY_UPDATE_CANDIDATE	Aktualisieren Sie Kandidatenprofilinformationen
ASHBY_LIST_CANDIDATE_NOTES	Listen Sie interne Notizen für einen Kandidaten auf
ASHBY_CREATE_JOB	Erstellen Sie eine Stellenausschreibung (erfordert title, teamId, locationId, brandId)
ASHBY_LIST_JOBS	Listen Sie alle Jobs mit Paginierung und Synchronisation auf
ASHBY_GET_JOB_INFO	Rufen Sie vollständige Jobdetails per ID ab
ASHBY_CREATE_APPLICATION	Bewerben Sie einen Kandidaten auf einen Job (erfordert candidateId, jobId)
ASHBY_LIST_APPLICATIONS	Listen Sie alle Bewerbungen mit Paginierung und Synchronisation auf
ASHBY_LIST_INTERVIEW_SCHEDULES	Listen Sie geplante Vorstellungsgespräche mit Paginierung auf

---

Powered by Composio