Connecteam über MCP mit Cursor 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 + Cursor

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Connecteam-Tools aufrufen.

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden