Integração com assistentes de IA (MCP)

Liga o Linkflare ao teu assistente de IA preferido e gere os teus marcadores por conversa natural. Guardar links, pesquisar na tua biblioteca, organizar coleções, rever flashcards com repetição espaçada e resumir os teus destaques — tudo sem saíres do chat.

O que é o MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite aos assistentes de IA interagir com ferramentas e dados externos. Imagina que dás à tua IA um conjunto de superpoderes — neste caso, a capacidade de ler, escrever e organizar os teus marcadores do Linkflare.

O Linkflare disponibiliza um servidor MCP alojado em https://mcp.linkflare.io/mcp, que funciona com qualquer cliente compatível com MCP, incluindo o Claude Desktop, o ChatGPT, o Cursor, o Windsurf e muito mais.

O que podes fazer com ele?

Assim que a ligação estiver estabelecida, podes falar com o teu assistente de IA em linguagem simples, e ele interage com a tua biblioteca do Linkflare em teu nome. Eis algumas coisas que podes dizer:

Guardar marcadores

• «Guarda este link na minha coleção Receitas: https://example.com/pasta-recipe»
• «Adiciona https://arxiv.org/abs/2401.12345 e marca-o com as etiquetas machine-learning e research»
• «Aqui está um monte de links das minhas notas — guarda-os todos:» (colar um bloco de texto com URLs)

Pesquisar e encontrar

• «Encontra todos os meus marcadores sobre TypeScript»
• «Mostra-me os vídeos com a etiqueta scotland»
• «Que receitas guardei recentemente?»
• «Encontra os artigos que avaliei com gosto»
• «Pesquisa nos meus cartões de conhecimento por repetição espaçada»

Organizar

• «Move os links 42 e 43 para a minha coleção Trabalho»
• «Cria uma nova coleção chamada Viagem ao Japão»
• «Cria uma etiqueta chamada must-read»
• «O que está na minha caixa de entrada? Ajuda-me a organizá-la.»

Registar conhecimento Pro

Os cartões de conhecimento são notas hierárquicas com conteúdo rico, etiquetas e repetição espaçada opcional. As ferramentas de conhecimento requerem um plano Pro.

• «Cria um cartão de conhecimento com o título React Server Components e estas notas: …»
• «Adiciona sob Bases de cozinha um cartão subordinado para Técnicas de faca»
• «Atualiza o cartão 42 — acrescenta: também funciona com async iterators»
• «Mostra-me todos os cartões de conhecimento de nível superior»
• «O que sei sobre bases de dados vetoriais? Resume os meus cartões.»

Rever flashcards Pro

A tua IA torna-se um parceiro de estudo: vai buscar os cartões de conhecimento pendentes para revisão por repetição espaçada, questiona-te um de cada vez e regista cada resultado, para que o Linkflare reagende o cartão.

• «Faz-me perguntas sobre os meus flashcards pendentes»
• «Quantos cartões tenho pendentes para revisão?»
• «Faz uma sessão de revisão — coloca uma pergunta de cada vez e avalia-me com honestidade»

Destaques e feeds RSS

• «O que destaquei sobre repetição espaçada?»
• «Resume os temas presentes nos meus destaques recentes»
• «Que feeds RSS tenho subscritos?»
• «Subscreve o feed RSS deste blogue: https://example.com/feed.xml»

Rever e refletir

• «Dá-me uma visão geral do que guardei esta semana»
• «Resume o que está na minha coleção Inspiração de design»
• «Encontra marcadores sobre design de interfaces»
• «Que marcadores ainda não têm etiquetas? Sugere algumas.»
• «Explora a minha base de conhecimento sobre machine learning — que lacunas tenho?»
• «Explora o diretório Descobrir do Linkflare à procura de coleções sobre modelos mentais»

Exemplos práticos

Pré-requisitos

1. Uma conta Linkflare – regista-te aqui, se ainda não tiveres uma.
2. A tua chave de API – abre a app Linkflare, clica no teu menu de utilizador (canto superior direito) e escolhe Copiar chave de API.
3. Um cliente de IA que suporte servidores MCP remotos (vê os guias de configuração abaixo).

