Intégration d'assistant IA (MCP)

Connecte Linkflare à ton assistant IA préféré et gère tes favoris par simple conversation naturelle. Enregistrer des liens, rechercher dans ta bibliothèque, organiser des collections – tout cela sans quitter ton chat.

Qu'est-ce que le MCP ?

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux assistants IA d'interagir avec des outils et des données externes. Imagine que tu donnes à ton IA un ensemble de super-pouvoirs – ici, la capacité de lire, d'écrire et d'organiser tes favoris Linkflare.

Linkflare met à disposition un serveur MCP hébergé à l'adresse https://mcp.linkflare.io/mcp, qui fonctionne avec tout client compatible MCP, dont Claude Desktop, ChatGPT, Cursor, Windsurf et bien d'autres.

Que peux-tu en faire ?

Une fois la connexion établie, tu peux parler à ton assistant IA en langage simple, et il interagit en ton nom avec ta bibliothèque Linkflare. Voici quelques exemples de ce que tu peux dire :

Enregistrer des favoris

• « Enregistre ce lien dans ma collection Recettes : https://example.com/pasta-recipe"
• « Ajoute https://arxiv.org/abs/2401.12345 et donne-lui les tags machine-learning et research"
• « Voici un tas de liens tirés de mes notes – enregistre-les tous :" (coller un bloc de texte contenant des URL)

Rechercher et trouver

• « Trouve tous mes favoris sur le thème TypeScript"
• « Montre-moi les vidéos avec le tag scotland"
• « Quelles recettes ai-je enregistrées récemment ?"
• « Trouve les articles que j'ai notés d'un pouce levé"
• « Cherche dans mes cartes de connaissances la répétition espacée"

Organiser

• « Déplace les liens 42 et 43 dans ma collection Travail"
• « Crée une nouvelle collection nommée Voyage au Japon"
• « Crée un tag nommé must-read"
• « Qu'y a-t-il dans ma boîte de réception ? Aide-moi à l'organiser."

Capturer des connaissances Pro

Les cartes de connaissances sont des notes hiérarchiques avec un contenu riche, des tags et, en option, de la répétition espacée. Les outils de connaissances nécessitent un forfait Pro.

• « Crée une carte de connaissances intitulée React Server Components avec ces notes : …"
• « Sous Bases de la cuisine, ajoute une carte enfant pour Maîtrise du couteau"
• « Mets à jour la carte 42 – ajoute : fonctionne aussi avec les async iterators"
• « Montre-moi toutes les cartes de connaissances de premier niveau"
• « Que sais-je sur les bases de données vectorielles ? Résume mes cartes."

Revoir et réfléchir

• « Donne-moi un aperçu de ce que j'ai enregistré cette semaine"
• « Résume ce qu'il y a dans ma collection Inspiration design"
• « Trouve les favoris sur le thème du design d'interface utilisateur"
• « Quels favoris n'ont pas encore de tags ? Propose-en."
• « Explore ma base de connaissances sur le thème de l'apprentissage automatique – quelles sont mes lacunes ?"

Exemples concrets

Prérequis

1. Un compte Linkflare – inscris-toi ici si tu n'en as pas encore.
2. Ta clé API – ouvre l'application Linkflare, clique sur ton menu utilisateur (en haut à droite) et choisis Copier la clé API.
3. Un client IA qui prend en charge les serveurs MCP distants (voir les guides de configuration ci-dessous).

Configuration : Claude

Claude prend en charge les connecteurs MCP distants personnalisés dans Claude, Claude Desktop et les offres d'équipe compatibles. Ajoute Linkflare comme connecteur web personnalisé.

Étape 1 : Ouvrir Connectors

Va dans Settings → Connectors et clique sur Add custom connector.

Étape 2 : Remplir les détails du connecteur

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

Étape 3 : Configurer OAuth (Advanced settings)

Ouvre Advanced settings et définis :

• OAuth Client ID : linkflare-claude

Étape 4 : Autoriser

La première fois que tu utilises les outils Linkflare dans une conversation, Claude ouvre une page d'autorisation où tu colles ta clé API Linkflare. Tu trouves ta clé API en cliquant sur ton menu utilisateur (en haut à droite) dans l'application Linkflare et en choisissant Copier la clé API. Une fois autorisé, Claude se souvient de ta connexion.

