MCP vs. Standard-API

Da immer mehr Teams KI-Agenten in ihre Dokumentationsworkflows integrieren, stellt sich eine häufige architektonische Frage: Wenn Document360 sowohl MCP-Endpunkte als auch Standard-API-Endpunkte anbietet, welchen sollte ein KI-Agent wie Claude Code verwenden und wann?

Dieser Artikel erklärt, wie man über diese Entscheidung nachdenkt, wann man jede Schnittstelle nutzen sollte und wie ein hybrider Ansatz oft das Beste aus beiden bietet.

Verständnis der beiden Schnittstellen

Die MCP-Schnittstelle stellt einen kuratierten Satz von Tools bereit – Suchen, Abrufen, Erstellen, Aktualisieren, Workflows verwalten und Inhalte veröffentlichen – durch ein strukturiertes Protokoll, das KI-Agenten nativ verstehen. Wenn ein Agent sich über MCP verbindet, kann er herausfinden, welche Operationen verfügbar sind, deren Eingabe-/Ausgabeschemata verstehen und diese als Teil einer Denkkette aufrufen – alles ohne benutzerdefinierten Klebecode.

Die Standard-API bietet Ihnen direkten, niedrigstufigen Zugriff auf die vollen Funktionen von Document360 über REST-Endpunkte. Du steuerst explizit jeden Anforderungsparameter, jede Wiederholungslogik, Paginierung und Authentifizierungsfluss.

Beide Schnittstellen sprechen mit derselben zugrundeliegenden Wissensbasis. Der Unterschied liegt darin, wie ein Agent (oder dein Code) mit ihm interagiert.

Standardmäßig auf MCP setzen, wenn der Agent es unterstützt.

MCP ist speziell für KI-Agenten entwickelt. Wenn der MCP-Server von Document360 verfügbar ist und die benötigte Operation abdeckt, sollte er Ihre erste Wahl für agentische Workflows sein. Hier ist der Grund:

Kein Klebecode erforderlich – Der Agent entdeckt die verfügbaren Werkzeuge dynamisch. Sie müssen keine benutzerdefinierten Request-Builder schreiben oder rohe API-Antworten für gängige Operationen wie Artikelsuche oder das Abrufen von Kategorienstrukturen parsen.

Strukturierte Eingaben und Ausgaben – Jedes MCP-Werkzeug hat ein definiertes Schema. Dies reduziert Fehler durch fehlgeleitete Anfragen und macht das Verhalten der Agenten vorhersehbarer.

Natürliche Anpassung für mehrstufiges Denken – KI-Agenten sind hervorragend darin, Aktionen wie das Suchen eines Artikels, das Lesen seines Inhalts und dessen Aktualisieren basierend auf dem Gefundenen zu verketten. MCP-Tools sind genau für diese Art von sequentiellen, kontextbewussten Arbeitsabläufen konzipiert.

Standardisierte Auth und Kontextübergabe – MCP behandelt OAuth und Kontext konsistent über Dienste hinweg und reduziert die Integrationsreibung, wenn Ihr Agent sich mit mehreren Systemen verbindet.

Nutze die Standard-API, wenn du Kontrolle brauchst, wenn du Kontrolle brauchst

Der MCP-Server stellt eine kuratierte Teilmenge der vollständigen API-Oberfläche von Document360 zur Verfügung. Es gibt Fälle, in denen es sinnvoller ist, auf die Standard-API zurückzugehen:

Die Operation wird nicht über MCP bereitgestellt – Überprüfe, ob die spezifische Fähigkeit, die du brauchst – ein bestimmter Filter, ein Massenexport, ein Webhook-Trigger – in den unterstützten MCP-Tools verfügbar ist. Wenn nicht, ist die Standard-API dein Weg.

Du brauchst Performance-Optimierungen – Wenn dein Workflow das Batching vieler Anfragen, das Streamen großer Payloads oder das aggressive Caching von Antworten beinhaltet, gibt dir die Standard-API die Steuerungshebel, die MCP-Abstraktionen nicht bieten.

Du baust nicht-agentische Automatisierung – Cron-Jobs, Datenpipelines und Webhook-Handler profitieren nicht von Tool-Discovery oder agentischer Logik. Ein direkter API-Aufruf ist in diesen Kontexten einfacher und besser wartbar.

Du brauchst präzise Paginierung oder Wiederholungskontrolle – die Standard-API gibt dir die volle Kontrolle darüber, wie du durch große Ergebnissets gehst und mit vorübergehenden Fehlern umgehst, was für zuverlässigkeitssensible Automatisierung wichtig ist.

Ein hybrider Ansatz funktioniert in der Praxis oft am besten

Für die meisten Teams, die mit KI-Agenten bauen, ist die ideale Architektur keine binäre Entscheidung. Sie ist geschichtet:

Stell es dir so vor: Lass den Agenten MCP für das verwenden, worin Agenten gut sind – also das Überlegen, welches Tool sie aufrufen sollen, Aktionen über mehrere Schritte aneinanderreihen und mit strukturierten Dokumentationsinhalten arbeiten. Reservieren Sie direkte API-Aufrufe für deterministische, leistungsabhängige oder nicht unterstützte Operationen, bei denen explizite Kontrolle relevant ist.

Praktische Checkliste vor der Auswahl

Bevor Sie entscheiden, welche Schnittstelle für eine bestimmte Operation verwendet wird, gehen Sie diese Fragen durch:

1. Ist die Operation als MCP-Tool verfügbar? Schauen Sie sich die im Artikel "Unterstützte Werkzeuge" aufgeführten Werkzeuge an. Wenn ja, bevorzuge MCP.
2. Muss der Makler überlegen, welche Maßnahme er ergreifen soll? Wenn der Agent dynamisch basierend auf dem Kontext entscheidet, was als Nächstes zu tun ist, passt MCP ganz natürlich.
3. Musst du große Volumina verarbeiten oder das Verhalten auf Anfrageebene steuern? Wenn ja, nutze die Standard-API.
4. Ist das Teil einer nicht-agentischen Automatisierung (Pipeline, Scheduler, Webhook)? Wenn ja, nutzen Sie direkt die Standard-API – hier bringt die Tool-Discovery keinen Vorteil.
5. Verbindest du mehrere Dienste? Das standardisierte Authentifizierungsmodell von MCP reduziert die Reibung, wenn Ihr Agent zusammen mit anderen MCP-fähigen Tools mit Document360 spricht.

Wie das in einem echten Arbeitsablauf aussieht

Stellen Sie sich vor, wie ein Support-Ingenieur einen KI-Agenten einsetzt, um Dokumentationslücken bei eingehenden Tickets zu identifizieren und zu schließen.

Der Makler würde:

1. Nutze document360-mcp-search sie, um zu prüfen, ob bereits relevante Dokumente vorhanden sind
2. Verwenden document360-mcp-get-article Sie, um den nächst passenden Artikel abzurufen und zu lesen
3. Verwenden document360-mcp-create-article Sie, um einen neuen Artikel zu entwerfen, wenn eine Lücke gefunden wird
4. Verwenden document360-mcp-set-workflow-status Sie, um den Artikel zur Überprüfung zu verschieben und das passende Teammitglied zuzuweisen
5. Verwenden Sie die Veröffentlichung document360-mcp-publish-article des Artikels, sobald er geprüft und genehmigt wurde

Alle fünf Schritte erfolgen über MCP. Der Agent überlegt, was als Nächstes in jeder Phase zu tun ist, und die Werkzeugschemata leiten die Interaktion.

Wenn dasselbe Team auch eine nächtliche Pipeline betreibt, um alle Artikel für ein externes Audit-System zu exportieren, würde diese Pipeline die Standard-API direkt aufrufen. Sie benötigt keine Werkzeugentdeckung; Es braucht nur zuverlässigen, paginierten Zugriff auf Artikelinhalte nach Zeitplan.

Mit wachsender MCP-Abdeckung

MCP-Server entwickeln sich weiter. Die aktuelle Implementierung von Document360 deckt die gängigsten Dokumentationsoperationen für KI-Agenten ab – Suche, Abruf, Inhaltsmanagement, Workflow-Management und Veröffentlichung. Im Laufe der Zeit wird wahrscheinlich ein größerer Teil der API-Oberfläche durch MCP freigelegt, was das Gleichgewicht für die meisten agentischen Anwendungsfälle weiter zugunsten von MCP verschieben wird.

Für den Moment ist die praktische Regel, mit MCP zu beginnen, bei Lücken auf die Standard-API zurückzugreifen und dein System so zu gestalten, dass der Wechsel zwischen den beiden unkompliziert ist.

FAQ