Connecteam über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Connecteam klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Connecteam + Meta Muse

Connecteam, die App für Teams ohne festen Schreibtisch: User und benutzerdefinierte Felder, die Stempeluhr mit gestempelten Schichten, Timesheet-Summen und Ein- und Ausstempeln, Schichten im Scheduler, Jobs, Formulare und Einreichungen, Quick Tasks, Abwesenheitssalden und -anträge sowie Chat-Nachrichten. Connecteam API mit einem API-Key.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten und braucht einen Owner oder Admin von Connecteam.

1. Öffne in Connecteam Settings > API Keys und klicke auf Add API key. Kopiere den Key in CONNECTEAM_API_KEY. Er gibt Zugriff auf das gesamte Konto, behandle ihn also wie ein Passwort.
2. Setze CONNECTEAM_API_HOST auf https://api.connecteam.com oder auf https://api-au.connecteam.com, wenn du dich bei app-au.connecteam.com anmeldest (australische Konten).
3. Installiere den Connector: connecteam_get_account ist die Installationsprüfung.

API-Zugriff braucht den Expert-Plan oder höher, pro Hub: Operations für Stempeluhr, Scheduler, Jobs und Aufgaben; Communications für den Chat; HR & Skills für Abwesenheiten. User, Konto und Publisher funktionieren mit jedem berechtigten Hub.

Personenbezogene Daten: User enthalten Namen, Telefonnummern, E-Mail-Adressen und benutzerdefinierte Profilfelder wie Geburtstag, Adresse oder Ausweisnummern; Zeitaktivitäten können GPS-Positionen enthalten. Frag nur nach dem, was die Aufgabe braucht.

Zuerst die IDs: Jede Stempeluhr, jeder Scheduler und jedes Task Board ist eine eigene App-Instanz. Die KI holt ihre IDs mit connecteam_list_time_clocks, connecteam_list_schedulers und connecteam_list_task_boards, bevor sie die Tools aufruft, die timeClockId, schedulerId oder taskBoardId brauchen.

Was er liest:

• Konto und Personen: connecteam_get_account, connecteam_list_users (Filter nach IDs, Namen, E-Mails, Telefonnummern, Status oder Änderungszeit), connecteam_list_custom_fields, connecteam_list_custom_field_categories und connecteam_list_smart_groups.
• Stempeluhr: connecteam_list_time_activities liefert gestempelte Schichten, manuelle Pausen und Abwesenheiten pro User, höchstens 92 Tage pro Aufruf; connecteam_get_timesheet_totals liefert Stunden pro User und Tag mit Pausen, Überstunden, Vergütung sowie Freigabe-, Einreichungs- und Sperrstatus.
• Schichtplanung: connecteam_list_shifts (Zeitraum in Unix-Sekunden), connecteam_get_shift, connecteam_list_shift_custom_fields und connecteam_list_user_unavailabilities.
• Jobs (Kunden, Einsatzorte oder Projekte, auf die Schichten und gestempelte Zeit gebucht werden): connecteam_list_jobs, connecteam_get_job und connecteam_list_job_custom_fields.
• Formulare: connecteam_list_forms, connecteam_get_form (die Fragen), connecteam_list_form_submissions und connecteam_get_form_submission mit jeder Antwort, auch Bildern und Dateilinks.
• Aufgaben: connecteam_list_tasks und connecteam_list_task_labels.
• Abwesenheiten: connecteam_list_time_off_policy_types, connecteam_list_time_off_balances und connecteam_list_time_off_requests, das nur genehmigte Anträge liefert, wenn du nicht statuses angibst.
• Chat: connecteam_list_conversations und connecteam_list_publishers.

Was er schreibt:

• Stempeluhr: connecteam_clock_in und connecteam_clock_out stempeln einen User jetzt oder zu einem Zeitstempel ein oder aus, optional auf einen Job oder eine geplante Schicht. connecteam_create_time_activities trägt vergangene Schichten oder manuelle Pausen nach (zum Beispiel ein vergessenes Einstempeln), connecteam_update_time_activities korrigiert sie. Gesperrte oder freigegebene Tage werden abgelehnt.
• Schichtplanung: connecteam_create_shifts und connecteam_update_shifts; mit isPublished true und notifyUsers true sehen die Mitarbeitenden die Schicht und werden benachrichtigt.
• Jobs: connecteam_create_jobs (auch Unterjobs mit parentId) und connecteam_update_job (title ist Pflicht).
• Aufgaben: connecteam_create_task und connecteam_update_task. Die API ersetzt die ganze Aufgabe, deshalb sendet die KI jedes Mal userIds, status und title; Status completed schließt sie ab.
• Abwesenheiten: connecteam_create_time_off_request (offen oder bereits genehmigt) und connecteam_update_time_off_request (genehmigen oder ablehnen mit status).
• User: connecteam_create_users (jeder braucht firstName, lastName, phoneNumber und userType; sendActivation schickt die Aktivierungs-SMS), connecteam_update_users, connecteam_archive_users (umkehrbar: Update mit isArchived false) und connecteam_create_user_note.
• Chat: connecteam_send_message postet in eine Unterhaltung und connecteam_send_private_message schreibt an einen User, beide mit einer Publisher-ID aus connecteam_list_publishers als senderId. Nachrichten werden sofort zugestellt.

Bei der Installation deaktiviert: connecteam_delete_user, connecteam_delete_shift und connecteam_delete_task. Sie lassen sich nicht rückgängig machen; ein Workspace-Admin schaltet sie ein, wenn das Team sie braucht. Einen User zu archivieren ist die umkehrbare Alternative.

Datenformate: Antworten sehen so aus: { "requestId": "...", "data": {...}, "paging": { "offset": n } }. Schicht-, Stempel- und Aufgabenzeiten sind Unix-Zeitstempel in Sekunden mit separater IANA-timezone; Daten in Filtern sind YYYY-MM-DD. User-IDs sind Ganzzahlen; Schicht-, Job-, Aufgaben- und Antrags-IDs sind Strings. Batch-Schreibvorgänge (connecteam_create_users, connecteam_create_shifts, connecteam_create_jobs und die Updates) nehmen eine Liste und antworten pro Eintrag.

Blättern: limit (Standard 10; das Maximum hängt vom Tool ab, bis 500) und offset. Die KI erhöht offset um limit, bis eine Seite weniger Einträge als limit liefert.

Limits und häufige Fehler: Rate Limits gelten pro Konto und Plan (Expert: 100 Anfragen pro Minute und 10.000 pro Tag) und antworten mit 429. 401 oder 403 bedeutet einen falschen Key, die falsche API-Adresse (global oder australisch) oder einen Plan bzw. Hub ohne API-Zugriff; 404 eine unbekannte ID; 422 einen Validierungsfehler, das Feld steht im Body.

Der Connector macht keine Lohnabrechnung, bearbeitet keine Formulare, reicht keine Formularantworten ein und legt keine Stempeluhren, Scheduler oder Task Boards an.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Connecteam-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele Stunden hat jede Person letzte Woche auf der Stempeluhr Lager gearbeitet, inklusive Überstunden?“
• „Zeig mir die offenen Schichten von morgen im Scheduler Außendienst.“
• „Welche Abwesenheitsanträge sind noch offen, und wie viel Restguthaben hat jede Person?“
• „Liste die Einreichungen des Formulars Fahrzeugprüfung von dieser Woche mit den Antworten auf.“
• „Leg auf dem Board Filiale eine Aufgabe für Daniel an, den Kühlraum bis Freitag aufzufüllen, und veröffentliche sie.“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Microsoft Copilot verbinden