Telesherpa Ontology Platform — MCP Server

Telesherpa ist eine Ontologie-Plattform (Knowledge-Graph-Plattform) für Facility Management (CAFM/IWMS, Gebäudemanagement, Corporate Real Estate Management) und Field Service. Sie ist zugleich als leichtgewichtiges, No-Code-ERP/CRM nutzbar: Objekttypen, Formulare, Regeln (Trigger) und Functions bilden Geschäftsprozesse ab, ohne Code zu schreiben.

MCP-Endpoint: https://mcp.telesherpa.com/mcp (Streamable HTTP, OAuth 2.1) Website: https://www.telesherpa.com Health: https://mcp.telesherpa.com/health (ohne Token) Dokumentation / Agent-Skill: https://codeberg.org/telesherpa/skill-telesherpa-com

Dieses Repository ist der Öffentlichkeits-Träger für die Verzeichnisse (Glama, offizielle MCP-Registry). Der Quellcode des Servers liegt nicht öffentlich. Inhalt und Pflege des Agent-Skills liegen auf Codeberg — dieses Repository verweist darauf.

Was der Server kann

Der Server stellt 175 Tools bereit. Die Sichtbarkeit hängt an der Rolle, nicht am Token: 6 Tools ohne Token, 108 mit der Rolle member, 111 mit der Rolle admin, 175 mit beiden Rollen. Ein KI-Agent kann sich selbstständig registrieren, anmelden und arbeiten — Zero-Touch-Onboarding ohne Browser.

Die Rolle hieß bis 2026-10-11 telesherpa und heißt seither member — gemeint ist dieselbe Rolle. Die Agenten-Anleitung nennt die jeweils aktuellen Zahlen: codeberg.org/telesherpa/skill-telesherpa-com.

Weitere Einsatzfelder, die die Plattform abdeckt:

• Fleet-/Flottenmanagement — Fahrzeuge, Fahrer, Prüffristen (HU, UVV), Wartungshistorie
• Field Service Management / Service Dispatch — Aufträge, Einsätze, Materialverbrauch
• CRM — Personen, Firmen, Kontakte, Beziehungen zwischen Objekten
• Workflow-Automation / Business Process Platform — Regeln, Trigger, zeitgesteuerte Funktionen
• Multi-Tenant SaaS / Self-Provisioning — Scopes je Firma, Rechte, eingebautes Credit- und Abrechnungssystem, Selbstregistrierung ohne Browser
• Structured Image Management / Digital Asset Management — Bilder in Kategorien je Scope
• Maintenance / Instandhaltung — Wartungspläne, Prüffristen, wiederkehrende Aufgaben

Zwei Wege zum Zugang (beide ohne Browser)

• Agent mit Einladungscode (empfohlen): Der Auftraggeber legt in seinem Scope einen Code an (create_invite_code), der Agent ruft register mit invite_code + accept_terms auf. Das Konto ist sofort aktiv — keine Mail, keine Aktivierung. Die Plattform erzeugt Adresse (agent-…@agents.telesherpa.com) und Passwort und gibt beide einmalig zurück; der Code vergibt beim Anlegen gleich seine Scope-Rechte.
• Mensch mit E-Mail: register mit username/password → Aktivierungscode per Mail → activate.

Ein Startguthaben gibt es nicht: Credits kommen über einen prepaid-Code des Auftraggebers (onto_credit_chargeup) oder per Karte (onto_credit_checkout).

Verbinden

Der Server spricht Streamable HTTP und unterstützt OAuth 2.1 Dynamic Client Registration (RFC 7591). Clients wie Claude, Cursor und andere MCP-Clients registrieren sich selbst — es muss keine Client-ID verteilt werden.

Endpoint:      https://mcp.telesherpa.com/mcp
Discovery:     https://mcp.telesherpa.com/.well-known/oauth-authorization-server
Protected Res: https://mcp.telesherpa.com/.well-known/oauth-protected-resource

Öffentliche Tools (ohne Token): register, activate, login, refresh_access_token, auth_status, onto_credit_pricing — damit ist Selbstregistrierung durch einen Agenten möglich (register nimmt entweder invite_code für den Agenten-Weg oder username/password für den E-Mail-Weg).

Sprachen: de_DE, en_US, fr_FR, it_IT

Betriebshinweis

POST /mcp ohne Token antwortet bewusst mit 401 — das ist der Auslöser für die OAuth-Discovery der Clients. GET /health antwortet ohne Token mit 200.

Lizenz

MIT — siehe LICENSE. Dieses Repository enthält nur Metadaten und Dokumentation; die Lizenz bezieht sich darauf.