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.
- 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.
- 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.
- 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.
https://<YOUR_MCP_ENDPOINT>/mcp- Transport
- Streamable HTTP
- Authentifizierung
- Bearer-Token · eigener MCP-Schlüssel
- Header
Authorization: Bearer <YOUR_MCP_KEY>- Agentenleitfaden
- https://refracto.ai/mcp/agent.md
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.
get_contextErmitteln Sie Mandant, verfügbare Sprachen, Funktionen und geltende Limits.
searchFinden Sie eine Nachricht im veröffentlichten Archiv. Bewahren Sie ihren Slug für den nächsten Aufruf auf.
read_briefingLesen Sie das Briefing und seine Quellen. Prüfen Sie vorhandene Analysen mit analyze_briefing.
| Werkzeuge | Was Ihr Agent tun kann |
|---|---|
get_context | Identität des Mandanten, Sprachen, aktivierte Funktionen und Limits lesen. |
get_frontmost_read | Nach Relevanz geordnete und meistgelesene veröffentlichte Nachrichten erkunden. |
list_briefingsread_briefingrelated_briefings | Das Archiv durchsuchen, vollständige Briefings lesen und verwandten Nachrichten folgen. |
searchsearch_semanticsearch_source | Nach Stichwörtern, Bedeutung oder der Artikel-URL eines Mediums suchen. |
analyze_briefing | Vorhandene Divergenz, Stimmung, geografische Verteilung und Quellenzuordnung prüfen. |
list_sectorslist_languagesget_stats | Den Katalog und verfügbare Veröffentlichungsstatistiken verstehen. |
get_mapread_place | Geografische Berichterstattung und Nachrichten an einem zurückgegebenen Ort erkunden. |
list_clustersread_clusterbriefing_cluster | Quellen und Metadaten der Originalartikel hinter veröffentlichten Briefings prüfen. |
list_audiobriefing_audioread_audio | Aktuelle Audiodateien finden und eine autorisierte, kurzzeitig gültige Download-URL erhalten. |
list_socialbriefing_socialread_social_media | Erstellte 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.
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