## Warum das zählt

Eine Rolle mündlich zu beschreiben dauert eine Minute. Die Anzeige zu schreiben dauert eine Stunde. Das Schreiben kann ein KI-Assistent übernehmen: Titel, Text, Gehaltsspanne, Phasen, Qualifikationen – angelegt in Ihrem Konto als **Entwurf**, mit der Bearbeitungs-URL als Rückgabe. Auf Ihre Karriereseite gelangt nichts, bevor ein Mensch auf Veröffentlichen klickt.

## Zwei Zugänge

| | Assistent in der App | Externer MCP-Client |
|---|---|---|
| Einrichtung | Keine – der Chat liegt auf jeder [Hiring](/hiring/job_postings)-Seite | Einmalig verbinden: [KI-Assistenten verbinden](/docs/connecting-ai-assistants) |
| Clients | Kits eigener Agent | Claude Code, Claude Desktop, Codex CLI, OpenCode, Ihr eigener |
| Berechtigung | Hiring-Admin, aktives Abonnement | dasselbe, plus `hiring_write` auf der Verbindung |
| Phasen | Nur Vorlage | Vorlage **oder** Phasen, die für genau diese Stelle geschrieben werden |
| Entwurf bearbeiten | Ja | Ja |

Beide handeln **als Sie**. Keiner erreicht eine Stellenanzeige, die Sie nicht öffnen können, und keiner tut etwas, was das Webformular Ihnen verweigern würde.

## Ein Prompt, ein Entwurf

```
Bitte einen Entwurf für eine Stellenanzeige anlegen: Senior Rails Engineer,
remote in Polen, Vollzeit. Für die Phasen unsere Vorlage „Software Engineer“
verwenden. Vor den Zahlen einen Marktgehaltsvergleich abrufen. Kontext:
Rails 8, Hotwire, Postgres; Team aus sechs Leuten; diese Besetzung
verantwortet die Abrechnung und die Stripe-Migration.
```

Was der Assistent damit tut:

| Schritt | Tool | Ergebnis |
|---------|------|----------|
| 1 | `hiring_get_setup_guide` | Kontostatus und was Ihre Rolle erlaubt. Bei einem Konto ohne Stellenanzeigen liefert es zusätzlich das Schema der Phasentypen |
| 2 | `hiring_list_templates` | Ihre Kontovorlagen plus die Systemvorlagen von Kit, mit Phasenzahl |
| 3 | `compensation_get_salary_benchmark` | Eine Spanne aus echten Marktanzeigen, die Kit indexiert – erfordert das Modul Gehaltsrecherche |
| 4 | `hiring_list_credentials` | Die Qualifikations-Keys, die eine Anzeige empfehlen darf |
| 5 | `hiring_create_job_posting` | Entwurf angelegt. Gibt die ID der Anzeige und ihre Bearbeitungs-URL zurück |

Lassen Sie Schritt 3 weg, erfindet das Modell ein Gehalt aus dem Gedächtnis. Fordern Sie den Gehaltsvergleich ausdrücklich an.

## Geben Sie ihm Material an die Hand

Der Assistent kennt Ihren Tech-Stack und Ihr Team nur, wenn Sie es ihm sagen. Was einen Entwurf von generisch zu einstellungsreif hebt:

- Die letzte Anzeige, mit der Sie zufrieden waren – einfügen und dazuschreiben: gleiche Stimme, neue Rolle
- Ihre Notizen aus dem Kickoff-Gespräch, unbearbeitet
- Die tatsächlichen Rahmenbedingungen des Teams: Zeitzone, Bereitschaft, Gehaltsobergrenze und das, was die neue Person im ersten Monat verantwortet

Zwei Regeln muss der Text einhalten, und die Tools nennen dem Modell beide:

- **Markdown**, nicht HTML.
- **Kein Stellentitel im Text.** Kit stellt den Titel selbst dar; beginnen Sie mit „Über die Rolle“ oder Ihrem ersten echten Abschnitt, sonst lesen Kandidaten den Titel zweimal.

## Phasen: Vorlage oder direkt angegeben

`process_template_id` und `stages` schließen sich gegenseitig aus – beides zu übergeben ist ein Fehler.

**Vorlage.** Die IDs liefert `hiring_list_templates`. Ein Assistent ohne Kit-Konto kann zunächst Kits öffentlichen Katalog unter `https://startupkit.app/mcp` durchsuchen (ohne Anmeldung, `list_catalog_templates`).

**Direkt angegebene Phasen** – nur für MCP-Clients, für einen Ablauf, den genau diese Stelle braucht:

```json
"stages": [
  {"name": "Bewerbung", "type": "application_form"},
  {"name": "Take-Home-Aufgabe", "type": "portfolio_upload",
   "config": {"payout": {"enabled": true, "amount": 500, "currency": "USD"}}},
  {"name": "Team-Bewertung", "type": "team_review",
   "reviewers": [{"email": "ana@example.com", "role": "lead"}]},
  {"name": "Angebot", "type": "offer"}
]
```

Zehn Typen: `application_form`, `code_assignment`, `portfolio_upload`, `questionnaire`, `video`, `video_recording`, `team_review`, `live_interview`, `reference_check`, `offer`. Jeder von ihnen nimmt einen `payout`-Block. Die E-Mail-Adressen der Prüfer müssen bereits zu Teammitgliedern gehören.

> [!NOTE]
> Eine Vorlage baut die Phasen **nur beim Anlegen**. Ändern Sie die Vorlage später, erreicht das eine bereits erstellte Anzeige nie – bearbeiten Sie stattdessen die Phasen.

## Was die KI nicht kann

- **Veröffentlichen.** Kein Tool in Kit holt eine Anzeige aus dem Entwurf heraus. Das ist Absicht, keine Lücke.
- Das Einstellungsteam zuweisen oder Prüfer an einer bestehenden Phase – das geht nur in der Weboberfläche.
- Das Social-Share-Bild hochladen (`og_image`) – ebenfalls nur in der Weboberfläche.
- Eine Prozessvorlage nach dem Anlegen erneut anwenden.
- Einen Gehaltswert oder einen Schalter leeren. Bei den Update-Tools bedeutet `null` „unverändert lassen“; ein Feld zu leeren ist deshalb Sache der Weboberfläche. (`recommended_credential_keys` ist die Ausnahme: `[]` leert es.)

## Den Entwurf nachbessern

Beide Zugänge können bearbeiten, was angelegt wurde: `hiring_update_job_posting` für die Anzeige, `hiring_update_stage` für eine einzelne Phase.

Eine Anzeige anzulegen erfordert **Hiring-Admin** – der Chat in der App bietet das Tool niemandem sonst überhaupt an. Zum Bearbeiten genügt Hiring-Admin **oder** die Rolle der Personalverantwortlichen für diese Anzeige. So kann die Person, die eine Stelle betreut, ihren Entwurf weiterentwickeln, ohne Admin zu sein.

Beide Tools arbeiten partiell: Keys, die Sie weglassen, bleiben unverändert, Keys, die Sie übergeben, überschreiben. Zwei Fallen sollten Sie kennen, bevor Sie einen Agenten auf einen Entwurf loslassen:

- **`description` ersetzt den gesamten Text.** Anhängen gibt es nicht. Lassen Sie den Assistenten die Anzeige lesen, vollständig neu schreiben und dann zurückschreiben.
- **Konfigurationsabschnitte einer Phase werden komplett ersetzt, nicht tief zusammengeführt.** Wer `config.code_assignment` übergibt, überschreibt jeden Key in diesem Abschnitt – senden Sie also auch die Keys, die erhalten bleiben sollen. (`reference_check` ist der eine Abschnitt, der zusammenführt.)

Die Antwort des Update-Tools kürzt die Beschreibung auf 500 Zeichen. Um den vollständigen Text zu prüfen, lesen Sie ihn mit `hiring_get_job_posting` zurück.

## Tücken im Detail

**Remote-Stellen brauchen ein Land.** Bei `remote: true` kennzeichnet Kit die Anzeige in ihren strukturierten Daten nur dann als `TELECOMMUTE`, wenn sich ein Land auflösen lässt – aus `applicant_location_country` („Poland“, „United States“) oder ersatzweise aus dem Standort-Text. Lässt sich keines von beidem auflösen, erfährt Google Jobs nie, dass die Stelle remote ist.

**Empfohlene Qualifikationen sind eine Einladung, mehr nicht.** Die Keys stammen aus `hiring_list_credentials`. Wer sich *nach* dem Setzen bewirbt, erhält genau eine E-Mail mit der Bitte, einen Nachweis zu teilen; wer sich früher beworben hat, erhält keine E-Mail. Kit verifiziert nichts davon, bewertet nichts, erstellt keine Rangfolge und filtert niemanden danach.

**Gehaltszeitraum und Währung stehen standardmäßig auf Jahr und USD.** Nennen Sie die Währung ausdrücklich in Ihrem Prompt, wenn die Stelle nicht in den USA angesiedelt ist.

## Bevor Sie veröffentlichen

Lesen Sie den Entwurf. Ein Assistent, der über Ihr Unternehmen schreibt, schreibt aus dem, was Sie ihm gegeben haben, plus dem, was er sich dazu gedacht hat.

> [!WARNING]
> Die **Phasenbeschreibung** ist öffentlich – sie erscheint auf Ihrer Karriereseite für jeden, der dort vorbeischaut. Die **Aufgabenbeschreibung** ist privat und nur für Kandidaten lesbar, die diese Phase erreicht haben. Hat ein Assistent eine Take-Home-Aufgabe mit einem Link auf einen Datensatz geschrieben, prüfen Sie, dass dieser Link in der Aufgabenbeschreibung steht. Siehe [Phasenbeschreibung vs. Aufgabenbeschreibung](/docs/creating-a-job-posting#phasenbeschreibung-vs-aufgabenbeschreibung).

## Kurz-Check

- [ ] Hiring-Admin und aktives Abonnement – dazu `hiring_write`, wenn Sie einen externen Client nutzen
- [ ] Echtes Material einfügen: alte Anzeige, Notizen aus dem Kickoff, Rahmenbedingungen
- [ ] Den Gehaltsvergleich ausdrücklich anfordern, bevor die Zahlen geschrieben werden
- [ ] Eine Vorlage wählen oder Phasen direkt übergeben, mit Prüfern per E-Mail-Adresse
- [ ] Prüfen, dass der Text den Titel nicht wiederholt und nach Ihrem Team klingt
- [ ] Sicherstellen, dass Aufgabenlinks in der **Aufgabenbeschreibung** stehen, nicht in der Phasenbeschreibung
- [ ] Das Einstellungsteam in der Weboberfläche setzen, wenn die Stelle eingeschränkt ist
- [ ] Selbst veröffentlichen

## Wie geht es weiter

- [Eine Stellenanzeige erstellen](/docs/creating-a-job-posting) – jedes Feld, jeder Status und jede Phaseneinstellung in der Weboberfläche
- [KI-Agent und MCP-Tools](/docs/hiring-ai-agent-mcp) – der Rest des Hiring-Werkzeugkastens: Sichtung, Bewertungen, Antworten an Kandidaten
- [KI-Assistenten verbinden](/docs/connecting-ai-assistants) – MCP-Einrichtung, OAuth, Scopes
- [MCP-Tools-Referenz](/docs/mcp-tools-reference) – Parameter für jedes Tool