So verwenden Sie ACI.dev MCP-Server

In der sich rasch entwickelnden Entwicklungslandschaft von heute haben sich Model Context Protocol (MCP) Server als leistungsstarke Werkzeuge herauskristallisiert, die KI-Assistenten mit spezialisierten Datenquellen verbinden. ACI.dev MCP Server zeichnen sich durch das Angebot einer umfassenden Lösung aus, die über eine einheitliche Schnittstelle Zugriff auf mehrere App-Funktionen bietet.

ACI.dev bietet zwei verschiedene Arten von MCP-Servern an, die jeweils auf unterschiedliche Entwicklungsbedürfnisse zugeschnitten sind:

Apps MCP Server: Dieser Server bietet direkten Zugriff auf Funktionen aus bestimmten Apps, die Sie auswählen. Im Gegensatz zu den meisten MCP-Servern, die Sie auf eine einzelne App beschränken, können Sie mit dem Apps Server von ACI.dev mehrere Apps in einer einzigen Serverkonfiguration einbeziehen.

Unified MCP Server: Dieser innovative Server verfolgt einen anderen Ansatz, indem er zwei Meta-Funktionen bereitstellt, die jede auf der ACI.dev-Plattform verfügbare Funktion entdecken und ausführen können. Dieser dynamische Ansatz macht es überflüssig, alle Tools im Voraus aufzulisten.

Die Leistungsfähigkeit der ACI.dev MCP Server liegt in ihrer Fähigkeit, Folgendes zu leisten:

Zugriff auf mehrere App-Funktionen, ohne zwischen verschiedenen MCP-Servern wechseln zu müssen
Relevante Tools dynamisch entdecken, basierend auf Ihren spezifischen Bedürfnissen
Funktionen nahtlos über verschiedene Apps ausführen
Die Nutzung des Kontextfensters reduzieren, indem nur relevante Tools bei Bedarf geladen werden

Für API-Entwickler bedeuten diese Fähigkeiten einen optimierten Workflow, bei dem KI-Assistenten auf Tools aus verschiedenen Anwendungen zugreifen und diese nutzen können, ohne den Aufwand der Verwaltung mehrerer separater Verbindungen.

💡

Pro Tip: Während ACI.dev MCP Server einen hervorragenden Zugriff auf Funktionen mehrerer Apps bieten, bietet der Apidog MCP Server spezialisierte Funktionen für die API-Entwicklung. Der Apidog MCP Server gibt KI-Assistenten direkten Zugriff auf Ihre API-Spezifikationen und stellt so sicher, dass der generierte Code perfekt mit Ihren Designdokumenten übereinstimmt.

button

Einrichten von ACI.dev MCP Servern: Eine Schritt-für-Schritt-Anleitung

Der Einstieg in ACI.dev MCP Server erfordert ein paar einfache Schritte. Dieser Abschnitt führt durch den vollständigen Einrichtungsprozess für beide Servertypen.

Voraussetzungen für ACI.dev MCP Server

Bevor Sie mit der Einrichtung beginnen, stellen Sie sicher, dass Sie Folgendes haben:

Einen ACI.dev API-Schlüssel (erhältlich über ACI development platform)
Den UV-Paketmanager installiert
Konfigurierte Apps und diese in allowed_apps für Ihren Agenten auf platform.aci.dev festgelegt
Ihre app-spezifischen Konten unter derselben linked-account-owner-id verknüpft
Eine IDE, die MCP unterstützt, wie z. B.:

Claude Desktop
Cursor
VS Code mit entsprechenden Erweiterungen

Installieren des UV-Paketmanagers

Installieren Sie zunächst den UV-Paketmanager, falls Sie dies noch nicht getan haben:

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

Einrichten des Apps MCP Servers

Der Apps MCP Server bietet direkten Zugriff auf Funktionen aus bestimmten Apps, die Sie auswählen:

Wählen Sie Ihre Apps

Identifizieren Sie, auf welche Apps Sie zugreifen möchten. Sie finden verfügbare Apps unter platform.aci.dev/apps.

Führen Sie den Server aus

uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Ersetzen Sie <LINKED_ACCOUNT_OWNER_ID> durch Ihre Kontokennung von platform.aci.dev.

Konfigurieren Sie Ihre IDE

Für Claude Desktop fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Für Cursor fügen Sie zu Ihrer mcp.json hinzu:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Einrichten des Unified MCP Servers

Der Unified MCP Server bietet einen dynamischeren Ansatz mit zwei Meta-Funktionen:

ACI_SEARCH_FUNCTIONS_WITH_INTENT - Entdeckt Funktionen basierend auf Ihrer Absicht/Ihren Bedürfnissen
ACI_EXECUTE_FUNCTION - Führt jede von der Suche entdeckte Funktion aus

Führen Sie den Server aus

uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Konfigurieren Sie Ihre IDE

Für Claude Desktop fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Für Cursor fügen Sie zu Ihrer mcp.json hinzu:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Überprüfen Ihrer Einrichtung

Um zu überprüfen, ob Ihre Einrichtung korrekt funktioniert:

Für Apps Server: Bitten Sie Ihren KI-Assistenten, eine Funktion aus einer Ihrer angegebenen Apps zu verwenden:

"Suchen Sie nach aktuellen Nachrichten über die API-Entwicklung mit Brave Search"

Für Unified Server: Bitten Sie Ihren KI-Assistenten, eine Funktion zu entdecken und zu verwenden:

"Ich muss Informationen über Best Practices für REST-APIs finden"

Die KI sollte entweder direkt die angegebene Funktion verwenden (Apps Server) oder zuerst die entsprechende Funktion entdecken und dann ausführen (Unified Server).

Verwenden Sie Apidog MCP Server für die API-Entwicklung

