FeedNest

Suas fontes selecionadas (RSS, YouTube, podcasts, Google News) como contexto para qualquer agente de IA: 26 ferramentas para ler, pesquisar, salvar, marcar, destacar e anotar seus feeds.

Documentação

Servidor MCP FeedNest

Suas fontes. Não a web inteira. Pergunte à sua IA sobre seus feeds - ela já conhece.

O ChatGPT pesquisa na internet. O Perplexity rastreia bilhões de páginas. Quando você pergunta sobre seu setor, seus interesses, seu mundo - eles te dão tudo, exceto o que importa.

FeedNest é diferente. Sua IA trabalha exclusivamente com as fontes que você escolhe: os blogs em que confia, as publicações que segue, os especialistas em que acredita. Sem ruído algorítmico. Sem resultados de caixa-preta. Inteligência fundamentada no seu mundo.

Este servidor MCP dá a qualquer assistente de IA - ChatGPT, Codex, Claude, Gemini, Grok, Cursor, Windsurf, Cline, Le Chat e outros - acesso direto aos seus feeds, artigos, destaques, notas e tags por meio de linguagem natural.

Website Docs Smithery


O Que Sua IA Pode Fazer

Basta perguntar. Sua IA cuida do resto.

  • Resumos matinais - Acorde com um resumo de tudo o que aconteceu durante a noite nos seus feeds
  • Compare a cobertura - Veja como diferentes fontes noticiam a mesma história, lado a lado
  • Identifique tendências cedo - Sua IA detecta padrões emergentes antes de chegarem à grande mídia
  • Aprofunde-se em qualquer tópico - Obtenha uma síntese abrangente de todas as fontes que você segue
  • Acompanhe histórias em desenvolvimento - Siga uma narrativa conforme ela evolui em todos os seus feeds
  • Busca instantânea - Encontre qualquer artigo em todas as suas fontes em segundos
  • Destaques e notas - Salve o que importa e anote com seus próprios pensamentos
  • Resumos em áudio - Transforme qualquer artigo ou resumo em algo que você possa ouvir

Início Rápido

Pré-requisitos

  1. Uma conta FeedNest com assinatura Pro
  2. Uma chave de API - gere uma em Configurações → API do Desenvolvedor no seu painel

ChatGPT

Opção A: Interface Web (OAuth - recomendado)

  1. Vá para Configurações → Apps e Conectores → Avançado e ative o Modo Desenvolvedor
  2. Vá para Configurações → Apps → Criar. Nomeie como FeedNest e defina a URL para https://mcp.feednest.com
  3. O ChatGPT redirecionará você para o FeedNest - faça login e autorize

Nenhuma chave de API necessária. O ChatGPT lida com o fluxo OAuth automaticamente.

Opção B: API de Respostas

Inclua o FeedNest como uma ferramenta MCP na sua solicitação de API:

{
  "type": "mcp",
  "server_url": "https://mcp.feednest.com",
  "server_label": "feednest",
  "authorization": "fn_live_YOUR_API_KEY"
}

Codex

Opção A: Plugin (recomendado)

Abra o diretório de plugins do Codex e procure por FeedNest:

codex
/plugins

O plugin agrupa skills, configuração MCP e recursos de marca em uma única instalação. Veja o README do plugin Codex para opções de instalação local.

Opção B: MCP no config.toml

Adicione 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"

Ou via CLI:

codex mcp add feednest --transport http https://mcp.feednest.com

Claude

Claude.ai Web (OAuth - recomendado)

  1. Clique no ícone do perfil → Configurações → Conectores → Adicionar conector personalizado
  2. Defina Nome como FeedNest, URL do servidor MCP remoto como https://mcp.feednest.com
  3. Deixe o ID do Cliente OAuth e o Segredo vazios. Clique em Adicionar e autorize.

Claude Code

claude mcp add --transport http feednest https://mcp.feednest.com \
  --header "Authorization: Bearer fn_live_YOUR_API_KEY"

Adicione -s user para acesso global em todos os projetos.

Claude Desktop (requer ponte)

O Claude Desktop só suporta servidores baseados em stdio. Use a ponte 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"
      }
    }
  }
}

Caminho da configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/.config/Claude/claude_desktop_config.json (Linux).

Cursor

