API-Integration und Code Assist Toolkit mit MCP

Sie erhalten kontextbezogene Informationen zur Merchant API vom Coding-Assistenten Ihrer Wahl. In Ihrer integrierten Entwicklungsumgebung (IDE) können Sie jetzt über den MCP-Dienst (Model Context Protocol) auf die Entwicklerdokumentation zugreifen. Dieser Dienst beschleunigt die Entwicklung für Integrations- und Migrationsworkflows, indem er Ihrem Coding-Assistenten maßgeblichen Kontext aus der offiziellen Google API-Dokumentation zur Verfügung stellt.

Weitere Informationen zum Protokoll selbst finden Sie im Model Context Protocol Standard.

Übersicht

Wenn Sie von der Content API for Shopping zur Merchant API migrieren oder eine neue Integration erstellen, müssen Sie die neuen Dienststrukturen, Ressourcennamen und Methoden kennen. Der MCP-Dienst vereinfacht dies, indem er Ihrem Coding-Assistenten offizielle Dokumentation und Codebeispiele zur Verfügung stellt.

Der Dienst verwendet ein hochspezialisiertes RAG-Back-End (Retrieval-Augmented Generation). Wenn Sie Ihrem MCP-fähigen Coding-Assistenten in der IDE eine Frage zu Merchant API stellen, ruft der Dienst die relevantesten Text- und Code-Snippets aus den offiziellen Google-Ressourcen ab und gibt sie als Kontext an Ihren Coding-Assistenten zurück. So kann Ihr Assistent genaue und aktuelle Antworten geben, ohne dass Sie Ihre Entwicklungsumgebung verlassen müssen.

Funktionsweise

Die Integration der Entwicklerdokumentation mit MCP ist in einen modernen, KI-gestützten Entwicklungsworkflow eingebunden:

  1. Sie stellen eine Frage in Ihrem MCP-kompatiblen Coding-Assistenten oder Agenten. Das kann eine Frage in natürlicher Sprache, eine Anfrage nach einem Codebeispiel für die Merchant API oder sogar eine Anfrage zur direkten Übersetzung Ihres Codes in die Merchant API sein.
  2. Ihr Coding-Assistent sendet eine Anfrage nach Kontext an den MCP-Endpunkt.
  3. Der MCP-Dienst durchsucht seine indexierte Sammlung offizieller Merchant API-Dokumentation, Anleitungen und Codebeispiele, um die relevantesten Informationen zu finden.
  4. Der Dienst gibt diese maßgeblichen Snippets als Kontext an Ihren Coding-Assistenten zurück.
  5. Ihr Coding-Assistent verwendet diesen hochwertigen Kontext, um eine genaue und hilfreiche Antwort auf Ihre ursprüngliche Frage zu generieren oder eine Codeübersetzungsaufgabe auszuführen.

Erste Schritte

So verwenden Sie MCP:

1. Kompatibles Tool verwenden

Öffnen Sie eine IDE oder einen Coding-Assistenten, der das Model Context Protocol mit streamfähigem HTTP-Transport unterstützt.

2. Endpunktkonfiguration

Wenn Sie Ihre IDE oder Ihren Coding-Assistenten mit MCP verbinden möchten, verwenden Sie die bereitgestellten Details zum Remote-Endpunkt. Je nach Konfiguration Ihres Tools müssen Sie entweder die direkte Dienst-URL oder die MCP-Definition eingeben.

Die Dienst-URL lautet:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

Konfigurationseinrichtungen:

Antigravity

Folgen Sie der Anleitung in der Antigravity-Dokumentation.

{
    "mcpServers": {
        "mapi-devdocs": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://merchantapi.googleapis.com/devdocs/mcp"
            ]
        }
    }
}

Visual Studio Code

Folgen Sie der Anleitung in der Visual Studio Code-Dokumentation.

{
    "servers": {
        "mapi-devdocs": {
            "type": "http",
            "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
        }
    }
}

3. Anleitung für den Agenten hinzufügen (optional)

Wenn Ihr Agent Code direkt mit MCP übersetzen soll, geben Sie ihm die Systemanweisungen: MerchantIntegrator Agent Protocol. Diese Anweisungen leiten den Agenten an, wie er MCP für die Codeübersetzung richtig verwendet. Je nach Tool können Sie diese Anweisungen entweder in der Konfiguration der Systemanweisungen oder als zusätzliche Kontextdatei für den Agenten bereitstellen.

Beispielszenarien

MCP kann Ihren Workflow in diesen häufigen Anwendungsfällen beschleunigen.

Szenario 1: products.insert-Code migrieren

Sie können den Agenten bitten, einen products.insert-Integrationscode der Content API for Shopping direkt zur Merchant API zu migrieren.

Nutzeraufforderung :

„Migriere den products.insert-Code zur Merchant API.“