Instalação rápida

Um clique adiciona o Linkflare ao teu editor. Na primeira utilização autorizas com a tua chave de API do Linkflare — nada para colar à mão.

Claude Code: claude mcp add --transport http linkflare https://mcp.linkflare.io/mcp

Configuração: Claude

O Claude suporta connectores MCP remotos personalizados no Claude, no Claude Desktop e em planos de equipa compatíveis. Adiciona o Linkflare como connector web personalizado.

Passo 1: abrir os Connectors

Vai a Settings → Connectors e clica em Add custom connector.

Passo 2: preencher os detalhes do connector

• Name: linkflare
• Remote MCP server URL: https://mcp.linkflare.io/mcp

Passo 3: configurar o OAuth (Advanced settings)

Abre Advanced settings e define:

• OAuth Client ID: linkflare-claude

Passo 4: autorizar

Quando usares as ferramentas do Linkflare pela primeira vez numa conversa, o Claude abre uma página de autorização onde colas a tua chave de API do Linkflare. Encontras a tua chave de API clicando no teu menu de utilizador (canto superior direito) na app Linkflare e escolhendo Copiar chave de API. Após a autorização, o Claude memoriza a tua ligação.

Passo 5: experimenta

Inicia uma conversa e diz algo como:

• «O que está na minha caixa de entrada do Linkflare?»
• «Pesquisa nos meus marcadores artigos sobre produtividade»
• «Guarda https://example.com na minha lista de leitura»

O Claude pede permissão antes de usar uma ferramenta pela primeira vez.

Configuração: ChatGPT

O ChatGPT suporta servidores MCP remotos através das apps do ChatGPT e do Developer Mode. O Linkflare suporta autenticação OAuth, para que o ChatGPT se possa ligar com segurança.

Passo 1: abrir as definições do ChatGPT

Vai a Settings → Apps, desliza depois até Advanced settings e clica em Create app.

Passo 2: criar uma nova app

Preenche o seguinte:

• Name: Linkflare
• MCP Server URL: https://mcp.linkflare.io/mcp
• Authentication: OAuth

Se o ChatGPT pedir detalhes OAuth adicionais:

• Client ID: linkflare-chatgpt
• Client Secret: deixa em branco

O ChatGPT deteta automaticamente os endpoints de autorização e de token a partir do servidor MCP.

Passo 3: autorizar

Quando usares as ferramentas do Linkflare pela primeira vez numa conversa, o ChatGPT abre uma página de autorização onde colas a tua chave de API do Linkflare. Encontras a tua chave de API clicando no teu menu de utilizador (canto superior direito) na app Linkflare e escolhendo Copiar chave de API. Após a autorização, o ChatGPT memoriza a tua ligação.

Passo 4: testar

Inicia uma nova conversa e pede ao ChatGPT para «listar as minhas coleções do Linkflare», para verificares se a ligação funciona.

Configuração: VS Code

Usa o ficheiro de configuração MCP no VS Code. O OAuth abre o teu navegador na primeira ligação. Mais rápido: usa a instalação rápida acima.

{
  "servers": {
    "linkflare": {
      "type": "http",
      "url": "https://mcp.linkflare.io/mcp",
      "oauth": {
        "clientId": "linkflare-vscode"
      }
    }
  }
}

Configuração: Cursor

Adiciona o Linkflare a ~/.cursor/mcp.json ou .cursor/mcp.json. O Cursor usa um callback OAuth fixo e dados estáticos de cliente OAuth. Mais rápido: usa a instalação rápida acima.

{
  "mcpServers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp",
      "auth": {
        "CLIENT_ID": "linkflare-cursor",
        "scopes": ["mcp"]
      }
    }
  }
}

Configuração: Windsurf

Adiciona o Linkflare no painel de configuração MCP ou edita ~/.codeium/windsurf/mcp_config.json. Se o OAuth não estiver disponível na tua versão, usa o fallback com chave de API abaixo.

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LINKFLARE_API_KEY}"
      }
    }
  }
}