Étape 5 : Essaie

Démarre une conversation et dis quelque chose comme :

• « Qu'y a-t-il dans ma boîte de réception Linkflare ?"
• « Cherche dans mes favoris les articles sur la productivité"
• « Enregistre https://example.com dans ma liste de lecture"

Claude demande la permission avant d'utiliser un outil pour la première fois.

Configuration : ChatGPT

ChatGPT prend en charge les serveurs MCP distants via les apps ChatGPT et le Developer Mode. Linkflare prend en charge l'authentification OAuth, afin que ChatGPT puisse se connecter en toute sécurité.

Étape 1 : Ouvrir les paramètres de ChatGPT

Va dans Settings → Apps, puis fais défiler jusqu'à Advanced settings et clique sur Create app.

Étape 2 : Créer une nouvelle app

Remplis les éléments suivants :

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

Si ChatGPT demande des détails OAuth supplémentaires :

• Client ID : linkflare-chatgpt
• Client Secret : laisser vide

ChatGPT détecte automatiquement les points de terminaison d'autorisation et de token depuis le serveur MCP.

Étape 3 : Autoriser

La première fois que tu utilises les outils Linkflare dans une conversation, ChatGPT ouvre une page d'autorisation où tu colles ta clé API Linkflare. Tu trouves ta clé API en cliquant sur ton menu utilisateur (en haut à droite) dans l'application Linkflare et en choisissant Copier la clé API. Une fois autorisé, ChatGPT se souvient de ta connexion.

Étape 4 : Tester

Démarre une nouvelle conversation et demande à ChatGPT de « lister mes collections Linkflare" pour vérifier que la connexion fonctionne.

Configuration : VS Code

Utilise le fichier de configuration MCP dans VS Code. OAuth ouvre ton navigateur lors de la première connexion.

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

Configuration : Cursor

Ajoute Linkflare à ~/.cursor/mcp.json ou .cursor/mcp.json. Cursor utilise un callback OAuth fixe et des informations client OAuth statiques.

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

Configuration : Windsurf

Ajoute Linkflare depuis le panneau de configuration MCP ou modifie ~/.codeium/windsurf/mcp_config.json. Si OAuth n'est pas disponible dans ta version, utilise le repli par clé API ci-dessous.

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

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

Configuration : Zed

Ajoute Linkflare comme serveur de contexte personnalisé dans Zed. Quand aucun en-tête Authorization n'est configuré, Zed lance le flux OAuth MCP standard.

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

Repli hérité pour les anciennes versions de Zed ou les clients sans prise en charge native du MCP distant :

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

Détails de connexion

Paramètre	Valeur
URL du point de terminaison	https://mcp.linkflare.io/mcp
Transport	Streamable HTTP
Authentification	Token Bearer via l'en-tête Authorization
En-tête d'auth	Authorization: Bearer YOUR_API_KEY

Alternative : Certains clients utilisent plutôt un en-tête x-api-key. Linkflare accepte les deux.

Outils disponibles

Une fois la connexion établie, les outils suivants sont à la disposition de ton assistant IA. Tu n'as pas besoin de les mémoriser – parle simplement naturellement et l'IA choisit le bon.

Outils de favoris

Outil	Ce qu'il fait
add_link	Enregistrer un favori, en option avec une collection, des tags, des notes et un type
add_links_from_text	Extraire et enregistrer toutes les URL d'un bloc de texte collé
search_links	Rechercher des favoris avec des filtres (texte, collection, tags, type, boîte de réception, note)
get_link	Récupérer tous les détails d'un favori précis
update_link	Mettre à jour le titre, les notes, les tags ou d'autres propriétés d'un favori
delete_link	Supprimer un favori
move_links	Déplacer un ou plusieurs favoris vers une autre collection
rate_link	Noter un favori d'un pouce levé ou baissé
get_inbox	Lister tous les éléments de la boîte de réception

Outils d'organisation

Outil	Ce qu'il fait
list_collections	Voir toutes tes collections sous forme d'arborescence
create_collection	Créer une nouvelle collection
list_tags	Voir tous tes tags
create_tag	Créer un nouveau tag