Während ACI.dev MCP Server hervorragend darin sind, Zugriff auf mehrere App-Funktionen zu bieten, erfordert die API-Entwicklung oft Tools, die speziell für die Arbeit mit API-Spezifikationen und -Implementierungen entwickelt wurden. Hier kommt der Apidog MCP Server ins Spiel, der Funktionen bietet, die speziell für API-gesteuerte Entwicklungs-Workflows entwickelt wurden und die allgemeine Funktionalität der ACI.dev-Server ergänzen.

Verbesserung der API-Entwicklung mit Apidog MCP Server

Apidog MCP Server stellt einen bedeutenden Fortschritt in der API-Entwicklungsmethodik dar und konzentriert sich speziell darauf, API-Spezifikationen für KI-Assistenten direkt zugänglich zu machen. Im Gegensatz zu allgemeinen MCP-Servern ist der Apidog MCP Server speziell für die API-Entwicklung konzipiert und stellt so eine perfekte Übereinstimmung zwischen Spezifikationen und Implementierungen sicher.

So funktioniert der Apidog MCP Server

Nach der Einrichtung liest und speichert der Apidog MCP Server automatisch API-Spezifikationsdaten auf Ihrem lokalen Rechner. Dies ermöglicht es KI-Assistenten, diese Daten während der Entwicklung nahtlos abzurufen und zu nutzen. Der Prozess funktioniert wie folgt:

Verbindung zu API-Spezifikationen: Apidog MCP Server stellt eine direkte Verbindung zu Ihren API-Spezifikationen her, egal ob diese in Apidog-Projekten, veröffentlichter Dokumentation oder OpenAPI-Dateien vorliegen
Lokales Zwischenspeichern von Daten: Spezifikationen werden für den schnellen Zugriff zwischengespeichert
Bereitstellung von Kontext für KI: Wenn Sie die KI nach Ihrer API fragen, kann sie auf die genauen Spezifikationen zugreifen
Aktivierung der Code-Generierung: KI kann Code generieren, der perfekt zu Ihrem API-Design passt

Dieser spezialisierte Ansatz stellt sicher, dass die gesamte KI-gestützte Entwicklung perfekt auf Ihre API-Spezifikationen abgestimmt bleibt, wodurch die übliche Diskrepanz zwischen Design und Implementierung beseitigt wird.

Einrichten des Apidog MCP Servers

Das Einrichten des Apidog MCP Servers erfordert ein paar einfache Schritte:

Voraussetzungen:

Node.js (Version 18 oder höher)
Eine IDE, die MCP unterstützt (Cursor, VS Code + Cline-Plugin)

Wählen Sie Ihre Datenquelle: Apidog MCP Server unterstützt drei verschiedene Datenquellen:

Apidog Project: Für den Zugriff auf API-Spezifikationen innerhalb Ihres Teams
Online API Documentation: Zum Lesen der über Apidog veröffentlichten API-Dokumentation
OpenAPI Files: Für die Arbeit mit lokalen oder Online-Swagger/OpenAPI-Dateien

Konfigurieren Sie MCP in Ihrer IDE: Für Apidog Project als Datenquelle (Windows-Beispiel):

{
 "mcpServers": {
   "API specification": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

Konfiguration überprüfen: Testen Sie, indem Sie Ihren KI-Assistenten fragen:

"Bitte rufen Sie die API-Spezifikation über MCP ab und sagen Sie mir, wie viele Endpunkte in dem Projekt existieren"

Leistungsstarke API-Entwicklungs-Workflows mit Apidog MCP

Apidog MCP Server ermöglicht spezialisierte Workflows, die die API-Entwicklung verändern:

Code-Generierung basierend auf Spezifikationen

"Verwenden Sie MCP, um die API-Spezifikation abzurufen und Java-Datensätze für das 'Produkt'-Schema und verwandte Schemata zu generieren"

Aktualisieren von Implementierungen bei Änderungen der Spezifikationen

"Basierend auf der API-Spezifikation fügen Sie die neuen Felder zum 'Produkt'-DTO hinzu"

Hinzufügen von Dokumentation zum Code

"Fügen Sie Kommentare für jedes Feld in der 'Produkt'-Klasse basierend auf der API-Spezifikation hinzu"

Erstellen vollständiger API-Implementierungen

"Generieren Sie den gesamten MVC-Code, der sich auf den Endpunkt '/users' bezieht, gemäß der API-Spezifikation"

Fazit: Auswahl des richtigen MCP-Servers für Ihre Entwicklungsbedürfnisse

Das Aufkommen spezialisierter MCP-Server markiert einen bedeutenden Fortschritt in der KI-gestützten Entwicklung. ACI.dev MCP Server zeichnen sich durch den Zugriff auf Funktionen mehrerer Apps aus, während sich Apidog MCP Server speziell auf die API-Entwicklung konzentriert, indem er die perfekte Übereinstimmung zwischen Spezifikationen und Implementierungen sicherstellt.

Für Entwickler dienen diese Tools komplementären Zwecken:

ACI.dev MCP Server: Ideal, wenn Sie auf Funktionen aus mehreren Apps zugreifen müssen oder eine dynamische Funktionserkennung basierend auf Ihren spezifischen Bedürfnissen wünschen.
Apidog MCP Server: Perfekt bei der Implementierung von APIs und der Sicherstellung, dass der Code perfekt mit den API-Spezifikationen übereinstimmt.

Durch die Integration dieser spezialisierten Tools in Ihren Workflow basierend auf Ihren spezifischen Anforderungen können Sie die Produktivität und Codequalität erheblich steigern. Diese MCP-Server stellen eine grundlegende Veränderung der Entwicklungspraktiken dar – wodurch die Arbeit effizienter, genauer und letztendlich angenehmer wird.