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 — 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 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?»

Exemplos práticos

🔬 Fluxo de investigação

Estás a investigar um tema e encontras muitos artigos úteis. Em vez de mudares para o Linkflare, diz simplesmente à tua IA:

«Guarda https://example.com/article na minha coleção Investigação, marca-o com as etiquetas AI e transformers e avalia-o com gosto»

📋 Arrumar a caixa de entrada

A tua caixa de entrada cresceu. Pede ajuda à tua IA:

«Mostra-me a minha caixa de entrada. Agrupa as entradas por tipo e sugere a que coleção pertence cada uma.»

🎬 Noite de cinema

A planear uma noite de cinema? Pede uma recomendação da tua própria coleção:

«Pesquisa nos meus marcadores filmes que ainda não avaliei. Escolhe um que pareça um filme de ação divertido.»

🍳 Planeamento semanal de refeições

Guardaste receitas a semana toda. É hora de planear:

«Mostra-me todas as receitas na minha caixa de entrada. Escolhe 5 para os jantares desta semana e move-as para a minha coleção Plano de refeições.»

📚 Rever a lista de leitura

Põe em dia o que guardaste:

«Dá-me uma visão geral semanal dos meus marcadores recentes. Sobre que temas guardei mais?»

✈️ Planeamento de viagens

Andas há meses a recolher links de viagem:

«Encontra todos os marcadores com a etiqueta japan. Resume o que recolhi — restaurantes, hotéis, atividades.»

💡 Guardar vários links a partir de notas

Tens um documento cheio de links. Cola-o e diz:

«Extrai todos os URLs deste texto e guarda-os na minha coleção Lista de leitura.»

🧠 Registar o que acabaste de aprender Pro

Acabaste de ler um artigo e queres registar as ideias-chave como cartão de conhecimento:

«Cria um cartão de conhecimento com o título Rate Limiting Patterns sob o meu cartão superior Engenharia. Notas: token bucket, leaky bucket, sliding window. Marca-o com as etiquetas backend e distributed-systems.»

🔎 Verificar lacunas de conhecimento Pro

Usa o prompt explore_knowledge para verificares um tema antes de aprofundares:

«Explora o que sei sobre transformers. Resume os meus cartões e lista depois 3 subtemas que ainda não registei.»

Pré-requisitos

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

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.

{
  "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.

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

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

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 (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children, bem como o prompt explore_knowledge) estão limitadas a contas Pro. As ferramentas de marcadores, coleções e etiquetas 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.