Outils de connaissances Pro

Les cartes de connaissances sont des notes hiérarchiques en texte riche (pense à Notion / Obsidian) que tu peux relier à tes favoris et réviser par répétition espacée. Ces outils nécessitent un forfait Pro.

Outil	Ce qu'il fait
search_knowledge	Rechercher des cartes de connaissances par mot-clé dans le titre, le contenu et les tags
add_knowledge	Créer une nouvelle carte de connaissances, en option avec contenu, tags, carte parente et couleur
get_knowledge	Récupérer une carte par ID avec son contenu complet et le fil d'Ariane de la carte parente
update_knowledge	Mettre à jour le titre, le contenu, les tags, la carte parente ou la couleur d'une carte
delete_knowledge	Supprimer une carte. Attention : supprime aussi toutes les cartes enfants imbriquées.
list_knowledge_children	Parcourir la hiérarchie – lister les cartes racines ou les cartes enfants d'une carte donnée

Prompts IA

Ce sont des modèles de prompt prêts à l'emploi que ton IA peut utiliser pour des opérations courantes :

Prompt	Ce qu'il fait
organize_inbox	Obtenir des suggestions pour organiser les éléments de ta boîte de réception
summarize_collection	Résumer le contenu d'une collection
find_related	Trouver des favoris sur un sujet précis
weekly_digest	Obtenir un aperçu des favoris enregistrés récemment
suggest_tags	Obtenir des suggestions de tags pour les favoris sans tags
explore_knowledge Pro	Parcourir ta base de connaissances sur un sujet, résumer ce qui a été capturé et mettre en évidence les lacunes

Dépannage

Erreur « Unauthorized" ou « Missing authentication"

Vérifie de nouveau ta clé API. Dans l'application Linkflare, clique sur ton menu utilisateur (en haut à droite) et choisis Copier la clé API pour copier la clé exacte. Assure-toi qu'il n'y a pas d'espaces superflus et que la clé complète est incluse.

Les outils n'apparaissent pas dans Claude Desktop

• Assure-toi d'avoir entièrement quitté Claude Desktop (pas seulement fermé la fenêtre) puis de l'avoir rouvert.
• Vérifie de nouveau que le nom du connecteur est linkflare et que l'URL est exactement https://mcp.linkflare.io/mcp (sans barre oblique finale).
• Vérifie que l'OAuth Client ID dans les Advanced settings est bien réglé sur linkflare-claude.

Aucun résultat lors de la recherche

La recherche est une recherche en texte intégral. Si une requête ne renvoie aucun résultat, essaie des termes plus généraux. Tu peux aussi filtrer par collection, tags ou type plutôt que par texte.

Collection ou tag introuvable

Tu peux utiliser des noms de collections et de tags (pas seulement des ID). La correspondance des noms ne tient pas compte de la casse, donc « recettes" comme « Recettes" fonctionnent tous les deux.

Les outils de connaissances renvoient « Forbidden" ou « Pro plan required"

Les outils de connaissances (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children ainsi que le prompt explore_knowledge) sont réservés aux comptes Pro. Les outils de favoris, de collections et de tags fonctionnent avec le forfait gratuit. Passe à la version supérieure sur la page des tarifs.

J'ai supprimé une carte de connaissances, mais mes cartes enfants ont disparu

delete_knowledge agit en cascade – supprimer une carte parente retire toute carte imbriquée en dessous. Si l'IA propose de supprimer une carte avec des cartes enfants, vérifie bien avant d'accepter. Pour faire le ménage sans perdre les cartes enfants, déplace-les d'abord avec update_knowledge (mets parent_id à 0 pour la racine ou à l'ID d'une autre carte).

Confidentialité et sécurité

Ta clé API identifie ton compte. Le serveur MCP n'accède qu'à tes favoris personnels – il ne peut pas voir les données d'autres utilisateurs. Toute la communication est chiffrée via HTTPS.

L'assistant IA ne voit que ce que tu lui demandes. Il n'a pas d'accès permanent à toute ta bibliothèque, sauf si tu le demandes explicitement.