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.
- 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.
- 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.
- 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.
https://<YOUR_MCP_ENDPOINT>/mcp- Transporte
- Streamable HTTP
- Autenticación
- Token Bearer · clave MCP dedicada
- Cabecera
Authorization: Bearer <YOUR_MCP_KEY>- Guía para el agente
- https://refracto.ai/mcp/agent.md
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.
get_contextIdentifica el tenant, los idiomas disponibles, las funciones y los límites efectivos.
searchEncuentra una noticia en el archivo publicado. Guarda su slug para la siguiente llamada.
read_briefingLee el briefing y sus fuentes. Usa analyze_briefing para examinar los análisis existentes.
| Herramientas | Qué puede hacer tu agente |
|---|---|
get_context | Leer la identidad del tenant, los idiomas, las funciones activadas y los límites. |
get_frontmost_read | Explorar las noticias publicadas ordenadas por relevancia y las más leídas. |
list_briefingsread_briefingrelated_briefings | Explorar el archivo, leer briefings completos y seguir noticias relacionadas. |
searchsearch_semanticsearch_source | Buscar por palabras clave, significado o URL de un artículo de un medio. |
analyze_briefing | Examinar la divergencia, el sentimiento, la distribución geográfica y la atribución de fuentes ya disponibles. |
list_sectorslist_languagesget_stats | Conocer el catálogo y las estadísticas de publicación disponibles. |
get_mapread_place | Explorar la cobertura geográfica y las noticias de un lugar devuelto. |
list_clustersread_clusterbriefing_cluster | Examinar las fuentes y los metadatos de los artículos originales que sustentan los briefings publicados. |
list_audiobriefing_audioread_audio | Encontrar los audios actuales y obtener una URL de descarga autorizada y de corta duración. |
list_socialbriefing_socialread_social_media | Examinar 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.
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