Configuração: Zed

Adiciona o Linkflare como servidor de contexto personalizado no Zed. Quando não há cabeçalho Authorization configurado, o Zed inicia o fluxo OAuth MCP padrão.

{
  "context_servers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp"
    }
  }
}

Fallback legado para versões antigas do Zed ou clientes sem suporte nativo para MCP remoto:

{
  "context_servers": {
    "linkflare": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linkflare.io/mcp"]
    }
  }
}

Detalhes da ligação

Definição	Valor
URL do endpoint	https://mcp.linkflare.io/mcp
Transporte	Streamable HTTP
Autenticação	Token Bearer através do cabeçalho Authorization
Cabeçalho de auth	Authorization: Bearer YOUR_API_KEY

Alternativa: alguns clientes usam, em vez disso, um cabeçalho x-api-key. O Linkflare aceita ambos.

Ferramentas disponíveis

Assim que a ligação estiver estabelecida, o teu assistente de IA passa a ter à disposição as ferramentas seguintes. Não precisas de as memorizar — fala simplesmente de forma natural e a IA escolhe a certa.

Ferramentas de marcadores

Ferramenta	O que faz
add_link	Guardar um marcador, opcionalmente com coleção, etiquetas, notas e tipo
add_links_from_text	Extrair e guardar todos os URLs de um bloco de texto colado
search_links	Pesquisar marcadores com filtros (texto, coleção, etiquetas, tipo, caixa de entrada, avaliação)
get_link	Obter todos os detalhes de um marcador específico
update_link	Atualizar o título, as notas, as etiquetas ou outras propriedades de um marcador
delete_link	Eliminar um marcador
move_links	Mover um ou mais marcadores para outra coleção
rate_link	Avaliar um marcador com gosto ou não gosto
get_inbox	Listar todas as entradas da caixa de entrada

Ferramentas de organização

Ferramenta	O que faz
list_collections	Ver todas as tuas coleções em árvore
create_collection	Criar uma nova coleção
list_tags	Ver todas as tuas etiquetas
create_tag	Criar uma nova etiqueta

Ferramentas de conhecimento Pro

Os cartões de conhecimento são notas hierárquicas de texto formatado (pensa no Notion / Obsidian) que podem ser ligadas aos teus marcadores e revistas com repetição espaçada. Estas ferramentas requerem um plano Pro.

Ferramenta	O que faz
search_knowledge	Pesquisar cartões de conhecimento por palavra-chave no título, no conteúdo e nas etiquetas
add_knowledge	Criar um novo cartão de conhecimento, opcionalmente com conteúdo, etiquetas, cartão superior e cor
get_knowledge	Obter um cartão por ID com o seu conteúdo completo e a navegação por migalhas do cartão superior
update_knowledge	Atualizar o título, o conteúdo, as etiquetas, o cartão superior ou a cor de um cartão
delete_knowledge	Eliminar um cartão. Atenção: elimina também todos os cartões subordinados aninhados.
list_knowledge_children	Percorrer a hierarquia – listar os cartões raiz ou os cartões subordinados de um cartão específico

Ferramentas de destaques

Os destaques são as passagens que marcas em páginas web com a extensão do navegador do Linkflare. A tua IA pode pesquisá-los e resumi-los (a criação de destaques continua a ser feita no navegador, onde está a página).

Ferramenta	O que faz
search_highlights	Pesquisa de texto integral nos teus destaques e nas suas notas
list_highlights	Listar destaques, dos mais recentes para os mais antigos — opcionalmente de um marcador ou URL de página específico
delete_highlight	Eliminar um destaque

Ferramentas de revisão por repetição espaçada Pro

Testa-te nos teus cartões de conhecimento sem saíres do chat. A IA pergunta, tu respondes, e o agendador de repetição espaçada do Linkflare decide quando voltas a ver cada cartão. Requer um plano Pro.

