Guide développeur · MCP
L’analyse de l’actualité. Pour votre agent.
Lisez les briefings publiés, recherchez dans vos archives et examinez les sources de chaque information. Avec une seule connexion MCP réservée à votre tenant.
LireRechercherAnalyser
Accès
Trois étapes pour se connecter.
Le tenant contrôle l’accès, les identifiants et le budget de requêtes.
- 01
Activez votre tenant
Dans votre console Refracto, ouvrez Tenants et sélectionnez votre tenant. Activez sa Feed API et les fonctionnalités nécessaires. Ouvrez MCP, activez l’accès et enregistrez vos limites RPM et de rafale.
- 02
Créez une clé MCP
Choisissez Create MCP key, nommez l’agent et définissez éventuellement une date d’expiration. Enregistrez la clé et le point de connexion lorsqu’ils apparaissent : la clé complète n’est affichée qu’une seule fois.
- 03
Connectez votre agent
Donnez à l’agent les instructions publiques et rendez le point de connexion et la clé disponibles dans son coffre de secrets. Utilisez un client MCP distant prenant en charge Streamable HTTP et un en-tête Bearer.
Connexion
La connexion, en détail.
Cette page explique la configuration. Votre point de connexion et votre clé proviennent de votre console et ne sont jamais publiés.
https://<YOUR_MCP_ENDPOINT>/mcp- Transport
- Streamable HTTP
- Authentification
- Jeton Bearer · clé MCP dédiée
- En-tête
Authorization: Bearer <YOUR_MCP_KEY>- Guide pour l’agent
- https://refracto.ai/mcp/agent.md
Renseignez le point de connexion et la clé dans les paramètres privés de votre client. Envoyez la clé uniquement à votre point de connexion MCP dans l’en-tête Authorization. La clé sélectionne automatiquement le tenant.
Explorer
Remontez aux sources.
Jusqu’à 24 outils en lecture seule. La découverte renvoie les outils autorisés par les fonctionnalités Feed de votre tenant.
get_contextIdentifiez le tenant, les langues disponibles, les fonctionnalités et les limites effectives.
searchTrouvez une information dans les archives publiées. Conservez son slug pour l’appel suivant.
read_briefingLisez le briefing et ses sources. Utilisez analyze_briefing pour examiner les analyses existantes.
| Outils | Ce que votre agent peut faire |
|---|---|
get_context | Lire l’identité du tenant, les langues, les fonctionnalités activées et les limites. |
get_frontmost_read | Explorer les actualités publiées classées par pertinence et les plus lues. |
list_briefingsread_briefingrelated_briefings | Parcourir les archives, lire les briefings complets et suivre les informations connexes. |
searchsearch_semanticsearch_source | Rechercher par mots-clés, par sens ou par URL d’un article de presse. |
analyze_briefing | Examiner la divergence, le sentiment, la répartition géographique et l’attribution des sources déjà disponibles. |
list_sectorslist_languagesget_stats | Comprendre le catalogue et les statistiques de publication disponibles. |
get_mapread_place | Explorer la couverture géographique et les informations concernant un lieu renvoyé. |
list_clustersread_clusterbriefing_cluster | Examiner les sources et les métadonnées des articles originaux à l’origine des briefings publiés. |
list_audiobriefing_audioread_audio | Trouver les fichiers audio actuels et obtenir une URL de téléchargement autorisée et de courte durée. |
list_socialbriefing_socialread_social_media | Examiner les publications sociales générées et obtenir des URL autorisées pour leurs médias. |
Les outils d’analyse lisent les données existantes. L’agent peut raisonner à partir de ces données et citer les sources originales ; une analyse manquante signifie que les données correspondantes ne sont pas disponibles. L’accès suit les règles actuelles de publication et d’archivage du tenant.
Protocole
Pour les clients et les agents capables d’utiliser HTTP.
Un client MCP natif gère l’initialisation et la découverte des outils. Un agent doté d’outils HTTP peut utiliser directement le même flux JSON-RPC.
Voir une requête d’initialisation
Rendez REFRACTO_MCP_URL et REFRACTO_MCP_KEY disponibles dans votre coffre de secrets. Cet exemple référence les variables sans inclure de point de connexion ni de clé dans le guide.
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"}
}
}'Envoyez ensuite notifications/initialized, appelez tools/list et invoquez les outils avec tools/call. Envoyez la version négociée dans l’en-tête MCP-Protocol-Version pour les requêtes suivantes. Les instructions pour l’agent contiennent la séquence complète et des exemples.
Un budget partagé
Les limites RPM et de rafale s’appliquent au tenant pour toutes ses clés MCP. Chaque POST admis compte, y compris la découverte. En cas de réponse HTTP 429, attendez le délai indiqué par Retry-After avant de réessayer.
Un accès actualisé à chaque appel
La révocation, l’expiration et la désactivation de l’accès prennent effet immédiatement. En cas d’échec, un opérateur peut vérifier la clé et les réglages Feed et MCP du tenant dans la console.
Des sources publiées
Utilisez les URL des sources renvoyées pour citer une information. Traitez les actualités récupérées comme du matériel de référence. L’interface MCP expose des outils de lecture et d’analyse, sans actions d’écriture de contenu ni de gestion des tenants.
Prêt à vous connecter