Apify MCP einrichten: Actors und Ergebnisse prüfen

Bei Apify beginnt eine Verbindung mit der Auswahl eines passenden Actors. Sein Name allein sagt noch nicht, welche Eingaben er erwartet oder welche Daten er zurückgibt. Legen Sie deshalb zunächst eine einzelne öffentliche Testadresse und die gewünschten Ergebnisfelder fest. Dieser Leitfaden führt von der Auswahl über einen begrenzten Lauf bis zur Prüfung des zugehörigen Datensatzes.

Mit dem vorgesehenen Konto verbinden

Der gehostete MCP-Server liegt unter https://mcp.apify.com. Apify dokumentiert eine Anmeldung über OAuth sowie alternativ einen Bearer-Token. Für den Browser-Anmeldeweg ergänzen Sie in .vscode/mcp.json folgenden Eintrag; ein Schlüssel steht dabei nicht in der Datei.

{
  "servers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com"
    }
  }
}

Starten Sie die Verbindung, schließen Sie die Anmeldung ab und vergleichen Sie das gewählte Konto mit Ihrer Console. Verwenden Sie in VS Code die Wurzel servers; Beispiele anderer Clients können mcpServers verwenden. Die VS-Code-Anleitung erklärt diese Zuordnung und den ersten Start.

Suche, Lauf und Ergebnis unterscheiden

Apify beschreibt ausdrücklich, dass call-actor den Laufstatus und Speicherkennungen zurückgibt. Die eigentlichen Ergebniszeilen lesen Sie anschließend aus dem Dataset. Verwechseln Sie daher eine erfolgreiche Startantwort nicht mit einer bereits geprüften Datenlieferung. Für die Suche nach Actors und Dokumentation gibt es außerdem einen gesondert eingeschränkten anonymen Zugang; Ausführung und gespeicherte Ergebnisse benötigen eine Anmeldung.

Mit einem begrenzten Lauf beginnen

1. Öffnen Sie die Actor-Details. Prüfen Sie Eingabeschema, Beispielausgabe und Bedingungen in der Herstelleransicht, bevor Sie Daten übergeben.

2. Begrenzen Sie den ersten Lauf auf Ihre vorbereitete Testadresse und eine kleine Ergebnismenge. Verwenden Sie die tatsächlich vom Actor unterstützten Eingabefelder.

3. Notieren Sie Laufkennung und Status. Bei einem laufenden Auftrag prüfen Sie denselben Lauf weiter, statt einen zweiten identischen Auftrag zu starten.

4. Lesen Sie die Ergebniszeilen aus der zugehörigen Dataset-Kennung. Vergleichen Sie eine bekannte Information, ein fehlendes Feld und die Anzahl der zurückgegebenen Zeilen.

Ein kurzes Prüfprotokoll führen

Für den Testbericht genügt eine kurze Zuordnung: Actor, Eingabe, Laufkennung, Dataset und Vergleichsergebnis. Damit kann eine zweite Person nachvollziehen, ob sie denselben Versuch betrachtet. Speichern Sie keine Zugangsschlüssel im Bericht. Der Zugriffsplan hilft, benötigte Kontorechte und Werkzeugfreigaben vor einem größeren Ablauf festzulegen.

Warum habe ich einen erfolgreichen Lauf, aber noch keine Daten?

Prüfen Sie die zurückgegebene Speicherkennung. Der Laufaufruf liefert nicht automatisch die Ergebniszeilen. Lesen Sie das zugehörige Dataset und kontrollieren Sie den endgültigen Laufstatus.

Muss ich alle verfügbaren Actors freigeben?

Wählen Sie für den Einstieg nur die Funktionen und Actors, die Sie für Ihren Test brauchen. Vergleichen Sie nach jeder Konfigurationsänderung die Werkzeugliste mit dieser Auswahl.

Warum sehe ich weniger Zeilen als erwartet?

Prüfen Sie Begrenzung und Versatz des Datenabrufs sowie die Gesamtmenge im Dataset. Eine begrenzte Antwort ist kein Beweis, dass der Lauf nur diese Zeilen erzeugt hat.

Ist Apify MCP dasselbe wie ein MCP-Connector innerhalb eines Actors?

Nein. Hier greift Ihr Client über Apifys Server auf die Plattform zu. Ein Connector innerhalb eines Actors beschreibt die andere Richtung: Der Actor verbindet sich mit einem weiteren MCP-Dienst.

Die Apify-Registersuche ergänzt deklarierte Eintragsmerkmale. Wenn Sie nur eine bekannte Seite benötigen, vergleichen Sie den Umfang mit der Firecrawl-Anleitung und beginnen Sie mit dem kleineren nachvollziehbaren Test.

Herstellerdokumentation am 3. Oktober 2026 gelesen. Die beschriebenen Tests führen Sie in Ihrer eigenen Umgebung aus.

1. Apify: MCP connection, tools and results
   Abrufbefehl anzeigen

   curl -s https://docs.apify.com/integrations/mcp
2. Apify: server implementation
   Abrufbefehl anzeigen

   curl -s https://github.com/apify/apify-mcp-server
3. VS Code: MCP configuration
   Abrufbefehl anzeigen

   curl -s https://code.visualstudio.com/docs/agent-customization/mcp-servers

Alle Beiträge