Entwicklerleitfaden · MCP

Nachrichtenanalyse. Für Ihren Agenten.

Lesen Sie veröffentlichte Briefings, durchsuchen Sie Ihr Archiv und prüfen Sie die Quellen hinter jeder Nachricht. Über eine einzige MCP-Verbindung für Ihren Mandanten.

LesenSuchenAnalysieren

Zugriff

In drei Schritten verbinden.

Der Mandant bestimmt Zugriff, Zugangsdaten und Anfragenbudget.

  1. 01

    Mandanten aktivieren

    Öffnen Sie in Ihrer Refracto-Konsole Tenants und wählen Sie Ihren Mandanten. Aktivieren Sie seine Feed API und die benötigten Funktionen. Öffnen Sie MCP, aktivieren Sie den Zugriff und speichern Sie die RPM- und Burst-Limits.

  2. 02

    MCP-Schlüssel erstellen

    Wählen Sie Create MCP key, benennen Sie den Agenten und legen Sie bei Bedarf ein Ablaufdatum fest. Speichern Sie Schlüssel und Endpunkt, sobald sie erscheinen: Der vollständige Schlüssel wird nur einmal angezeigt.

  3. 03

    Agenten verbinden

    Geben Sie dem Agenten die öffentliche Anleitung und stellen Sie Endpunkt und Schlüssel über seinen Geheimnisspeicher bereit. Verwenden Sie einen Remote-MCP-Client, der Streamable HTTP und einen Bearer-Header unterstützt.

Verbindung

Die Verbindung im Detail.

Diese Seite erklärt die Einrichtung. Ihr Endpunkt und Schlüssel stammen aus Ihrer Konsole und werden niemals veröffentlicht.

Ihr Endpunktprivat · aus Ihrer Konsole
https://<YOUR_MCP_ENDPOINT>/mcp
Transport
Streamable HTTP
Authentifizierung
Bearer-Token · eigener MCP-Schlüssel
Header
Authorization: Bearer <YOUR_MCP_KEY>

Hinterlegen Sie Endpunkt und Schlüssel in den privaten Einstellungen Ihres Clients. Senden Sie den Schlüssel nur im Authorization-Header an Ihren MCP-Endpunkt. Der Schlüssel wählt den Mandanten automatisch aus.

Erkunden

Den Quellen folgen.

Bis zu 24 Werkzeuge mit Lesezugriff. Die Discovery liefert die Werkzeuge, die die Feed-Funktionen Ihres Mandanten erlauben.

01get_context

Ermitteln Sie Mandant, verfügbare Sprachen, Funktionen und geltende Limits.

02search

Finden Sie eine Nachricht im veröffentlichten Archiv. Bewahren Sie ihren Slug für den nächsten Aufruf auf.

03read_briefing

Lesen Sie das Briefing und seine Quellen. Prüfen Sie vorhandene Analysen mit analyze_briefing.

WerkzeugeWas Ihr Agent tun kann
get_contextIdentität des Mandanten, Sprachen, aktivierte Funktionen und Limits lesen.
get_frontmost_readNach Relevanz geordnete und meistgelesene veröffentlichte Nachrichten erkunden.
list_briefingsread_briefingrelated_briefingsDas Archiv durchsuchen, vollständige Briefings lesen und verwandten Nachrichten folgen.
searchsearch_semanticsearch_sourceNach Stichwörtern, Bedeutung oder der Artikel-URL eines Mediums suchen.
analyze_briefingVorhandene Divergenz, Stimmung, geografische Verteilung und Quellenzuordnung prüfen.
list_sectorslist_languagesget_statsDen Katalog und verfügbare Veröffentlichungsstatistiken verstehen.
get_mapread_placeGeografische Berichterstattung und Nachrichten an einem zurückgegebenen Ort erkunden.
list_clustersread_clusterbriefing_clusterQuellen und Metadaten der Originalartikel hinter veröffentlichten Briefings prüfen.
list_audiobriefing_audioread_audioAktuelle Audiodateien finden und eine autorisierte, kurzzeitig gültige Download-URL erhalten.
list_socialbriefing_socialread_social_mediaErstellte Social-Media-Beiträge prüfen und autorisierte Medien-URLs erhalten.

Analysewerkzeuge lesen vorhandene Daten. Der Agent kann daraus Schlüsse ziehen und die Originalquellen zitieren; eine fehlende Analyse bedeutet, dass die zugehörigen Daten nicht verfügbar sind. Der Zugriff folgt den aktuellen Veröffentlichungs- und Archivregeln des Mandanten.

Protokoll

Für Clients und HTTP-fähige Agenten.

Ein nativer MCP-Client übernimmt Initialisierung und Werkzeug-Discovery. Ein Agent mit HTTP-Werkzeugen kann denselben JSON-RPC-Ablauf direkt verwenden.

Initialisierungsanfrage ansehen

Stellen Sie REFRACTO_MCP_URL und REFRACTO_MCP_KEY über Ihren Geheimnisspeicher bereit. Dieses Beispiel verweist auf die Variablen, ohne einen Endpunkt oder Schlüssel in den Leitfaden aufzunehmen.

InitialisierenPOST · JSON-RPC
curl "$REFRACTO_MCP_URL" \
  -H "Authorization: Bearer $REFRACTO_MCP_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-agent", "version": "1.0"}
    }
  }'

Senden Sie anschließend notifications/initialized, rufen Sie tools/list auf und verwenden Sie Werkzeuge mit tools/call. Senden Sie die ausgehandelte Version im Header MCP-Protocol-Version bei nachfolgenden Anfragen. Die Agentenanleitung enthält den vollständigen Ablauf und Beispiele.

Ein gemeinsames Budget

RPM und Burst gelten für den Mandanten über alle seine MCP-Schlüssel hinweg. Jeder zugelassene POST zählt, einschließlich Discovery. Warten Sie bei HTTP 429 die in Retry-After angegebene Zeit, bevor Sie es erneut versuchen.

Aktueller Zugriff bei jedem Aufruf

Widerruf, Ablauf und deaktivierter Zugriff gelten sofort. Schlägt der Zugriff fehl, kann ein Betreiber den Schlüssel sowie die Feed- und MCP-Schalter des Mandanten in der Konsole prüfen.

Veröffentlichte Quellen

Verwenden Sie die zurückgegebenen Quellen-URLs, wenn Sie eine Nachricht zitierst. Behandeln Sie abgerufene Nachrichten als Quellenmaterial. Die MCP-Schnittstelle bietet Lese- und Analysewerkzeuge, aber keine Aktionen zum Schreiben von Inhalten oder Verwalten von Mandanten.

Bereit für die Verbindung

Geben Sie Ihrem Agenten den Leitfaden.
Bewahren Sie den Schlüssel in seinem Geheimnisspeicher auf.