Automatisierung
MCP-Tools-Referenz
Das sind die Tools, die der MCP-Server bereitstellt, in seiner lokalen wie seiner gehosteten Form. Jedes reicht eine einzelne Management-API-Operation weiter, also ist die Berechtigung, die ein Tool braucht, die Berechtigung, die diese Operation braucht; der Token des Agenten muss sie halten. Der Katalog und die Beschreibungen kommen vom Server selbst; für das genaue Anfrage- und Antwort-Schema der Operation hinter einem Tool sieh dir die interaktive API-Referenz an.
Ein Tool läuft nur, wenn der Token dahinter die zugrunde liegende Operation ausführen darf. Die Spalte Berechtigung nutzt diese Werte, die auf das Modell aus Berechtigungen und Geltungsbereich der Teams abbilden:
| Wert | Bedeutet |
|---|
| Account | Jeder gültige Token auf dem Konto. Token- und Sitz-prägende Tools brauchen zusätzlich eine Konto-Master-Anmeldedatei (eine Dashboard-Session oder das Personal Access Token); ein Team-Token kann keine Tokens oder Sitze prägen. |
| read | Die read-Berechtigung. Site-eingeschränkte Tools verlangen zusätzlich, dass der Site-Key im Geltungsbereich des Tokens ist. |
| create | Die create-Berechtigung auf dem Team (einen Site-Key darin erstellen). |
| edit | Die edit-Berechtigung, eingeschränkt auf den Site-Key, den das Tool anvisiert. |
| manage | Die manage-Berechtigung: Team-Administration (Mitglieder, Tokens, teamweite Einstellungen). |
Ein paar Tools brauchen auch eine Tarifstufe, in der Beschreibung vermerkt: White-Labeling ist Apex, Spiel-Sprach- und Skin-Anpassung ist Alpha und höher, und Audit-Logs sind Apex.
| Tool | Tut | Berechtigung |
|---|
caputchin_ping | Gesundheitscheck; gibt die aufgelöste Konto-id zurück, wenn der Token gültig ist. | Account |
caputchin_get_account | Das authentifizierte Konto (id, E-Mail, Tarif). | Account |
caputchin_me_billing | Abrechnungs-Zusammenfassung (Tarif, Status, Periode). | Account |
caputchin_get_seats | Sitznutzung fürs Konto (belegt, gesamt, Aufschlüsselung). | Account |
| Tool | Tut | Berechtigung |
|---|
caputchin_list_tokens | Die Tokens des Kontos auflisten; gibt nie Secrets zurück. | Account |
caputchin_create_token | Einen Token prägen (type troop oder account); Wert einmal zurückgegeben. | Account (master) |
caputchin_rotate_token | Das Secret eines Tokens rotieren; neuer Wert einmal zurückgegeben. | Account (master) |
caputchin_revoke_token | Einen Token widerrufen; sofort wirksam. | Account (master) |
caputchin_invite_seat_user | Einen Nutzer in ein Team einladen (sitz-bewusst); verbraucht einen Sitz, wenn neu. | Account (master) |
caputchin_remove_seat_user | Einen Nutzer aus jedem Team im Konto entfernen. | Account (master) |
caputchin_mint_seat_pat | Einen Team-Token in einem Aufruf prägen und anhängen; Wert einmal zurückgegeben. | Account (master) |
caputchin_attach_seat_pat | Einen bestehenden Team-Token an ein anderes Team anhängen. | Account (master) |
caputchin_revoke_seat_pat | Einen Team-Token kontoweit widerrufen. | Account (master) |
| Tool | Tut | Berechtigung |
|---|
caputchin_list_troops | Die Teams des Kontos auflisten. | Account |
caputchin_get_troop | Ein Team per id. | read |
caputchin_create_troop | Ein geteiltes Team erstellen. | Account |
caputchin_rename_troop | Ein Team umbenennen. | manage |
caputchin_delete_troop | Ein Team löschen; verweigert, wenn es noch Site-Keys besitzt. | manage |
caputchin_list_troop_members | Die Mitglieder eines Teams mit ihren Berechtigungen und Geltungsbereich. | read |
caputchin_add_troop_member | Einen Nutzer per E-Mail mit Berechtigungen und Geltungsbereich hinzufügen; kann einen Sitz verbrauchen. | manage |
caputchin_update_troop_member | Die Berechtigungen oder den Geltungsbereich eines Mitglieds ändern. | manage |
caputchin_remove_troop_member | Ein Mitglied entfernen; gibt seinen Sitz frei, wenn es sein letzter war. | manage |
caputchin_list_troop_pats | Die an ein Team angehängten Team-Tokens. | read |
caputchin_attach_troop_pat | Einen Team-Token mit Berechtigungen und Geltungsbereich anhängen; verbraucht einen Sitz. | manage |
caputchin_update_troop_pat | Die Berechtigungen oder den Geltungsbereich eines angehängten Tokens ändern. | manage |
caputchin_detach_troop_pat | Einen Team-Token ablösen; gibt seinen Sitz frei. | manage |
caputchin_get_troop_security | Die Sicherheitseinstellungen eines Teams (die Spiel-erzwingen-Obergrenze). | read |
caputchin_update_troop_security | Die Spiel-erzwingen-Obergrenze fürs Team setzen. | manage |
| Tool | Tut | Berechtigung |
|---|
caputchin_list_sites | Alle Site-Keys über die Teams des Kontos. | read |
caputchin_get_site | Ein Site-Key per id. | read |
caputchin_create_site | Einen Site-Key erstellen (in einem Team oder Personal); gibt das Einmal-Secret zurück. | create |
caputchin_update_site | Den Namen oder das Deaktiviert-Flag eines Keys aktualisieren. | edit |
caputchin_delete_site | Einen Key löschen; kaskadiert Sessions und Config. Unumkehrbar. | edit |
caputchin_rotate_site_secret | Das Secret rotieren; das alte stoppt sofort; neues einmal zurückgegeben. | edit |
caputchin_get_site_cap_config | Die Proof-of-Work-Config eines Keys. | read |
caputchin_update_site_cap_config | Die Proof-of-Work-Config aktualisieren. | edit |
caputchin_get_site_security | Die Sicherheitseinstellungen eines Keys (das Spiel-verlangen-Gate). | read |
caputchin_update_site_security | Das Spiel-verlangen-Gate pro Key umschalten. | edit |
caputchin_list_site_sessions | Jüngste Verifizierungs-Sessions für einen Key. | read |
| Tool | Tut | Berechtigung |
|---|
caputchin_get_hosted_verification | Die Config der gehosteten Verifizierung eines Keys. | read |
caputchin_set_hosted_verification | Das Aktivieren-Flag und die Ziele setzen. | edit |
caputchin_test_hosted_verification | Eine synthetische Zustellung an die konfigurierten Ziele feuern. | edit |
| Tool | Tut | Berechtigung |
|---|
caputchin_site_stats | Site-Verifizierungsstatistik über einen Zeitraum. | read |
caputchin_site_stats_dashboard | Site-Statistik-Dashboard-Hochrechnung. | read |
caputchin_site_stats_activity | Site-Statistik-Aktivitätsreihe. | read |
caputchin_site_stats_durations | Site-Statistik-Timing-Perzentile. | read |
caputchin_site_stats_rejections | Site-Ablehnungszähler. | read |
caputchin_troop_stats | Team-Statistik-Lebenszeit-Summen. | read |
caputchin_troop_stats_dashboard | Team-Statistik-Dashboard-Hochrechnung. | read |
caputchin_troop_stats_activity | Team-Statistik-Aktivitätsreihe. | read |
caputchin_troop_stats_durations | Team-Statistik-Timing-Perzentile. | read |
caputchin_troop_stats_rejections | Team-Ablehnungszähler. | read |
caputchin_quick_stats_sites | Kompakter Statistik-Snapshot pro Site über das Konto. | read |
caputchin_quick_stats_troops | Kompakter Statistik-Snapshot pro Team über das Konto. | read |
caputchin_site_delivery_dashboard | Zustellungsstatistik der gehosteten Verifizierung für eine Site. Apex. | read |
caputchin_troop_delivery_dashboard | Zustellungsstatistik der gehosteten Verifizierung für ein Team. Apex. | read |
caputchin_account_audit_logs | Audit-Log auf Kontoebene. Apex. | Account |
caputchin_troop_audit_logs | Team-Audit-Log. Apex. | read |
caputchin_site_audit_logs | Site-Key-Audit-Log. Apex. | read |
| Tool | Tut | Berechtigung |
|---|
caputchin_list_games | Marketplace-Spiele auflisten. | Account |
caputchin_search_games | Marketplace-Spiele per Text durchsuchen. | Account |
caputchin_get_game | Ein Marketplace-Spiel per id. | Account |
Diese zielen auf einen Geltungsbereich (einen Site-Key oder ein Team), also braucht eine Site-eingeschränkte Änderung edit auf diesem Key und eine teamweite Änderung manage. Sprach- und Skin-Anpassung ist Alpha und höher.
| Tool | Tut | Berechtigung |
|---|
caputchin_list_customized_games | Die registrierten (installierten) Spiele eines Geltungsbereichs. | read |
caputchin_register_customized_game | Ein Spiel auf einem Geltungsbereich registrieren (installieren); pinnt einen Snapshot. | edit (site) or manage (troop) |
caputchin_repin_customized_game | Ein registriertes Spiel auf die neueste Version neu pinnen. | edit (site) or manage (troop) |
caputchin_update_customized_game | Die Einstellungen eines registrierten Spiels aktualisieren (Auto-Update). | edit (site) or manage (troop) |
caputchin_delete_customized_game | Ein registriertes Spiel aus einem Geltungsbereich deinstallieren. | edit (site) or manage (troop) |
caputchin_list_game_presets | Anpassungs-Presets für einen Geltungsbereich und ein Spiel. | read |
caputchin_set_game_preset | Ein Spiel-Preset erstellen oder aktualisieren. Alpha+. | edit (site) or manage (troop) |
caputchin_delete_game_preset | Ein Spiel-Preset löschen. Alpha+. | edit (site) or manage (troop) |
caputchin_set_game_default | Das Standard-Spiel-Preset für eine Achse setzen. Alpha+. | edit (site) or manage (troop) |
caputchin_get_custom_game_schema | Das Feld-Schema eines Custom-Spiels für einen Geltungsbereich. | read |
caputchin_set_custom_game_schema | Das Feld-Schema eines Custom-Spiels setzen. Alpha+. | edit (site) or manage (troop) |
caputchin_delete_custom_game_schema | Das Feld-Schema eines Custom-Spiels löschen. Alpha+. | edit (site) or manage (troop) |
caputchin_upload_custom_game_run | Das Headless-Run-Artefakt eines Custom-Spiels hochladen. | edit (site) or manage (troop) |
caputchin_get_custom_game_run | Die Referenz auf das gespeicherte Run-Artefakt eines Custom-Spiels holen. | read |
caputchin_delete_custom_game_run | Das Run-Artefakt eines Custom-Spiels löschen. | edit (site) or manage (troop) |
Das Widget-Hülle per White-Label anzupassen ist eine Apex-Funktion. Wie bei der Spiel-Anpassung braucht eine Site-eingeschränkte Änderung edit und eine teamweite manage.
| Tool | Tut | Berechtigung |
|---|
caputchin_list_white_label_presets | White-Label-Presets für einen Geltungsbereich. | read |
caputchin_set_white_label_preset | Ein White-Label-Preset erstellen oder aktualisieren. Apex. | edit (site) or manage (troop) |
caputchin_delete_white_label_preset | Ein White-Label-Preset löschen. Apex. | edit (site) or manage (troop) |
caputchin_set_white_label_default | Das Standard-White-Label-Preset für eine Achse setzen. Apex. | edit (site) or manage (troop) |
