Gemini CLI Konfigurationshandbuch mit MCP Openapi

Diese Dokumentation enthält praktische Beispiele und schnelle Tipps zur Konfiguration des Servers mcp.openapi.com innerhalb von Gemini CLI. Die Integration des Sprachmodells Gemini (LLM) mit der Openapi Marketplace API ermöglicht es, die Leistungsfähigkeit der natürlichen Sprache mit dem Zugriff auf stets aktuelle Daten und Dienste zu verbinden. Auf diese Weise können Prozesse automatisiert, Anwendungen erweitert und maßgeschneiderte Lösungen einfach, schnell und effizient erstellt werden.

Mit den unten beschriebenen Schritten können Sie:

Ziel ist es, Ihnen eine einfache und klare Einrichtung zu bieten, damit Sie sofort die Möglichkeiten des Claude LLM in Kombination mit den verfügbaren APIs nutzen können.

Offizielle Seiten

Openapi-Anforderungen

Bevor Sie mit der Konfiguration von Gemini Desktop beginnen, denken Sie daran:

Installation über npm (Node Package Manager)

Gemini CLI ist als npm-Paket verfügbar. Im Folgenden finden Sie die Schritte zur Installation auf den wichtigsten Betriebssystemen:

Linux/macOS

1. Stellen Sie sicher, dass Node.js und npm auf Ihrem System installiert sind. Sie können dies mit dem folgenden Befehl überprüfen:

node -v
npm -v	  

Wenn nicht installiert, laden Sie Node.js von der offiziellen Website herunter und installieren Sie es: https://nodejs.org/

2. Installieren Sie Gemini CLI global mit npm:

npm install -g gemini-cli

3. Überprüfen Sie, ob die Installation erfolgreich war, indem Sie ausführen:

gemini --version

Windows

1. Laden Sie Node.js von der offiziellen Website herunter und installieren Sie es: https://nodejs.org/

2. Öffnen Sie ein Terminal (z. B. PowerShell oder Eingabeaufforderung) und überprüfen Sie, ob Node.js und npm installiert sind:

node -v
npm -v

3. Installieren Sie Gemini CLI global mit npm:

npm install -g gemini-cli

4. Überprüfen Sie, ob die Installation erfolgreich war, indem Sie ausführen:

gemini --version

Konfiguration

1. Erstellen Sie eine JSON-Datei mit dem Namen settings.json im Verzeichnis, je nach Betriebssystem:

2. Fügen Sie den folgenden Code in die Datei settings.json ein und ersetzen Sie {OPENAPI_TOKEN} durch ein Token, das über openapi.com generiert wurde:

{
  "mcpServers": {
    "OpenapiMcpServer": {
      "httpUrl": "https://mcp.openapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Speichern Sie die Datei und prüfen Sie, ob Gemini CLI korrekt konfiguriert ist, indem Sie folgendes ausführen:

gemini --help

Schneller Test

Wenn Sie einen schnellen Test durchführen möchten, können Sie direkt die Beispiel-Datei settings.json im Verzeichnis .gemini dieses Repositories bearbeiten. Es ist nicht notwendig, sie in Ihr Home-Verzeichnis zu kopieren. Achten Sie darauf, {OPENAPI_TOKEN} durch ein gültiges Token zu ersetzen, das über openapi.com generiert wurde:

{
  "mcpServers": {
    "OpenapiMcpServer": {
      "httpUrl": "https://mcp.openapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Nachdem Sie die Datei bearbeitet haben, können Sie den Befehl gemini direkt aus diesem Verzeichnis ausführen, um zu überprüfen, ob das MCP von openapi.com aktiviert ist.

Liste der verfügbaren Befehle

Führen Sie den folgenden Befehl aus, um Gemini CLI zu starten und die Liste der verfügbaren Befehle anzuzeigen:

gemini --help

Start im CLI-Modus und Authentifizierung

Um den Client im CLI-Modus zu starten, führen Sie einfach den Befehl aus:

gemini

Der Client wird gestartet, und beim ersten Mal werden Sie aufgefordert, sich zu authentifizieren:

Konfiguration

1. Erstellen Sie eine JSON-Datei mit dem Namen settings.json im Verzeichnis, je nach Betriebssystem:

2. Fügen Sie den folgenden Code in die Datei settings.json ein und ersetzen Sie {OPENAPI_TOKEN} durch ein Token, das über openapi.com generiert wurde:

{
  "mcpServers": {
    "OpenapiMcpServer": {
      "httpUrl": "https://mcp.openapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Speichern Sie die Datei und prüfen Sie, ob Gemini CLI korrekt konfiguriert ist, indem Sie folgendes ausführen:

gemini --help

Schneller Test

Wenn Sie einen schnellen Test durchführen möchten, können Sie direkt die Beispiel-Datei settings.json im Verzeichnis .gemini dieses Repositories bearbeiten. Es ist nicht notwendig, sie in Ihr Home-Verzeichnis zu kopieren. Achten Sie darauf, {OPENAPI_TOKEN} durch ein gültiges Token zu ersetzen, das über openapi.com generiert wurde:

{
  "mcpServers": {
    "OpenapiMcpServer": {
      "httpUrl": "https://mcp.openapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Nachdem Sie die Datei bearbeitet haben, können Sie den Befehl gemini direkt aus diesem Verzeichnis ausführen, um zu überprüfen, ob das MCP von openapi.com aktiviert ist.

Liste der verfügbaren Befehle

Führen Sie den folgenden Befehl aus, um Gemini CLI zu starten und die Liste der verfügbaren Befehle anzuzeigen:

gemini --help

Beginnen wir mit der Nutzung von Openapi mit Gemini: Währungsumrechnung

Um den Client im CLI-Modus zu starten, führen Sie einfach den Befehl aus:

gemini

Der Client wird gestartet, und beim ersten Mal werden Sie aufgefordert, sich zu authentifizieren:

Stellen wir dem Modell eine einfache Frage: "Ich habe 12 Euro in meiner Tasche, wie viel sind sie heute in Dollar wert?"

╭──────────────────────────────────────────────────────────╮
│  > Ich habe 12 Euro in meiner Tasche, wie viel sind sie   │
│    heute in Dollar wert?                                  │
╰──────────────────────────────────────────────────────────╯

Nach wenigen Augenblicken wählt das Modell den richtigen Dienst aus, um die Frage präzise zu beantworten und das Risiko von Halluzinationen zu minimieren.

 ╭─────────────────────────────────────────────────────────────────────────────────────────╮
 │ ?  get_today_exchange_rates (OpenapiMcpServer MCP Server) get_today_exchange_rates … ←  │
 │                                                                                         │
 │   MCP Server: OpenapiMcpServer                                                          │
 │   Tool: get_today_exchange_rates                                                        │
 │                                                                                         │
 │ Ausführung des MCP-Tools "get_today_exchange_rates" vom Server "Openap… erlauben?       │
 │                                                                                         │
 │ ● 1. Ja, einmal erlauben                                                                │
 │   2. Ja, immer das Tool "get_today_exchange_rates" von diesem Server erlauben           │
 │   3. Ja, immer alle Tools vom Server "OpenapiMcpServer" erlauben                        │
 │   4. Nein, Änderungen vorschlagen (esc)                                                 │
 │                                                                                         │
 ╰─────────────────────────────────────────────────────────────────────────────────────────╯
⠏ Warten auf Benutzerbestätigung...

Eine Autorisierung wird angefordert, um den Aufruf eines bestimmten MCP-Tools von mcp.openapi.com auszuführen (in diesem Beispiel "get_today_exchange_rates"). Die Autorisierung kann einmalig oder dauerhaft erteilt werden.

 ╭────────────────────────────────────────────────────────────────────────────────────────────╮
 │ ✔ get_today_exchange_rates (OpenapiMcpServer MCP Server) get_today_exchange_rates (Open…  │
 │                                                                                            │
 │    {"EUR":1,"USD":1.1675,...}                                                             │
 ╰────────────────────────────────────────────────────────────────────────────────────────────╯
✦ Heute sind 12 Euro 14,01 Dollar wert. Der Wechselkurs beträgt 1 EUR = 1,1675 USD.

Kommen wir zu einem fortgeschritteneren Beispiel: Abruf der Unternehmensliste mit wirtschaftlichen und geografischen Parametern.

Fragen wir nach Unternehmensinformationen anhand einiger Parameter: "Wie viele Aktiengesellschaften (SPA) mit einem Umsatz von mehr als 10 Millionen befinden sich in der Provinz Terni (italienische Stadt)?"

╭───────────────────────────────────────────────────────────────────────────────────╮
│  > wie viele SPAs gibt es mit einem Umsatz von über 10 Millionen in der Provinz    │
│    Terni?                                                                          │
╰───────────────────────────────────────────────────────────────────────────────────╯

 ╭────────────────────────────────────────────────────────────────────────────────────────────╮
 │ ✔ get_company_IT_search (OpenapiMcpServer MCP Server) get_company_IT_search (OpenapiMcp…  │
 │                                                                                            │
 │    {"data":[],"count":27,"cost":0.027,"success":true,"message":"","error":null}            │
 ╰────────────────────────────────────────────────────────────────────────────────────────────╯
✦ Mit der Provinz "TR" gibt es 27 SPAs mit einem Umsatz von über 10 Millionen.

In diesem Beispiel wurde die Eigenschaft "dryRun" der API company.openapi.com automatisch aktiviert. Diese Option ermöglicht es, kostenlos eine Anzahl ("count") und eine Kostenschätzung ("cost") zu den angegebenen Kriterien zu erhalten, ohne den Datensatz tatsächlich zu extrahieren.

Erstellen wir einen detaillierten Unternehmensbericht

Möchten Sie detaillierte Daten zu einem einzelnen Unternehmen? Kein Problem — mit einer einfachen Eingabe ("erstelle mir einen HTML-Bericht von Openapi spa") ist es möglich, nicht nur die Daten, sondern auch einen Unternehmensbericht mit rechtlichen, finanziellen und organisatorischen Informationen zu erhalten.

╭───────────────────────────────────────────────────────╮
│  > erstelle mir einen HTML-Bericht von Openapi spa     │
╰───────────────────────────────────────────────────────╯

Da in der Anfrage nur der Unternehmensname angegeben wurde, führt das System zunächst eine Suche durch, um die Umsatzsteuer-Identifikationsnummer (VAT) abzurufen.

Sobald die VAT-Nummer ermittelt wurde, wird der Dienst IT-advanced der API company.openapi.com abgefragt.

Nachdem die gewünschten Unternehmensdaten abgerufen wurden, erstellt das Modell einen Bericht im HTML-Format, der im Verzeichnis gespeichert wird, aus dem der Befehl "gemini" ausgeführt wurde.

Hatten Sie Probleme bei der Anfrage?

Stellen Sie sicher, dass Sie diese Schritte befolgt haben:

Bei Problemen kontaktieren Sie uns bitte für Unterstützung!

Und jetzt sind Sie dran!

Möchten Sie uns erzählen, wie Sie MCP verwendet haben? Zögern Sie nicht, uns zu kontaktieren!