Adicione a .cursor/mcp.json no seu projeto (ou ~/.cursor/mcp.json para global):

{
  "mcpServers": {
    "feednest": {
      "url": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Dica: O Cursor suporta interpolação de variáveis de ambiente: "Bearer ${env:FEEDNEST_API_KEY}". Não adicione um campo "type" - o Cursor detecta automaticamente a partir da chave "url".

Le Chat (Mistral)

Disponível em todos os planos, incluindo o nível gratuito.

  1. Vá para Barra lateral → Inteligência → Conectores
  2. Clique em + Adicionar Conector → Conector MCP Personalizado
  3. Defina Nome como FeedNest, URL do Servidor como https://mcp.feednest.com
  4. Defina Tipo de autenticação como API Token Authentication, Autorização como Bearer fn_live_YOUR_API_KEY

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "feednest": {
      "serverUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Importante: O Windsurf usa "serverUrl" (não "url"). Usar a chave errada causa uma falha silenciosa.

Cline

No VS Code, abra as configurações da extensão Cline → configuração dos Servidores MCP (JSON):

{
  "mcpServers": {
    "feednest": {
      "type": "streamableHttp",
      "url": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Crítico: O campo "type": "streamableHttp" é obrigatório para o Cline. Sem ele, cabeçalhos personalizados podem falhar silenciosamente e a autenticação não funcionará.

Gemini CLI

Adicione a ~/.gemini/settings.json:

{
  "mcpServers": {
    "feednest": {
      "httpUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

Nota: O Gemini CLI usa "httpUrl" (não "url"). O campo "url" é reservado para transporte SSE. Apenas CLI - gemini.google.com não suporta servidores MCP externos.

Grok (xAI)

Disponível apenas através da API/SDK xAI, não pela interface de chat 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?"
  }'

Qualquer outro cliente MCP

Qualquer cliente que suporte Streamable HTTP pode se conectar usando:

  • URL: https://mcp.feednest.com
  • Cabeçalho: Authorization: Bearer fn_live_YOUR_API_KEY

Para clientes somente stdio, use a ponte mcp-remote:

{
  "mcpServers": {
    "feednest": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.feednest.com",
        "--header", "Authorization:Bearer fn_live_YOUR_API_KEY"
      ]
    }
  }
}

Ferramentas (26)

Artigos

FerramentaDescriçãoParâmetros-chave
get_articlesLista artigos com título, fonte, data e prévia do resumo. Visualizações: newsfeed, por-feed, por-pasta, por-tag, marcados, destacados, anotados.view*, feed_id, folder_id, tag_id, limit, query, sort, unread_only, date_from, date_to, count_only
get_articleObtém o conteúdo completo do artigo, incluindo destaques, notas e tempo de leitura.article_id*
extract_articleBusca o conteúdo completo da URL original quando o RSS o truncou.article_id*

Status de Leitura

FerramentaDescriçãoParâmetros-chave
mark_as_readMarca um artigo como lido.article_id*
mark_as_unreadMarca um artigo como não lido.article_id*
mark_all_as_readMarca todos os artigos como lidos, opcionalmente filtrados por feed ou pasta.feed_id, folder_id

Salvamento

FerramentaDescriçãoParâmetros-chave
save_articleSalva um artigo para leitura posterior.article_id*
unsave_articleRemove um artigo dos itens salvos.article_id*
save_urlSalva uma URL externa para leitura posterior.url*
get_savedLista artigos salvos com busca, filtro por data e ordenação.limit, query, sort, date_from, date_to

Feeds e Estrutura

FerramentaDescriçãoParâmetros-chave
get_feedsLista feeds assinados com contagens de não lidos. Busca por nome.folder_id, query, limit
get_foldersLista todas as pastas de feeds com contagens de feeds.-
get_tagsLista todas as tags com contagens de artigos.-

Marcação

FerramentaDescriçãoParâmetros-chave
create_tagCria uma nova tag para categorizar artigos.name*, color
delete_tagExclui uma tag por ID.tag_id*
tag_articleAdiciona ou remove uma tag em um artigo.article_id*, tag_id*, action* (add/remove)

Destaques

FerramentaDescriçãoParâmetros-chave
get_highlightsObtém todos os destaques de texto de um artigo.article_id*
add_highlightDestaca uma passagem de texto. O texto deve existir exatamente no artigo.article_id*, text*, color
remove_highlightRemove um destaque de um artigo.article_id*, highlight_id*

Notas

FerramentaDescriçãoParâmetros-chave
get_notesObtém a nota de um artigo.article_id*
add_noteAdiciona ou atualiza uma nota em um artigo.article_id*, content*
delete_noteExclui uma nota de um artigo.article_id*

Histórico

FerramentaDescriçãoParâmetros-chave
get_recently_readObtém artigos abertos recentemente. Suporta busca e filtro por data.limit, since, date_to, query, sort

Feeds de Saída

FerramentaDescriçãoParâmetros-chave
get_output_feedsLista feeds RSS de saída públicos criados pelo usuário.-

IA

FerramentaDescriçãoParâmetros-chave
text_to_speechGera áudio a partir de um artigo usando texto-para-fala.article_id*

Estatísticas

FerramentaDescriçãoParâmetros-chave
get_statsSequência de leitura, artigos lidos hoje, tempo de leitura, total de feeds, contagem de não lidos, contagem de salvos.-

* = parâmetro obrigatório


Exemplo de Conversa

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?"

Mais coisas que você pode perguntar

  • "Me dê um resumo matinal dos meus feeds"
  • "Compare como a Bloomberg e a Reuters cobriram esta história"
  • "O que eu li ontem?"
  • "Salve este artigo e destaque as principais descobertas"
  • "Marque todos os artigos relacionados a IA com 'Machine Learning'"
  • "Como está minha sequência de leitura?"
  • "Transforme este artigo em áudio"

Autenticação

Chave de API (uso pessoal)

Gere uma chave em Configurações → API do Desenvolvedor no painel do FeedNest. As chaves começam com fn_live_ seguidas de 32 caracteres hexadecimais.

Authorization: Bearer fn_live_abc123...

OAuth 2.1 (aplicativos de terceiros)

O servidor suporta OAuth 2.1 completo com PKCE. Endpoint de descoberta:

https://mcp.feednest.com/.well-known/oauth-protected-resource

O ChatGPT e o Claude.ai lidam com OAuth automaticamente - nenhuma chave de API necessária para eles.

Escopos

EscopoAcesso
readTodas as ferramentas somente leitura (get_articles, get_feeds, get_stats, etc.)
writeTodas as ferramentas de mutação (mark_as_read, save_article, add_highlight, etc.)
aiFerramentas de IA (text_to_speech)

Você Mantém o Controle

  • Você escolhe o que é visível - Selecione exatamente quais feeds, pastas e ações sua IA pode acessar
  • Criptografado e verificado - Cada solicitação é protegida para que ninguém mais alcance seus dados
  • Limites de uso integrados - 1.000 solicitações/hora por chave, sua conta permanece protegida
  • Revogue o acesso instantaneamente - Um clique no seu painel

Solução de Problemas

ProblemaSolução
"Bearer token required"Verifique se o cabeçalho Authorization está configurado corretamente
"Invalid API key format"A chave deve começar com fn_live_ seguida de 32 caracteres hexadecimais
"Invalid or revoked API key"Regere em Configurações → API do Desenvolvedor
"API access requires a Pro subscription"Atualize para Pro em feednest.com
"Rate limit reached"Aguarde alguns minutos e tente novamente
"Insufficient scope"Sua chave de API não tem o escopo necessário
Ferramentas não aparecemReinicie seu cliente de IA após alterar a configuração MCP

Pacotes

Este repositório é um monorepo contendo as bibliotecas de cliente e plugins para o servidor MCP FeedNest.

PacotenpmDescrição
@feednest/sdknpmSDK TypeScript — cliente HTTP tipado para a API v1 do FeedNest
@feednest/openclawnpmPlugin OpenClaw — 26 ferramentas de agente para assistentes de IA
Plugin CodexPlugin OpenAI Codex — skills + configuração MCP para agentes Codex
@feednest/shared-tool-defsprivadoEsquemas Zod compartilhados e formatadores de texto (agrupados no plugin)

Desenvolvimento

npm install
npm run build    # Build all packages (sdk → shared-tool-defs → openclaw-plugin)
npm test         # Run all tests
npm run type-check

Links

Licença

MIT