Tag der Ausbildung als MCP

Der Tag der Ausbildung spricht MCP. Ein Sprachmodell bekommt damit das eigene Unternehmen als Werkzeuge: Profil pflegen, Ausbildungsberufe anlegen, Bewertungen lesen.

Nur für Aussteller

Freigeben kann nur ein Konto mit der Rolle Unternehmen, dem beim Tag der Ausbildung ein Unternehmen gehört. An dieses eine Unternehmen ist das Token gebunden. Schülerkonten kommen nicht durch: sie haben kein Unternehmen, das sie wählen könnten, und erhalten deshalb gar kein Token — nicht erst am Endpunkt eine 403.

Werkzeug	Was es kann
`tda_company`	Profil lesen und bearbeiten, verfügbare Tags, Stand der Messebewerbung
`tda_jobs`	Ausbildungsberufe auflisten, abrufen, anlegen, entfernen
`tda_reviews`	Bewertungen lesen — ohne Namen oder Kennung der Schüler

Der MCP zeigt nur Werkzeuge, für die ein Scope im Token steht.

Verbinden

Im Projekt die API TdA MCP freischalten und das Aussteller-Konto verknüpfen (Konsole → Projekt → OAuth).
Die Adresse des Servers eintragen:

https://api.artim-industries.com/mcp/<projekt-id>/tda

Mehr braucht ein Client nicht: über /.well-known/oauth-protected-resource/… und /.well-known/oauth-authorization-server/… findet er den Anmeldedienst und registriert sich selbst (RFC 9728, RFC 8414, RFC 7591).

In Claude Code etwa:

claude mcp add --transport http tag-der-ausbildung https://api.artim-industries.com/mcp/prj_a7f3/tda

Der Weg der Anmeldung

MCP-Client ──(1) OAuth2 + PKCE──▶ artim/dev ──(2) OAuth2──▶ Tag der Ausbildung
                                      │                           │
                                 Consent-Screen          Unternehmensportal

Client → artim/dev. Der Client schickt den Nutzer auf /v1/oauth/authorize und holt sich unter /v1/oauth/token seinen Bearer. PKCE mit S256 ist Pflicht.
artim/dev → Tag der Ausbildung. Nach dem Consent-Screen geht es zum Tag der Ausbildung (/oauth2/authorize), der weiter ins Unternehmensportal leitet. Dort meldet sich der Aussteller mit seinem gewohnten Zugang an, sieht sein Unternehmen und bestätigt die Freigabe. Ist das Konto kein Aussteller, endet der Weg hier.

Der Client hält danach einen Bearer, der 30 Tage gilt und über /v1/oauth/token mit grant_type=refresh_token verlängert wird.

Ein Aufruf

Ein Werkzeug je Bereich, die Operation als Parameter:

{
  "name": "tda_jobs",
  "arguments": {
    "operation": "anlegen",
    "name": "Elektroniker/in für Betriebstechnik",
    "tagLines": ["3,5 Jahre", "Start 1. August"]
  }
}

Welche Operationen ein Werkzeug kennt, steht in seiner Beschreibung — und ausführlich in der Referenz dieses Produkts. Kontingent und Protokoll gelten am MCP wie am Gateway.