# Telesherpa

> Telesherpa verbindet die Systeme eines Unternehmens zu einem gemeinsamen
> Lagebild und laesst KI-Agenten darin arbeiten: beobachten, verknuepfen,
> Workflows ausloesen. Jeder Schritt nachvollziehbar, jede kritische Aktion
> von einem Menschen freigegeben.

Diese Website richtet sich an Menschen.

**Primaere Anlaufstelle fuer KI-Agenten ist der MCP-Server:**
`https://mcp.telesherpa.com` (Streamable HTTP, Endpoint `/mcp`)

Dort liegt alles, was ein Agent braucht: der Tool-Katalog, die
Selbstregistrierung, die Authentifizierung und der Agent-Guide.

## Selbst registrieren (ohne Browser)

Diese Tools funktionieren **ohne** Token:

1. `register(username, password, password_confirm, accept_terms=true)` — Konto anlegen.
   `accept_terms` ist **Pflicht**: damit stimmst du den Nutzungsbedingungen zu
   (<https://www.telesherpa.com/agb>). Ohne Zustimmung wird kein Konto angelegt.
   Ein 7-stelliger Voucher geht per E-Mail an die angegebene Adresse.
2. `activate(loginusername, loginpassword, voucher)` — Voucher einloesen.
3. `login(client_id, client_secret)` — liefert das Bearer-Token.
4. `refresh_access_token(refresh_token)` — Token erneuern ohne Passwort.
5. `auth_status` — Diagnose: welche Rolle, welche Tools fehlen.
6. `onto_credit_pricing` — Preise lesen.

Auth braucht **beides**: gueltigen `Authorization: Bearer` **und** die Rolle der
Session. Ohne Token antwortet der Endpoint HTTP 401 mit `WWW-Authenticate` und
`resource_metadata` — dieser Header erklaert den Registrierungsweg.

## Was der Agent kann

- 172 Tools: Ontologie-Objekte, Typen, Interfaces, Formulare, Reports,
  Scopes, i18n, Dateien, Suche, Watch/Change-Feed.
- Objekte lesen/schreiben, verknuepfen, Eigenschaften setzen, Aktionen ausfuehren.
- Reports aggregieren, als CSV oder JSON ausgeben.
- Formulare: Definitionen verwalten, Antworten einreichen und auswerten.
- Rechte: Rollen (admin, telesherpa) und Scopes; Zugriff ist fail-closed —
  ohne `scopes_profiles.can_manage_scope` kein Zugriff.

## Optional

- [Agent-Guide (SKILL.md)](https://codeberg.org/telesherpa/skill-telesherpa-com)
  — vollstaendiges Onboarding fuer Agenten, Version 1.0.0
- OAuth-Metadaten: `/.well-known/oauth-protected-resource` und
  `/.well-known/oauth-authorization-server` (PKCE S256, Dynamic Client Registration)
- Maschinenlesbarer Eintrag in der offiziellen MCP-Registry:
  `com.telesherpa/ontology-platform`
- Nutzungsbedingungen: <https://www.telesherpa.com/agb> (deutsch, rechtlich bindend) und
  <https://www.telesherpa.com/en/agb> (englische Fassung)
- [Impressum](https://www.telesherpa.com/impressum)
- [Datenschutz](https://www.telesherpa.com/datenschutz)