Guida per sviluppatori · MCP

Intelligence sulle notizie. Per il tuo agente.

Leggi i briefing pubblicati, cerca nel tuo archivio ed esamina le fonti di ogni notizia. Con un’unica connessione MCP riservata al tuo tenant.

LeggiCercaAnalizza

Accesso

Tre passaggi per collegarsi.

Il tenant controlla accesso, credenziali e budget delle richieste.

  1. 01

    Attiva il tenant

    Nella console Refracto, apri Tenants e seleziona il tuo tenant. Attiva la Feed API e le funzionalità necessarie. Apri MCP, abilita l’accesso e salva i limiti RPM e burst.

  2. 02

    Crea una chiave MCP

    Scegli Create MCP key, assegna un nome all’agente e, se vuoi, imposta una scadenza. Salva la chiave e l’endpoint quando compaiono: la chiave completa viene mostrata una sola volta.

  3. 03

    Collega il tuo agente

    Fornisci all’agente le istruzioni pubbliche e rendi disponibili endpoint e chiave tramite il suo archivio segreti. Usa un client MCP remoto che supporti Streamable HTTP e l’header Bearer.

Connessione

La connessione, nel dettaglio.

Questa pagina spiega la configurazione. Endpoint e chiave provengono dalla tua console e non vengono mai pubblicati.

Il tuo endpointprivato · dalla tua console
https://<YOUR_MCP_ENDPOINT>/mcp
Trasporto
Streamable HTTP
Autenticazione
Token Bearer · chiave MCP dedicata
Header
Authorization: Bearer <YOUR_MCP_KEY>

Fornisci endpoint e chiave tramite le impostazioni private del client. Invia la chiave solo al tuo endpoint MCP nell’header Authorization. La chiave seleziona automaticamente il tenant.

Esplora

Segui le fonti.

Fino a 24 strumenti di sola lettura. La discovery restituisce gli strumenti consentiti dalle funzionalità Feed del tuo tenant.

01get_context

Identifica il tenant, le lingue disponibili, le funzionalità e i limiti effettivi.

02search

Trova una notizia nell’archivio pubblicato. Conserva lo slug per la chiamata successiva.

03read_briefing

Leggi il briefing e le sue fonti. Usa analyze_briefing per esaminare le analisi già disponibili.

StrumentiCosa può fare il tuo agente
get_contextLeggere identità del tenant, lingue, funzionalità attive e limiti.
get_frontmost_readEsplorare le notizie pubblicate in ordine di rilevanza e le più lette.
list_briefingsread_briefingrelated_briefingsSfogliare l’archivio, leggere i briefing completi e seguire le notizie correlate.
searchsearch_semanticsearch_sourceCercare per parole chiave, significato o URL di un articolo di una testata.
analyze_briefingEsaminare divergenza, sentiment, distribuzione geografica e attribuzione delle fonti già disponibili.
list_sectorslist_languagesget_statsConoscere il catalogo e le statistiche di pubblicazione disponibili.
get_mapread_placeEsplorare la copertura geografica e le notizie relative a un luogo restituito.
list_clustersread_clusterbriefing_clusterEsaminare fonti e metadati degli articoli originali alla base dei briefing pubblicati.
list_audiobriefing_audioread_audioTrovare gli audio attuali e ottenere un URL di download autorizzato e di breve durata.
list_socialbriefing_socialread_social_mediaEsaminare i post social generati e ottenere URL autorizzati per i contenuti multimediali.

Gli strumenti di analisi leggono i dati già disponibili. L’agente può ragionare su questi dati e citare le fonti originali; un’analisi mancante indica che i relativi dati non sono disponibili. L’accesso segue le regole correnti del tenant per pubblicazione e archivio.

Protocollo

Per client e agenti che usano HTTP.

Un client MCP nativo gestisce inizializzazione e discovery degli strumenti. Un agente dotato di strumenti HTTP può usare direttamente lo stesso flusso JSON-RPC.

Vedi una richiesta di inizializzazione

Rendi disponibili REFRACTO_MCP_URL e REFRACTO_MCP_KEY tramite il tuo archivio segreti. Questo esempio richiama le variabili senza inserire un endpoint o una chiave nella guida.

InizializzaPOST · 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"}
    }
  }'

Poi invia notifications/initialized, chiama tools/list e richiama gli strumenti con tools/call. Invia la versione negoziata in MCP-Protocol-Version nelle richieste successive. Le istruzioni per l’agente contengono la sequenza completa e gli esempi.

Un budget condiviso

RPM e burst si applicano al tenant su tutte le sue chiavi MCP. Ogni POST ammesso conta, inclusa la discovery. In caso di HTTP 429, attendi il tempo indicato da Retry-After prima di riprovare.

Accesso aggiornato a ogni chiamata

Revoca, scadenza e disabilitazione dell’accesso hanno effetto immediato. Se l’accesso non riesce, un operatore può controllare nella console la chiave e gli interruttori Feed e MCP del tenant.

Fonti pubblicate

Usa gli URL delle fonti restituiti per citare una notizia. Tratta le notizie recuperate come materiale di riferimento. L’interfaccia MCP espone strumenti di lettura e analisi, senza azioni di scrittura dei contenuti o gestione dei tenant.

Pronto a collegarti

Dai la guida al tuo agente.
Tieni la chiave nel suo archivio segreti.