troi in Claude, ChatGPT und jedem MCP-Client. Für Ihr ganzes Team.
Projekte, Kunden, Kontakte, Kalkulationspositionen, Stundenbuchungen, Abwesenheiten, Aufgaben. Ein Token in Loopthink, ein Login pro Person, Rollen pro Tool und ein Audit-Eintrag für jeden Aufruf.
Kostenlos für 2 Connectors, ohne Karte · Pro 19 € · in der EU betrieben · 22 Lese-Tools, 2 Schreib-Tools standardmäßig aus
“Welche Kalkulationspositionen des Kaufmann Relaunch liegen über ihren geplanten Stunden?”
Drei Positionen liegen über Plan:
| Position | Geplant h | Gebucht h | Abweichung |
|---|---|---|---|
| Frontend-Entwicklung | 240,0 | 287,5 | +47,5 |
| Content-Migration | 80,0 | 96,3 | +16,3 |
| Projektleitung | 60,0 | 64,8 | +4,8 |
- nur lesend
- protokolliert
Ein Token rein, die Tools kommen raus.
troi ist das ERP der Agentur: Kunden und ihre Projekte, die Kalkulationspositionen, die das Budget halten, die darauf gebuchten Stunden, Abwesenheiten, Aufgaben, Angebote und Rechnungen sowie die Abrechnungsvorschläge am Monatsende. Die Fragen sind einfach, „wie viel vom Kaufmann-Budget ist schon verbraucht“, „wer hat letzte Woche was auf den Relaunch gebucht“, aber heute brauchen sie den richtigen Mandanten, den Projektbaum und einen Bericht, den nur das Controlling auszuführen weiß.
Mit dem troi-Connector fragen Projektleitung, Controlling und Geschäftsführung in Claude oder ChatGPT und bekommen die Antwort aus der laufenden Instanz. Loopthink hält einen persönlichen Zugriffstoken von troi, jede Person meldet sich mit ihrer eigenen Identität an, und jeder Aufruf wird unter ihrem Namen protokolliert. Der Token erreicht den KI-Client nie.
Zweiundzwanzig Lese-Tools decken Mandanten, Kunden, Kontakte, Projekte, Unterprojekte, Projektstatus, Kalkulationspositionen, Zeitbuchungen, erfasste Stunden pro Mitarbeiter, Mitarbeiter, Abwesenheiten, Kalendereinträge, Aufgaben, Dokumente und Abrechnungsvorschläge ab. Die zwei Schreib-Tools, Stunden erfassen und eine Aufgabe anlegen, bleiben aus, bis Sie sie für eine Rolle einschalten.
- Controlling
“Welche Kalkulationspositionen des Kaufmann Relaunch liegen über ihren geplanten Stunden?”
Beantwortet von
list_calculation_positions - Projektleitung
“Wer hat letzte Woche Stunden auf den Kaufmann Relaunch gebucht, und auf welche Positionen?”
Beantwortet von
list_time_entries - Geschäftsführung
“Wie viele Stunden hat Jonas Rieger im September erfasst, gruppiert nach Projekt?”
Beantwortet von
get_employee_recorded_hours - Controlling
“Welche Abrechnungsvorschläge warten für Oktober?”
Beantwortet von
list_billing_proposals - Projektleitung
“Wer aus dem Design-Team ist in der zweiten Novemberwoche abwesend?”
Beantwortet von
list_absences - Projektleitung
“Buche 2,5 Stunden auf den Kaufmann Relaunch, Position „Konzeption“, für heute mit der Bemerkung „Kick-off preparation“.”
Beantwortet von
create_time_entry
Was der troi-Connector kann.
| Tool | Was es tut | Zugriff | Standard |
|---|---|---|---|
| get_current_employee | Returns the troi employee behind the token (Id, LoginName, FullName, Client). Use to test the connection and to get your own employee id for time entries, absences and tasks. | Lesen | An |
| list_clients | Lists the troi tenants (Mandanten, formerly called clients) with their Id and name. Almost every other tool needs client_id, so call this first; most installations have exactly… | Lesen | An |
| list_customers | Lists the customers of a tenant (Id, Name, Number, IsActive, Contact). Returns all matching customers at once, no paging. | Lesen | An |
| get_customer | Returns one customer with number, VAT and tax number, default email, payment term and linked contact. | Lesen | An |
| search_contacts | Searches the troi address book (persons, departments, companies). Use search for a name or company. | Lesen | An |
| get_contact | Returns one contact with office, company and private phone numbers, mail addresses and addresses. | Lesen | An |
| list_projects | Lists projects of a tenant (Name, Number, Customer, Status, Leader, descriptions). Filter by customer, status, leader or a search term. | Lesen | An |
| get_project | Returns one project with number, customer, status, leader, currency and internal/external description. | Lesen | An |
| list_project_statuses | Lists the project statuses of a tenant (id and name). Use to resolve Status on projects and to filter list_projects by project_status_id. | Lesen | An |
| list_subprojects | Lists subprojects of a tenant, optionally only those of one project or several projects. | Lesen | An |
| list_calculation_positions | Lists calculation positions (Kalkulationspositionen, the bookable budget lines of a project) with planned and spent values. Time entries are booked on these ids. | Lesen | An |
| list_time_entries | Lists recorded hours (Stundenbuchungen) of a tenant: Date, Quantity (hours), Remark, Employee, CalculationPosition, billable/billed/invoiced flags. troi requires at least one of… | Lesen | An |
| get_employee_recorded_hours | Returns the hours one employee recorded in a period, grouped by project. Use for 'how much did X work on what'. | Lesen | An |
| list_employees | Lists employees of a tenant (Id, LoginName, FirstName, LastName, FullName, SmtpAddress, IsActive). Use to resolve employee ids. | Lesen | An |
| list_absences | Lists absences (vacation, illness, etc.) in a date range, for the current employee or a given employee. Dates as YYYYMMDD numbers. | Lesen | An |
| list_absence_types | Lists the absence types (vacation, illness, ...) available to the current employee. Use to resolve the type on absences. | Lesen | An |
| list_calendar_events | Lists calendar events in a date range (YYYYMMDD). Optional search term, owner and type (R regular, H holiday, G general, P private, T assignment). | Lesen | An |
| list_tasks | Lists troi tasks, optionally by type (ApiTask:Task, ApiTask:ProjectTask, ApiTask:ProjectWarning) and by sender or assignee employee. | Lesen | An |
| get_task | Returns one task with subject, description, comment, dates, priority, status, project and employees. | Lesen | An |
| list_documents | Lists commercial documents (offers, invoices, ...) of a tenant, optionally per customer or project. Paged with from (zero-based offset) and size; increase from by size for the n… | Lesen | An |
| list_billing_proposals | Lists billing proposals (Abrechnungsvorschläge) from the troi API v3. Returns the whole list at once. | Lesen | An |
| get_billing_proposal | Returns one billing proposal from the troi API v3. | Lesen | An |
| create_time_entry | WRITE: Records hours for an employee on a calculation position. Get client_id from list_clients, calculation_position_id from list_calculation_positions (time_recording=true), e… | Schreiben | Aus |
| create_task | WRITE: Creates a general troi task (ApiTask:Task) from one employee to another, with subject, description and optional start/end date ('YYYY-MM-DD HH:MM:SS'). | Schreiben | Aus |
Schreib-Tools sind für jede Rolle aus, bis Sie sie einschalten, ein Tool für eine Rolle. Die Namen und Beschreibungen sind das, was das Modell sieht, deshalb bleiben sie englisch; es bekommt außerdem die vollständige Parameterbeschreibung jedes Tools.
So kommen Sie an den troi-Token.
Fünf Minuten, einmalig. Niemand in Ihrem Team sieht ihn je.
- 1
Als Admin: troi-Menü > Mitarbeiter > Benutzer > Benutzer auswählen > Reiter Programm > Abschnitt API, dort den API-Zugriff auf „nur lesen“ setzen (oder „lesen/schreiben“, wenn Schreib-Tools aktiviert sind).
- 2
Als dieser Benutzer anmelden und troi-Menü > Mitarbeiter > Security Center öffnen.
- 3
Unter „Persönliche Zugriffstokens“ einen Token vom Typ „API v2/v3 Bearer“ anlegen (nicht „API v3 Basic“, nicht den klassischen v2-Mitarbeitertoken, nicht OAuth2).
- 4
Den Token (troi_pat_...) kopieren und in Loopthink einfügen. Tokens laufen nach einem Jahr ab; jeder Benutzer kann höchstens 5 haben.
- 5
In Loopthink fügen Sie troi aus dem Katalog hinzu und fügen den Token ein. Außerdem fragt der Connector nach troi url. Eine Minute später sieht Ihr Team die Tools.
Der Token handelt mit den Rechten seines Benutzers. troi erzwingt „nur lesen“ auf Benutzerebene, das ist die sicherste Einstellung. Zeit für andere Mitarbeiter zu buchen braucht das Häkchen „API-Impersonation“ bei beiden Benutzern. Gehostetes troi nutzt <firma>.troi.software; die API liegt unter /api/v2/rest und /api/v3/rest auf demselben Host.
Was wir in troi zu maskieren empfehlen.
troi trägt personenbezogene Daten zu Mitarbeitern und Kontakten: Namen und Login-Namen, dienstliche und private E-Mail, Telefon- und Mobilnummern, private und Firmenadressen, Geburtstage, USt-IdNr. und Steuernummern von Kunden sowie Freitext in Bemerkungen, Beschreibungen, Kommentaren und Betreffs. Die vorgeschlagenen Felder maskieren all das und behalten Projekt, Kundennummer, Kalkulationsposition, Daten, Mengen, Status und die Abrechenbar-Kennzeichen, sodass eine Rolle für die Geschäftsführung sieht, dass 142 von 160 geplanten Stunden auf dem Kaufmann Relaunch verbraucht sind, ohne die Bemerkung an jeder Buchung zu lesen.
- Name
- Name1
- Name2
- Name3
- FirstName
- LastName
- FullName
- LoginName
- SmtpAddress
- customerDefaultEmail
- OfficeMail
- OfficePhone
- OfficeMobile
- OfficeFax
- CompanyMail
- CompanyPhone
- PrivateMail
- PrivatePhone
- PrivateMobile
- PrivateAddressStreet
- PrivateAddressCity
- PrivateAddressZipCode
- CompanyAddressStreet
- CompanyAddressCity
- CompanyAddressZipCode
- Birthday
- Remark
- VatNumber
- TaxNumber
- Description
- Comment
- Subject
troi und Loopthink
- Welchen Token-Typ und welche API-Zugriffsstufe brauchen wir?
- Einen persönlichen Zugriffstoken vom Typ API v2/v3 Bearer, angelegt im Security Center des Benutzers, in dessen Namen Loopthink handeln soll; er beginnt mit troi_pat_. Nicht den Typ API v3 Basic, nicht den klassischen v2-Mitarbeitertoken und nicht OAuth2. Setzen Sie im Reiter Programm des Benutzers den API-Zugriff für die Lese-Tools auf „nur lesen“; „lesen/schreiben“ ist nur nötig, wenn Sie create_time_entry oder create_task aktivieren. Tokens laufen nach einem Jahr ab, und jeder Benutzer kann höchstens fünf halten.
- Kann die KI Stunden für andere Mitarbeiter buchen?
- Nur mit eingeschaltetem Häkchen „API-Impersonation“ bei beiden Benutzern in troi, und nur, wenn create_time_entry in Loopthink für eine Rolle aktiviert ist. Ohne Impersonation werden Stunden für den Mitarbeiter hinter dem Token erfasst, weshalb die meisten Teams den Token auf „nur lesen“ lassen.
- troi Cloud oder On-Premises, und warum beginnt jede Frage mit dem Mandanten?
- Beides geht: Gehostetes troi läuft unter <firma>.troi.software, On-Premises auf Ihrer eigenen https-Domain; die API liegt auf demselben Host unter /api/v2/rest und /api/v3/rest. Fast jedes Tool braucht eine client_id, den troi-Mandanten, deshalb ruft das Modell zuerst list_clients auf. Die meisten Installationen haben genau einen.
- Braucht jedes Teammitglied einen eigenen troi-Account?
- Nein. Loopthink hält einen Schlüssel oder Token für troi. Ihre Leute melden sich mit ihrer eigenen Identität bei Loopthink an, und jeder Aufruf an troi wird unter ihrem Namen protokolliert. Die Lizenzen in troi bleiben, wie sie heute sind.
- Wo liegt der troi-Schlüssel?
- In Loopthink, verschlüsselt, in der EU. Er erreicht weder den KI-Client noch die Personen, die den Connector nutzen. Rotieren Sie ihn in troi, wann immer Sie wollen, und fügen Sie den neuen einmal ein.
- Kann jemand aus dem Chat heraus in troi schreiben?
- Nur, wenn Sie es einschalten. Schreibaktionen sind eine eigene Zeile in der Rechtematrix und für jede Rolle standardmäßig aus. Braucht eine Rolle ein Schreib-Tool, geben Sie genau dieses eine Tool genau dieser Rolle frei.
- Was sieht das Modell?
- Das Ergebnis des Tool-Aufrufs, nach der Maskierung. Felder, die Sie als personenbezogen markieren, etwa E-Mail-Adressen, Namen oder Kartendaten, werden maskiert, bevor die Antwort zu den KI-Client reist. Das Modell bekommt die Zahlen, nicht die Menschen.
- Was kostet es?
- Kostenlos für eine Person und zwei Connectors, ohne Karte. Pro kostet 19 € im Monat für bis zu fünf Personen und jeden Connector auf dieser Seite, mit Rollen, feldgenauer Maskierung und 30 Tagen Audit-Log. Team kostet 49 € für zehn Personen und bringt Ihre eigenen REST-APIs und SQL-Datenbanken, Ihre eigene Domain und Ihren eigenen Identity Provider dazu. Kein Gespräch nötig.
Hängen Sie fest, oder fehlt ein Tool? Ein Mensch, der diesen Connector kennt, antwortet innerhalb eines Arbeitstags.