Wenn Sie Ihrem Agenten die Systemanweisungen: MerchantIntegrator Agent Protocol und Zugriff auf MCP gewähren, kann er den Code der Content API for Shopping direkt in Ihrer IDE in Merchant API-Code übersetzen. In diesem Fall wird productInputs.insert als entsprechender Aufruf identifiziert und die Produktattribute aus dem alten Format in das neue Format übertragen, das von der Merchant API benötigt wird. Außerdem können erforderliche Importe und die Datei zur Abhängigkeitsverwaltung aktualisiert werden (z. B. requirements.txt, pom.xml oder package.json). Sie können den Agenten anweisen, die Änderungen direkt vorzunehmen oder einen neuen Ordner zu erstellen.

Szenario 2: Entsprechende Funktion finden

Sie haben eine vorhandene Anwendung, die die Content API for Shopping verwendet, und müssen sie aktualisieren. Sie können nach einer bestimmten Legacy-Methode fragen, um Details zur neuen Implementierung und ein entsprechendes Codebeispiel zu erhalten.

Nutzeraufforderung :

„Was ist die entsprechende Methode in der Merchant API für die Methode „accountstatuses.get“ in der Content API for Shopping?“

Der MCP-Dienst stellt Kontext aus den offiziellen Migrationsanleitungen und der Referenzdokumentation zur Verfügung, sodass Ihr Assistent eine detaillierte Antwort geben kann, einschließlich des neuen API-Namens accounts.issues.

Szenario 3: Codebeispiel finden

Sie implementieren eine neue Funktion und benötigen ein praktisches Beispiel.

Nutzeraufforderung :

Zeige mir ein Python-Codebeispiel zum Hinzufügen eines neuen Versanddienstes mit der Merchant API.

Der MCP-Dienst ruft relevante Codebeispiele aus den offiziellen Google-GitHub-Repositories und Entwicklerleitfäden ab. Ihr Assistent kann dann einen vollständigen, anpassungsbereiten Codeblock präsentieren.

Szenario 4: API-Konzepte verstehen

Sie stoßen auf ein neues Konzept oder möchten die Struktur einer Ressource oder das allgemeine Merchant API-Muster verstehen.

Nutzeraufforderung :

„Wie aktualisiere ich den Lagerbestand für ein Produkt mit der Merchant API?“

Der MCP-Dienst gibt Kontext aus der Dokumentation zur Ressource „products“ und relevanten Anleitungen zurück. Ihr Assistent kann dann erklären, wie Sie die Methode accounts.productInputs.insert verwenden, und die partielle Produktressource bereitstellen, die nur die productId und die lagerbezogenen Felder enthält, die Sie aktualisieren müssen.

„Wie autorisiere ich meine Anwendungsaufrufe mit der Merchant API?“

Der MCP-Dienst ruft Kontext aus den offiziellen Authentifizierungsanleitungen ab, in denen verschiedene Autorisierungsmethoden behandelt werden. Ihr Assistent kann dann die wichtigsten verfügbaren Optionen erläutern, z. B. die Verwendung eines Dienstkontos für Server-zu-Server-Interaktionen oder einer OAuth 2.0-Client-ID, wenn Sie im Namen eines Nutzers handeln.

Szenario 5: An API-Änderungen anpassen

Die Merchant API führt neue Muster ein, z. B. Batchanfragen, die sich von der Content API for Shopping unterscheiden. Die Content API for Shopping verwendet bestimmte custombatch-Methoden, während die Merchant API eine integrierte, generische HTTP-Batchfunktion verwendet.

Nutzeraufforderung :

„Wie führe ich eine products.custombatch-Anfrage in der Merchant API aus?“

Der MCP-Dienst ruft Kontext aus Code für gleichzeitige Anfragen umgestalten ab, in dem erklärt wird, dass es in der Merchant API keine dedizierten custombatch Methoden gibt. Stattdessen wird die Verwendung von HTTP-Batching mit dem Content-Type multipart dokumentiert. Ihr Assistent kann dann erklären, wie Sie eine einzelne HTTP-Anfrage erstellen, die mehrere API-Aufrufe enthält und an den Endpunkt https://merchantapi.googleapis.com/batch/{sub-api}/v1 gesendet wird. Außerdem wird ein Beispiel für die Struktur der Multipart-Anfrage bereitgestellt. So wird aus einer potenziell verwirrenden Migrationsaufgabe ein geführter Prozess.

Szenario 6: Berichtsanfrage übersetzen

Sie können den Agenten bitten, eine Berichtsanfrage von der Content API for Shopping zur Merchant API zu übersetzen.

Nutzeraufforderung :

„Migriere diese Berichtsanfrage von der Content API zur Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'“

Der MCP-Dienst ruft die neueste Referenzdokumentation für Berichte, Entwicklerleitfäden und Migrationsanleitungen ab. Anhand dieser Informationen wird die Abfrage in die neue Struktur umgewandelt und die Felder werden in die neuen Namen und Werte aktualisiert.

Quellen der Wissensdatenbank

Der MCP-Dienst erstellt seine Wissensdatenbank ausschließlich aus öffentlichen und offiziellen Quellen, um sicherzustellen, dass der bereitgestellte Kontext genau und zuverlässig ist. Der Dienst indexiert den gesamten Inhalt der offiziellen Entwicklerwebsite und des Codebeispiel-Repositorys, einschließlich: