MOCO über MCP mit Cursor verbinden

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

MOCO + Cursor

Lass deine KI mit deinem MOCO-Account arbeiten: Projekte und Kunden nachschlagen, erfasste Zeiten nach Person oder Projekt auswerten, offene Rechnungen und die Auslastung des Teams prüfen und Zeiten buchen. Mit deiner MOCO-Subdomain und einem API-Schlüssel aus deinem MOCO-Profil.

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:

MOCO_SUBDOMAIN, MOCO_API_KEY

Schritt 1 — Zugangsdaten holen

1. Klicke in MOCO oben rechts auf dein Profilbild, öffne in deinem Profil den Reiter Integrationen und kopiere deinen persönlichen API-Schlüssel. Er erreicht genau das, was dein eigener MOCO-Benutzer sehen und tun darf.
2. Alternativ legst du unter Einstellungen → Erweiterungen → API & Webhooks → API-Schlüssel einen Account-Schlüssel an, mit Lese- oder Vollzugriff. Ein Schlüssel mit reinem Lesezugriff kann keine Zeiten buchen.
3. Füge den Schlüssel in MOCO_API_KEY ein.
4. Setze MOCO_SUBDOMAIN nur auf den ersten Teil deiner MOCO-Adresse: Bei agency.mocoapp.com trägst du agency ein, ohne https:// und ohne .mocoapp.com. Der Connector ruft dann https://agency.mocoapp.com/api/v1 auf.
5. Installiere den Connector. Einen Schritt Authorize with Provider gibt es nicht: Der Schlüssel wird verschlüsselt gespeichert und bei jeder Anfrage mitgeschickt.
6. Beginne mit moco_list_users: Wenn deine Kolleginnen und Kollegen mit ihren IDs erscheinen, stimmen Schlüssel und Subdomain.

Angemeldet bleiben: Der Connector nutzt den Schlüssel direkt, es gibt also keine Anmeldung, die erneuert werden muss. Wird der Schlüssel in MOCO ersetzt oder gelöscht, trägst du den neuen in MOCO_API_KEY ein.

Was die KI sieht: Jede Liste liefert nur die Datensätze, die der Benutzer des Schlüssels sehen darf. Fehlt scheinbar ein Projekt oder eine Rechnung, ist das meist eine Frage der Berechtigungen in MOCO und kein Fehler des Connectors.

Zeiten buchen: moco_create_activity ist das einzige Tool, das in MOCO schreibt. Es bucht einen Zeiteintrag für den Benutzer, dem der Schlüssel gehört, mit Datum, Projekt-ID, Task-ID, Dauer in ganzen Sekunden (2 Stunden sind 7200) und optionaler Beschreibung. Das Projekt findet die KI mit moco_list_projects, dessen Tasks mit moco_get_project. Jeder Aufruf legt einen neuen Eintrag an, ein wiederholter Aufruf bucht die Zeit doppelt. Deshalb zeigt dir die KI vorher Datum, Projekt, Task und Dauer und wartet auf dein Ja.

Berechtigungen und Nur lesen: Für einen Connector, der nur liest, deaktivierst du moco_create_activity auf der Connector-Seite oder nimmst einen Account-Schlüssel mit reinem Lesezugriff. Gib einen Schlüssel mit Vollzugriff nicht an Leute weiter, die Daten nur lesen sollen.

Auswertungen und Rechnungen: moco_list_activities und moco_report_utilization brauchen immer ein Start- und ein Enddatum (from und to, im Format YYYY-MM-DD). Zeiteinträge lassen sich auf eine Person, ein Projekt oder nur abrechenbare Zeit eingrenzen; die Auslastung stellt verfügbare und gebuchte Kapazität gegenüber. moco_list_invoices filtert nach Status (draft, created, sent, partially_paid, paid, overdue, ignored, mehrere durch Kommas getrennt), Rechnungsdatum und Firma.

Limits: Listen liefern bis zu 100 Einträge pro Seite, und die KI blättert weiter bis zur letzten. MOCO erlaubt in den Standardplänen etwa 120 Anfragen pro zwei Minuten; darüber antwortet es mit 429. Warte dann kurz und versuche es erneut.

Häufige Fehler: 401 heißt, dass der Schlüssel falsch ist, gelöscht wurde oder zu einem anderen MOCO-Account gehört als MOCO_SUBDOMAIN. Schlägt jeder Aufruf fehl, prüfe, ob in MOCO_SUBDOMAIN nur die Subdomain steht und nicht die ganze Adresse. 404 bei einem einzelnen Projekt heißt, dass die ID falsch ist oder der Benutzer des Schlüssels das Projekt nicht sehen darf. Eine abgelehnte Buchung nennt das Feld, das MOCO nicht akzeptiert hat, zum Beispiel einen Task, der nicht zum Projekt gehört.

Der Connector erstellt und versendet keine Rechnungen, lädt keine PDFs herunter, richtet keine Webhooks ein, bearbeitet oder löscht keine Zeiteinträge und ändert keine Projekte, Firmen oder Benutzer.

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 MOCO-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele Stunden hat das Team im September auf das Projekt Website-Relaunch gebucht, und wie viel davon war abrechenbar?“
• „Welche Rechnungen sind gerade überfällig oder teilweise bezahlt, und zu welchen Kunden gehören sie?“
• „Wie war die Auslastung des Teams im letzten Monat? Stell verfügbare und gebuchte Kapazität gegenüber.“
• „Buche heute 2,5 Stunden auf das Projekt Acme Website für das Review des Homepage-Layouts. Zeig mir den Eintrag, bevor du ihn buchst.“

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