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.

  1. 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.

  2. 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.

  3. 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.

Votre point de connexionprivé · depuis votre console
https://<YOUR_MCP_ENDPOINT>/mcp
Transport
Streamable HTTP
Authentification
Jeton Bearer · clé MCP dédiée
En-tête
Authorization: Bearer <YOUR_MCP_KEY>

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.

01get_context

Identifiez le tenant, les langues disponibles, les fonctionnalités et les limites effectives.

02search

Trouvez une information dans les archives publiées. Conservez son slug pour l’appel suivant.

03read_briefing

Lisez le briefing et ses sources. Utilisez analyze_briefing pour examiner les analyses existantes.

OutilsCe que votre agent peut faire
get_contextLire l’identité du tenant, les langues, les fonctionnalités activées et les limites.
get_frontmost_readExplorer les actualités publiées classées par pertinence et les plus lues.
list_briefingsread_briefingrelated_briefingsParcourir les archives, lire les briefings complets et suivre les informations connexes.
searchsearch_semanticsearch_sourceRechercher par mots-clés, par sens ou par URL d’un article de presse.
analyze_briefingExaminer la divergence, le sentiment, la répartition géographique et l’attribution des sources déjà disponibles.
list_sectorslist_languagesget_statsComprendre le catalogue et les statistiques de publication disponibles.
get_mapread_placeExplorer la couverture géographique et les informations concernant un lieu renvoyé.
list_clustersread_clusterbriefing_clusterExaminer les sources et les métadonnées des articles originaux à l’origine des briefings publiés.
list_audiobriefing_audioread_audioTrouver les fichiers audio actuels et obtenir une URL de téléchargement autorisée et de courte durée.
list_socialbriefing_socialread_social_mediaExaminer 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.

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

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

Donnez le guide à votre agent.
Gardez la clé dans son coffre de secrets.