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 ein kuratiertes Set von Tools wie Suchen, Abrufen, Erstellen und Aktualisierung über ein strukturiertes Protokoll bereit, 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 Schlussfolgerung aufrufen – alles ohne benutzerdefinierten Glue-Code.

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

Beide Schnittstellen kommunizieren 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 Glue-Code erforderlich – Der Agent entdeckt die verfügbaren Tools dynamisch. Du musst keine benutzerdefinierten Request-Builder schreiben oder rohe API-Antworten für gängige Operationen wie Artikelsuche oder das Abrufen von Kategoriestrukturen parsen.

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

Natürliche Anordnung für mehrstufiges Schließen – KI-Agenten sind hervorragend darin, Aktionen wie das Suchen eines Artikels, das Lesen des Inhalts und das anschließende Aktualisieren basierend auf dem Gefundenen zu verketten. MCP-Tools sind genau für diese Art von sequentiellen, kontextbewussten Workflows 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 Funktion ist, die du brauchst. Ein bestimmter Filter, ein Massenexport, ein Webhook-Trigger sind in den unterstützten MCP-Tools verfügbar. 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.

Sie bauen nicht-agentische Automatisierung – Cron-Jobs, Datenpipelines und Webhook-Handler profitieren nicht von Tool-Discovery oder agentischem Denken. Ein direkter API-Aufruf ist in diesen Kontexten einfacher und wartbarer.

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 Wahl. Sie ist geschichtet:

Stell es dir so vor: Lass den Agent MCP für das verwenden, worin Agenten gut sind – zu überlegen, welches Tool aufgerufen werden soll, Aktionen über mehrere Schritte hinweg zu verknüpfen und mit strukturierten Dokumentationsinhalten zu arbeiten. Reserviere direkte API-Aufrufe für deterministische, leistungssensitive 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, bevorzugen Sie MCP.

2. Muss der Agent überlegen, welche Aktion er ausführen soll? Wenn der Agent dynamisch entscheidet, was als Nächstes zu tun ist, basierend auf dem Kontext, passt MCP ganz natürlich.

3. Müssen Sie große Volumen verarbeiten oder das Verhalten auf Anfrageebene steuern? Wenn ja, verwenden Sie die Standard-API.

4. Ist das Teil einer nicht-agentischen Automatisierung (Pipeline, Scheduler, Webhook)? Falls ja, nutze die Standard-API direkt, es bringt hier keinen Vorteil bei der Tool-Entdeckung.

5. Verbinden Sie mehrere Dienste? Das standardisierte Authentifizierungsmodell von MCP reduziert die Reibung, wenn Ihr Agent mit Document360 zusammen mit anderen MCP-fähigen Tools kommuniziert.

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

Alle drei 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 Tool-Discovery; sie benötigt nur zuverlässigen, paginierten Zugriff auf Artikelinhalte nach einem Zeitplan.

Mit wachsender MCP-Abdeckung

MCP-Server entwickeln sich weiter. Die aktuelle Implementierung von Document360 deckt die häufigsten Dokumentationsoperationen für KI-Agenten ab – Suche, Abruf und Inhaltsmanagement. Im Laufe der Zeit wird wahrscheinlich ein größerer Teil der API-Oberfläche über 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.