Dokumentation

Coroid als MCP-Server

Steuern Sie Coroid über einen externen MCP-Endpunkt aus Ihrem eigenen Assistenten oder Editor.

Coroid stellt einen externen Model Context Protocol Server bereit, sodass ein externer Agent-Client die Arbeit in Coroid über dasselbe verwaltete Tool-Register wie der Chat-Assistent steuern kann.

Konfigurieren Sie dies unter Einstellungen → Automatisierung → Coroid MCP-Server, wobei folgende Bereiche abgedeckt werden: Übersicht, Client-Einrichtung, Zugriffstoken, Freigaben und Automatisierungsrichtlinien.

Der Endpunkt

Der MCP-Server wird vom API Gateway:

https://api.coroid.ai/mcp
UmgebungEndpunkt
Produktionhttps://api.coroid.ai/mcp
Staginghttps://staging-api.coroid.ai/mcp
Entwicklunghttp://localhost:3000/mcp

Der Transport erfolgt über stateless Streamable HTTP. Die Authentifizierung erfolgt via OAuth oder persönlichem Zugriffstoken.

Was bewusst nicht zur Verfügung gestellt wird

Das Tool-Register wird verwaltet – die Ausschlüsse sind beabsichtigt. Es stellt nicht folgendes zur Verfügung:

  • eine Shell
  • Git-Zugriff
  • das Dateisystem
  • rohen Datenbankzugriff
  • beliebigen internen HTTP-Zugriff
  • Coroid's eigene ausgehende MCP-Verwaltungswerkzeuge

Sie erhalten die Möglichkeit, Arbeit zu steuern – Aufgaben, Pläne und Projekte erstellen sowie einsehen – jedoch kein Remote-Ausführungsumfeld. Ein MCP-Client kann Coroid nicht zur Ausführung beliebiger Befehle nutzen.

Zugriffstoken

Token werden unter Zugriffstokenerstellt und verwaltet. Wie jede andere Anmeldeinformation werden sie nur einmal angezeigt und danach nicht mehr ausgegeben.

Erstellen Sie pro Client ein eigenes Token. So lässt sich der Zugriff eines einzelnen Clients widerrufen, ohne dass alle betroffen sind.

Freigaben und Automatisierungsrichtlinien

Freigaben bilden eine Warteschlange mit Aktionen, die einer menschlichen Bestätigung bedürfen. Automatisierungsrichtlinien bestimmen, was in diese Warteschlange aufgenommen wird.

Dies ist die entscheidende Steuerung: Ein externer Client, der in Ihrem Namen agiert, sollte routinemäßige Aufgaben frei ausführen können, während wichtige Aktionen erst nach Zustimmung einer Person erfolgen. Legen Sie die Richtlinien fest, bevor Sie ein Token an ein unbeaufsichtigtes System weitergeben.

Wofür es geeignet ist

Coroid direkt aus Ihrer bestehenden Arbeitsumgebung – einem Editor, Assistenten oder internen Tool – steuern, ohne das Portal zu wechseln. Das Erstellen einer Aufgabe über das Terminal oder das Überprüfen blockierter Elemente durch einen Assistenten wird so zu einer lokalen Aktion.