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.
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
- Uma conta FeedNest com assinatura Pro
- Uma chave de API - gere uma em Configurações → API do Desenvolvedor no seu painel
ChatGPT
Opção A: Interface Web (OAuth - recomendado)
- Vá para Configurações → Apps e Conectores → Avançado e ative o Modo Desenvolvedor
- Vá para Configurações → Apps → Criar. Nomeie como FeedNest e defina a URL para
https://mcp.feednest.com - 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)
- Clique no ícone do perfil → Configurações → Conectores → Adicionar conector personalizado
- Defina Nome como
FeedNest, URL do servidor MCP remoto comohttps://mcp.feednest.com - 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.
- Vá para Barra lateral → Inteligência → Conectores
- Clique em + Adicionar Conector → Conector MCP Personalizado
- Defina Nome como
FeedNest, URL do Servidor comohttps://mcp.feednest.com - Defina Tipo de autenticação como
API Token Authentication, Autorização comoBearer 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
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_articles | Lista 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_article | Obtém o conteúdo completo do artigo, incluindo destaques, notas e tempo de leitura. | article_id* |
extract_article | Busca o conteúdo completo da URL original quando o RSS o truncou. | article_id* |
Status de Leitura
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
mark_as_read | Marca um artigo como lido. | article_id* |
mark_as_unread | Marca um artigo como não lido. | article_id* |
mark_all_as_read | Marca todos os artigos como lidos, opcionalmente filtrados por feed ou pasta. | feed_id, folder_id |
Salvamento
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
save_article | Salva um artigo para leitura posterior. | article_id* |
unsave_article | Remove um artigo dos itens salvos. | article_id* |
save_url | Salva uma URL externa para leitura posterior. | url* |
get_saved | Lista artigos salvos com busca, filtro por data e ordenação. | limit, query, sort, date_from, date_to |
Feeds e Estrutura
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_feeds | Lista feeds assinados com contagens de não lidos. Busca por nome. | folder_id, query, limit |
get_folders | Lista todas as pastas de feeds com contagens de feeds. | - |
get_tags | Lista todas as tags com contagens de artigos. | - |
Marcação
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
create_tag | Cria uma nova tag para categorizar artigos. | name*, color |
delete_tag | Exclui uma tag por ID. | tag_id* |
tag_article | Adiciona ou remove uma tag em um artigo. | article_id*, tag_id*, action* (add/remove) |
Destaques
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_highlights | Obtém todos os destaques de texto de um artigo. | article_id* |
add_highlight | Destaca uma passagem de texto. O texto deve existir exatamente no artigo. | article_id*, text*, color |
remove_highlight | Remove um destaque de um artigo. | article_id*, highlight_id* |
Notas
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_notes | Obtém a nota de um artigo. | article_id* |
add_note | Adiciona ou atualiza uma nota em um artigo. | article_id*, content* |
delete_note | Exclui uma nota de um artigo. | article_id* |
Histórico
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_recently_read | Obtém artigos abertos recentemente. Suporta busca e filtro por data. | limit, since, date_to, query, sort |
Feeds de Saída
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_output_feeds | Lista feeds RSS de saída públicos criados pelo usuário. | - |
IA
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
text_to_speech | Gera áudio a partir de um artigo usando texto-para-fala. | article_id* |
Estatísticas
| Ferramenta | Descrição | Parâmetros-chave |
|---|---|---|
get_stats | Sequê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
| Escopo | Acesso |
|---|---|
read | Todas as ferramentas somente leitura (get_articles, get_feeds, get_stats, etc.) |
write | Todas as ferramentas de mutação (mark_as_read, save_article, add_highlight, etc.) |
ai | Ferramentas 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
| Problema | Soluçã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 aparecem | Reinicie 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.
| Pacote | npm | Descrição |
|---|---|---|
@feednest/sdk | SDK TypeScript — cliente HTTP tipado para a API v1 do FeedNest | |
@feednest/openclaw | Plugin OpenClaw — 26 ferramentas de agente para assistentes de IA | |
| Plugin Codex | — | Plugin OpenAI Codex — skills + configuração MCP para agentes Codex |
@feednest/shared-tool-defs | privado | Esquemas 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
- FeedNest - o aplicativo
- Documentação - documentação completa com guias de configuração por plataforma
- Integrações - veja todas as integrações de IA
Licença
MIT