Guía para desarrolladores · MCP

Inteligencia sobre noticias. Para tu agente.

Lee los briefings publicados, busca en tu archivo y examina las fuentes de cada noticia. Con una única conexión MCP reservada a tu tenant.

LeerBuscarAnalizar

Acceso

Tres pasos para conectarte.

El tenant controla el acceso, las credenciales y el presupuesto de solicitudes.

  1. 01

    Activa tu tenant

    En tu consola Refracto, abre Tenants y selecciona tu tenant. Activa su Feed API y las funciones necesarias. Abre MCP, habilita el acceso y guarda los límites RPM y de ráfaga.

  2. 02

    Crea una clave MCP

    Elige Create MCP key, asigna un nombre al agente y, si quieres, establece una fecha de caducidad. Guarda la clave y el endpoint cuando aparezcan: la clave completa se muestra una sola vez.

  3. 03

    Conecta tu agente

    Dale al agente las instrucciones públicas y facilita el endpoint y la clave mediante su almacén de secretos. Usa un cliente MCP remoto compatible con Streamable HTTP y una cabecera Bearer.

Conexión

La conexión, en detalle.

Esta página explica la configuración. Tu endpoint y tu clave proceden de tu consola y nunca se publican.

Tu endpointprivado · desde tu consola
https://<YOUR_MCP_ENDPOINT>/mcp
Transporte
Streamable HTTP
Autenticación
Token Bearer · clave MCP dedicada
Cabecera
Authorization: Bearer <YOUR_MCP_KEY>

Facilita el endpoint y la clave mediante los ajustes privados de tu cliente. Envía la clave únicamente a tu endpoint MCP en la cabecera Authorization. La clave selecciona el tenant automáticamente.

Explorar

Sigue las fuentes.

Hasta 24 herramientas de solo lectura. El descubrimiento devuelve las herramientas que permiten las funciones Feed de tu tenant.

01get_context

Identifica el tenant, los idiomas disponibles, las funciones y los límites efectivos.

02search

Encuentra una noticia en el archivo publicado. Guarda su slug para la siguiente llamada.

03read_briefing

Lee el briefing y sus fuentes. Usa analyze_briefing para examinar los análisis existentes.

HerramientasQué puede hacer tu agente
get_contextLeer la identidad del tenant, los idiomas, las funciones activadas y los límites.
get_frontmost_readExplorar las noticias publicadas ordenadas por relevancia y las más leídas.
list_briefingsread_briefingrelated_briefingsExplorar el archivo, leer briefings completos y seguir noticias relacionadas.
searchsearch_semanticsearch_sourceBuscar por palabras clave, significado o URL de un artículo de un medio.
analyze_briefingExaminar la divergencia, el sentimiento, la distribución geográfica y la atribución de fuentes ya disponibles.
list_sectorslist_languagesget_statsConocer el catálogo y las estadísticas de publicación disponibles.
get_mapread_placeExplorar la cobertura geográfica y las noticias de un lugar devuelto.
list_clustersread_clusterbriefing_clusterExaminar las fuentes y los metadatos de los artículos originales que sustentan los briefings publicados.
list_audiobriefing_audioread_audioEncontrar los audios actuales y obtener una URL de descarga autorizada y de corta duración.
list_socialbriefing_socialread_social_mediaExaminar las publicaciones sociales generadas y obtener URL autorizadas para sus archivos multimedia.

Las herramientas de análisis leen datos existentes. El agente puede razonar sobre ellos y citar las fuentes originales; la ausencia de un análisis indica que los datos correspondientes no están disponibles. El acceso sigue las reglas actuales de publicación y archivo del tenant.

Protocolo

Para clientes y agentes que pueden usar HTTP.

Un cliente MCP nativo gestiona la inicialización y el descubrimiento de herramientas. Un agente con herramientas HTTP puede usar directamente el mismo flujo JSON-RPC.

Ver una solicitud de inicialización

Facilita REFRACTO_MCP_URL y REFRACTO_MCP_KEY mediante tu almacén de secretos. Este ejemplo hace referencia a las variables sin incluir un endpoint ni una clave en la guía.

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

Después envía notifications/initialized, llama a tools/list e invoca las herramientas con tools/call. Envía la versión acordada en MCP-Protocol-Version en las solicitudes posteriores. Las instrucciones para el agente contienen la secuencia completa y ejemplos.

Un presupuesto compartido

Los límites RPM y de ráfaga se aplican al tenant en todas sus claves MCP. Cada POST admitido cuenta, incluido el descubrimiento. Ante una respuesta HTTP 429, espera el tiempo indicado en Retry-After antes de reintentar.

Acceso actualizado en cada llamada

La revocación, la caducidad y la desactivación del acceso tienen efecto inmediato. Si el acceso falla, un operador puede comprobar la clave y los ajustes Feed y MCP del tenant en la consola.

Fuentes publicadas

Usa las URL de las fuentes devueltas para citar una noticia. Trata las noticias recuperadas como material de referencia. La interfaz MCP expone herramientas de lectura y análisis, sin acciones de escritura de contenido ni de gestión de tenants.

Listo para conectarte

Dale la guía a tu agente.
Guarda la clave en su almacén de secretos.