Ferramenta	O que faz
get_review_queue	Obter os cartões de conhecimento pendentes para revisão
submit_review	Registar o resultado de uma revisão (again / hard / good / easy, ou seja: de novo / difícil / bom / fácil) — reagenda o cartão e guarda o teu histórico de revisões
get_review_stats	Ver quantos cartões estão pendentes e quantos estão em rotação

Ferramentas de feeds RSS

Ferramenta	O que faz
list_feeds	Listar as tuas subscrições RSS/Atom com estatísticas de itens guardados e interações
add_feed	Subscrever um feed por URL — as novas publicações chegam automaticamente à tua biblioteca
remove_feed	Cancelar a subscrição de um feed (as publicações já guardadas mantêm-se)

Descobrir

Ferramenta	O que faz
browse_discover	Explorar o diretório público do Linkflare com coleções curadas, pesquisas guardadas e temas de conhecimento — com links para ver e subscrever

Prompts de IA

Estes são modelos de prompt pré-criados que a tua IA pode usar para fluxos comuns:

Prompt	O que faz
organize_inbox	Obter sugestões para organizar as entradas da tua caixa de entrada
summarize_collection	Resumir o conteúdo de uma coleção
find_related	Encontrar marcadores sobre um tema específico
weekly_digest	Obter uma visão geral dos marcadores guardados recentemente
suggest_tags	Obter sugestões de etiquetas para marcadores sem etiquetas
explore_knowledge Pro	Pesquisar na tua base de conhecimento sobre um tema, resumir o que está registado e realçar lacunas
review_session Pro	Iniciar uma sessão de revisão por repetição espaçada com os teus cartões de conhecimento pendentes
highlight_digest	Sintetizar os teus destaques recentes em temas e conclusões, com links para as fontes

Resolução de problemas

Erro «Unauthorized» ou «Missing authentication»

Verifica novamente a tua chave de API. Na app Linkflare, clica no teu menu de utilizador (canto superior direito) e escolhe Copiar chave de API para copiares a chave exata. Certifica-te de que não há espaços a mais e de que está incluída a chave completa.

As ferramentas não aparecem no Claude Desktop

• Certifica-te de que encerraste totalmente o Claude Desktop (não basta fechar a janela) e voltaste a abri-lo.
• Verifica novamente que o nome do connector é linkflare e que o URL é exatamente https://mcp.linkflare.io/mcp (sem barra final).
• Confirma que o OAuth Client ID nas Advanced settings está definido como linkflare-claude.

Sem resultados na pesquisa

A pesquisa é uma pesquisa de texto integral. Se uma consulta não devolver resultados, tenta termos mais gerais. Também podes filtrar por coleção, etiquetas ou tipo em vez de por texto.

Coleção ou etiqueta não encontrada

Podes usar nomes de coleção e de etiqueta (não apenas IDs). A correspondência de nomes não distingue maiúsculas de minúsculas, pelo que tanto «receitas» como «Receitas» funcionam.

As ferramentas de conhecimento devolvem «Forbidden» ou «Pro plan required»

As ferramentas de conhecimento e de revisão (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children, get_review_queue, submit_review, get_review_stats, bem como os prompts explore_knowledge / review_session) estão limitadas a contas Pro. As ferramentas de marcadores, coleções, etiquetas, destaques e feeds funcionam no plano gratuito. Faz a atualização na página de preços.

Eliminei um cartão de conhecimento, mas os meus cartões subordinados desapareceram

O delete_knowledge atua em cascata – eliminar um cartão superior remove todos os cartões aninhados por baixo dele. Se a IA se oferecer para eliminar um cartão com cartões subordinados, verifica novamente antes de concordares. Para arrumares sem perderes os cartões subordinados, move-os primeiro com update_knowledge (define parent_id como 0 para a raiz ou como o ID de outro cartão).

Privacidade e segurança

A tua chave de API identifica a tua conta. O servidor MCP acede apenas aos teus marcadores pessoais – não consegue ver os dados de outros utilizadores. Toda a comunicação é encriptada por HTTPS.

O assistente de IA só vê aquilo que lhe pedes. Não tem acesso permanente à tua biblioteca completa, a menos que o solicites expressamente.