MOCO MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die MOCO-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

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

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden