FeedNest
Tus fuentes seleccionadas (RSS, YouTube, podcasts, Google News) como contexto para cualquier agente de IA: 26 herramientas para leer, buscar, guardar, etiquetar, resaltar y anotar tus fuentes.
Documentación
Servidor MCP de FeedNest
Tus fuentes. No toda la web. Pregúntale a tu IA sobre tus feeds: ya los conoce.
ChatGPT busca en internet. Perplexity rastrea miles de millones de páginas. Cuando preguntas sobre tu industria, tus intereses, tu mundo, te dan todo excepto lo que importa.
FeedNest es diferente. Tu IA trabaja exclusivamente con las fuentes que eliges: los blogs en los que confías, las publicaciones que sigues, los expertos en los que crees. Sin ruido algorítmico. Sin resultados de caja negra. Inteligencia basada en tu mundo.
Este servidor MCP le da a cualquier asistente de IA - ChatGPT, Codex, Claude, Gemini, Grok, Cursor, Windsurf, Cline, Le Chat y más - acceso directo a tus feeds, artículos, destacados, notas y etiquetas a través de lenguaje natural.
Lo que tu IA puede hacer
Solo pregunta. Tu IA se encarga del resto.
- Resúmenes matutinos - Despierta con un resumen de todo lo que ocurrió durante la noche en tus feeds
- Comparar coberturas - Ve cómo diferentes fuentes reportan la misma historia, lado a lado
- Detectar tendencias temprano - Tu IA detecta patrones emergentes antes de que lleguen a los medios principales
- Profundizar en cualquier tema - Obtén una síntesis completa de cada fuente que sigues
- Seguir historias en desarrollo - Sigue una narrativa mientras evoluciona en todos tus feeds
- Búsqueda instantánea - Encuentra cualquier artículo en todas tus fuentes en segundos
- Destacados y notas - Guarda lo que importa y anota con tus propios pensamientos
Inicio rápido
Requisitos previos
- Una cuenta de FeedNest. Las aplicaciones que se conectan con OAuth (ChatGPT, Claude) funcionan en todos los planes: en el plan Gratuito pueden leer tus feeds y artículos, hasta 20 solicitudes por hora; Plus y Pro también les permiten guardar, etiquetar, destacar, tomar notas y marcar artículos como leídos.
- Para clientes configurados con una clave API: una clave de Configuración → API de desarrollador, que requiere una suscripción Pro
ChatGPT
Opción A: Interfaz web (OAuth - recomendado)
- Ve a Configuración → Aplicaciones y conectores → Avanzado y activa el Modo desarrollador
- Ve a Configuración → Aplicaciones → Crear. Nómbralo FeedNest y establece la URL a
https://mcp.feednest.com - ChatGPT te redirigirá a FeedNest: inicia sesión y autoriza
No se necesita clave API. ChatGPT maneja el flujo OAuth automáticamente.
Opción B: API de Respuestas
Incluye FeedNest como una herramienta MCP en tu solicitud de API:
{
"type": "mcp",
"server_url": "https://mcp.feednest.com",
"server_label": "feednest",
"authorization": "fn_live_YOUR_API_KEY"
}
Codex
Opción A: Plugin (recomendado)
El plugin agrupa habilidades, configuración MCP y recursos de marca en una sola instalación. Aún no está en el directorio de plugins de Codex, así que instálalo desde este repositorio: consulta Instalación local en el README del plugin de Codex.
Opción B: MCP en config.toml
Añade a ~/.codex/config.toml:
[mcp_servers.feednest]
url = "https://mcp.feednest.com"
bearer_token_env_var = "FEEDNEST_API_KEY"
export FEEDNEST_API_KEY="fn_live_YOUR_API_KEY"
O mediante CLI:
codex mcp add feednest --transport http https://mcp.feednest.com
Claude
Directorio de conectores (OAuth - recomendado)
FeedNest está listado en el directorio de conectores de Claude.
- Abre claude.ai/directory/feednest, o busca FeedNest en Personalizar → Conectores
- Haz clic en Conectar con Claude, inicia sesión en FeedNest y autoriza
No se necesita clave API, y el conector sigue tu cuenta de Claude a Claude Desktop y las aplicaciones móviles.
Para añadirlo por URL en su lugar, añade un conector personalizado en Personalizar → Conectores con la URL https://mcp.feednest.com y deja el ID de cliente OAuth y el Secreto vacíos.
Claude Code
claude mcp add --transport http feednest https://mcp.feednest.com \
--header "Authorization: Bearer fn_live_YOUR_API_KEY"
Añade -s user para acceso global en todos los proyectos.
Archivo de configuración de Claude Desktop (requiere puente)
El conector del directorio anterior ya funciona en Claude Desktop. Para configurar FeedNest en claude_desktop_config.json en su lugar, que solo ejecuta servidores stdio, usa el puente mcp-remote:
{
"mcpServers": {
"feednest": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.feednest.com",
"--header", "Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Ruta de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/.config/Claude/claude_desktop_config.json (Linux).
Cursor
Añade a .cursor/mcp.json en tu proyecto (o ~/.cursor/mcp.json para global):
{
"mcpServers": {
"feednest": {
"url": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Consejo: Cursor admite interpolación de variables de entorno:
"Bearer ${env:FEEDNEST_API_KEY}". No añadas un campo"type"- Cursor lo detecta automáticamente desde la clave"url".
Le Chat (Mistral)
Disponible en todos los planes, incluido el nivel gratuito.
- Ve a Barra lateral → Inteligencia → Conectores
- Haz clic en + Añadir conector → Conector MCP personalizado
- Establece Nombre a
FeedNest, URL del servidor ahttps://mcp.feednest.com - Establece Tipo de autenticación a
API Token Authentication, Autorización aBearer fn_live_YOUR_API_KEY
Windsurf
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"feednest": {
"serverUrl": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Importante: Windsurf usa
"serverUrl"(no"url"). Usar la clave incorrecta causa un fallo silencioso.
Cline
En VS Code, abre la configuración de la extensión Cline → Configuración de servidores MCP (JSON):
{
"mcpServers": {
"feednest": {
"type": "streamableHttp",
"url": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Crítico: El campo
"type": "streamableHttp"es obligatorio para Cline. Sin él, los encabezados personalizados pueden fallar silenciosamente y la autenticación no funcionará.
CLI de Gemini
Añade a ~/.gemini/settings.json:
{
"mcpServers": {
"feednest": {
"httpUrl": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Nota: El CLI de Gemini usa
"httpUrl"(no"url"). El campo"url"está reservado para transporte SSE. Solo CLI - gemini.google.com no admite servidores MCP externos.
Grok (xAI)
Disponible solo a través de la API/SDK de xAI, no desde la interfaz de chat de grok.com.
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-3",
"tools": [{
"type": "mcp",
"server_url": "https://mcp.feednest.com",
"server_label": "feednest",
"authorization": "Bearer fn_live_YOUR_API_KEY"
}],
"input": "What are my unread articles?"
}'
Cualquier otro cliente MCP
Cualquier cliente que admita HTTP Streamable puede conectarse usando:
- URL:
https://mcp.feednest.com - Encabezado:
Authorization: Bearer fn_live_YOUR_API_KEY
Para clientes solo stdio, usa el puente mcp-remote:
{
"mcpServers": {
"feednest": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.feednest.com",
"--header", "Authorization:Bearer fn_live_YOUR_API_KEY"
]
}
}
}
Herramientas (25)
Artículos
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_articles | Lista artículos con título, fuente, fecha y vista previa del resumen. Vistas: newsfeed, por-feed, por-carpeta, por-etiqueta, etiquetados, destacados, con notas. | view*, feed_id, folder_id, tag_id, limit, query, sort, unread_only, date_from, date_to, count_only |
get_article | Obtén el contenido completo del artículo, incluidos destacados, notas y tiempo de lectura. | article_id* |
extract_article | Obtén el contenido completo de la URL original cuando RSS lo truncó. | article_id* |
Estado de lectura
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
mark_as_read | Marca un artículo como leído. | article_id* |
mark_as_unread | Marca un artículo como no leído. | article_id* |
mark_all_as_read | Marca todos los artículos como leídos, opcionalmente filtrados por feed o carpeta. | feed_id, folder_id |
Guardado
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
save_article | Guarda un artículo para leerlo más tarde. | article_id* |
unsave_article | Elimina un artículo de los elementos guardados. | article_id* |
save_url | Guarda una URL externa para leerla más tarde. | url* |
get_saved | Lista artículos guardados con búsqueda, filtrado por fecha y ordenamiento. | limit, query, sort, date_from, date_to |
Feeds y estructura
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_feeds | Lista feeds suscritos con conteos de no leídos. Busca por nombre. | folder_id, query, limit |
get_folders | Lista todas las carpetas de feeds con conteos de feeds. | - |
get_tags | Lista todas las etiquetas con conteos de artículos. | - |
Etiquetado
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
create_tag | Crea una nueva etiqueta para categorizar artículos. | name*, color |
delete_tag | Elimina una etiqueta por ID. | tag_id* |
tag_article | Añade o elimina una etiqueta en un artículo. | article_id*, tag_id*, action* (add/remove) |
Destacados
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_highlights | Obtén todos los destacados de texto de un artículo. | article_id* |
add_highlight | Destaca un pasaje de texto. El texto debe existir exactamente en el artículo. | article_id*, text*, color |
remove_highlight | Elimina un destacado de un artículo. | article_id*, highlight_id* |
Notas
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_notes | Obtén la nota de un artículo. | article_id* |
add_note | Añade o actualiza una nota en un artículo. | article_id*, content* |
delete_note | Elimina una nota de un artículo. | article_id* |
Historial
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_recently_read | Obtén artículos abiertos recientemente. Admite búsqueda y filtrado por fecha. | limit, since, date_to, query, sort |
Feeds de salida
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_output_feeds | Lista feeds RSS públicos de salida creados por el usuario. | - |
IA
text_to_speech no está expuesto por el servidor MCP alojado: genera audio con
un modelo de IA, lo que el directorio de conectores de Claude no permite. Leer artículos
en voz alta sigue disponible en la aplicación FeedNest y a través del plugin OpenClaw.
Estadísticas
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
get_stats | Racha de lectura, artículos leídos hoy, tiempo de lectura, total de feeds, conteo de no leídos, conteo de guardados. | - |
* = parámetro requerido
Conversación de ejemplo
You: "What's happening in AI today?"
ChatGPT: "Based on your tech feeds, here are today's 3 biggest stories:
1. OpenAI announced GPT-5, covered first in your Hacker News feed
2. EU AI Act enforcement begins, mentioned across 4 of your sources
3. Google published new Gemini research, from your AI folder
Want me to summarize any of them?"
Más cosas que puedes preguntar
- "Dame un resumen matutino de mis feeds"
- "Compara cómo Bloomberg y Reuters cubrieron esta historia"
- "¿Qué leí ayer?"
- "Guarda este artículo y destaca los hallazgos clave"
- "Etiqueta todos los artículos relacionados con IA como 'Machine Learning'"
- "¿Cómo va mi racha de lectura?"
Autenticación
Clave API (uso personal)
Genera una clave desde Configuración → API de desarrollador en el panel de FeedNest. Las claves comienzan con fn_live_ seguidas de 32 caracteres hexadecimales.
Authorization: Bearer fn_live_abc123...
OAuth 2.1 (aplicaciones de terceros)
El servidor admite OAuth 2.1 completo con PKCE. Punto final de descubrimiento:
https://mcp.feednest.com/.well-known/oauth-protected-resource
ChatGPT y Claude.ai manejan OAuth automáticamente: no se necesita clave API para esos.
Planes
Las aplicaciones que se conectan con OAuth funcionan en todos los planes de FeedNest. Las claves API requieren Pro.
| Gratuito | Plus | Pro | |
|---|---|---|---|
| Leer feeds, carpetas, artículos, artículos guardados, etiquetas, historial de lectura y feeds de salida | Sí | Sí | Sí |
| Los destacados de un artículo | Sí | Sí | Sí |
Notas, las vistas highlighted y noted, estadísticas de lectura | No | Sí | Sí |
| Cambios: marcar como leído, guardar, etiquetar, destacar, tomar notas, cargar el texto completo de un artículo | No | Sí | Sí |
Filtros de fecha (date_from, date_to, since) | No | No | Sí |
| Solicitudes por hora | 20 llamadas de herramientas | 1,000 | 1,000 |
| Claves API | No | No | Sí |
Una aplicación conectada detecta un cambio de plan en su siguiente actualización de token, dentro de una hora, o inmediatamente cuando reconectas FeedNest.
Ámbitos
| Ámbito | Acceso |
|---|---|
read | Todas las herramientas de solo lectura (get_articles, get_feeds, get_stats, etc.) |
write | Todas las herramientas de mutación (mark_as_read, save_article, add_highlight, etc.) |
ai | Ninguna herramienta MCP por el momento (ver IA arriba) |
Tú mantienes el control
- Tú eliges qué es visible - Selecciona exactamente qué feeds, carpetas y acciones puede acceder tu IA
- Cifrado y verificado - Cada solicitud está asegurada para que nadie más pueda acceder a tus datos
- Límites de uso integrados - 1,000 solicitudes por hora (20 llamadas de herramientas en Gratuito), para que tu cuenta esté protegida
- Revoca el acceso al instante - Un clic desde tu panel
Solución de problemas
| Problema | Solución |
|---|---|
| "Se requiere token Bearer" | Verifica que el encabezado Authorization esté configurado correctamente |
| "Formato de clave API inválido" | La clave debe comenzar con fn_live_ seguido de 32 caracteres hexadecimales |
| "Clave API inválida o revocada" | Regenera desde Configuración → API de desarrollador |
| "El acceso a la API requiere una suscripción Pro" | Las claves API requieren Pro. Mejora en feednest.com, o conéctate con OAuth, que funciona en todos los planes |
| "...incluido en FeedNest Plus y Pro" | La cuenta está en el plan Gratuito, donde las aplicaciones pueden leer fuentes, artículos, artículos guardados, etiquetas y destacados, pero no cambiar nada. Después de mejorar, vuelve a conectar FeedNest para que la aplicación reciba el nuevo plan. Consulta Planes |
| "El filtrado por fecha está incluido en FeedNest Pro" | Los filtros de fecha requieren Pro. Sin ellos, los artículos siguen apareciendo primero los más recientes |
| "...incluye 20 solicitudes por hora de asistentes de IA" | La cuota horaria del plan Gratuito se ha agotado. Inténtalo de nuevo después de la espera que indica el mensaje |
| "Límite de velocidad alcanzado" | Espera unos minutos y reintenta |
| "Alcance insuficiente" | Tu clave API no tiene el alcance requerido |
| Las herramientas no aparecen | Reinicia tu cliente de IA después de cambiar la configuración de MCP |
Paquetes
Este repositorio es un monorepo que contiene las bibliotecas de cliente y los plugins para el servidor MCP de FeedNest.
| Paquete | npm | Descripción |
|---|---|---|
@feednest/sdk | SDK de TypeScript — cliente HTTP tipado para la API v1 de FeedNest | |
@feednest/openclaw | Plugin de OpenClaw — 26 herramientas de agente para asistentes de IA | |
| Plugin Codex | — | Plugin para ChatGPT y Codex: habilidades y una configuración de MCP que inicia sesión con OAuth |
@feednest/shared-tool-defs | privado | Esquemas Zod compartidos y formateadores de texto (incluidos en el plugin) |
Desarrollo
npm install
npm run build # Build all packages (sdk → shared-tool-defs → openclaw-plugin)
npm test # Run all tests, including the Codex plugin checks
npm run type-check
npm run pack:codex-plugin # ZIP of the Codex plugin for platform.openai.com/plugins
Enlaces
- FeedNest - la aplicación
- Documentación - documentación completa con guías de configuración por plataforma
- Integraciones - consulta todas las integraciones de IA
Licencia
MIT