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.
- 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.
- 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.
- 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.
https://<YOUR_MCP_ENDPOINT>/mcp- Trasporto
- Streamable HTTP
- Autenticazione
- Token Bearer · chiave MCP dedicata
- Header
Authorization: Bearer <YOUR_MCP_KEY>- Guida per l’agente
- https://refracto.ai/mcp/agent.md
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.
get_contextIdentifica il tenant, le lingue disponibili, le funzionalità e i limiti effettivi.
searchTrova una notizia nell’archivio pubblicato. Conserva lo slug per la chiamata successiva.
read_briefingLeggi il briefing e le sue fonti. Usa analyze_briefing per esaminare le analisi già disponibili.
| Strumenti | Cosa può fare il tuo agente |
|---|---|
get_context | Leggere identità del tenant, lingue, funzionalità attive e limiti. |
get_frontmost_read | Esplorare le notizie pubblicate in ordine di rilevanza e le più lette. |
list_briefingsread_briefingrelated_briefings | Sfogliare l’archivio, leggere i briefing completi e seguire le notizie correlate. |
searchsearch_semanticsearch_source | Cercare per parole chiave, significato o URL di un articolo di una testata. |
analyze_briefing | Esaminare divergenza, sentiment, distribuzione geografica e attribuzione delle fonti già disponibili. |
list_sectorslist_languagesget_stats | Conoscere il catalogo e le statistiche di pubblicazione disponibili. |
get_mapread_place | Esplorare la copertura geografica e le notizie relative a un luogo restituito. |
list_clustersread_clusterbriefing_cluster | Esaminare fonti e metadati degli articoli originali alla base dei briefing pubblicati. |
list_audiobriefing_audioread_audio | Trovare gli audio attuali e ottenere un URL di download autorizzato e di breve durata. |
list_socialbriefing_socialread_social_media | Esaminare 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.
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