← Documentation

Connecteurs

retriv s'intègre à vos outils existants via trois connecteurs. Vos documents restent là où ils sont — retriv vient les lire.


Google Drive

Synchronisation automatique de vos fichiers Drive vers retriv. À chaque modification dans le dossier sélectionné, retriv réindexe automatiquement le fichier concerné en quelques minutes.

Formats supportés : PDF, Google Docs (export auto), Word (.docx), Markdown, TXT

Comment connecter :

  1. Depuis l'interface retriv, cliquez Connecter Google Drive
  2. Autorisez retriv (lecture seule sur votre Drive)
  3. Sélectionnez le dossier à synchroniser
  4. Cliquez Lancer la synchronisation

retriv enregistre un webhook Google Push — les mises à jour sont événementielles, pas par polling. Latence maximale : ~1 minute.

Permissions demandées :

  • drive.readonly — lecture seule, jamais d'écriture
  • userinfo.email — identification du compte

GitHub

Indexation automatique de votre code à chaque commit.

Comment connecter :

  1. Ajoutez un webhook dans votre repo GitHub : Settings → Webhooks
  2. URL : https://retriv.run/api/webhook/github
  3. Content type : application/json
  4. Événement : push uniquement
  5. Ajoutez votre GITHUB_WEBHOOK_SECRET dans les settings retriv

À chaque push, retriv réindexe uniquement les fichiers modifiés dans le commit. Le corpus cible est défini par la variable CODE_CORPUS_ID dans votre configuration.


Claude MCP

retriv s'intègre nativement dans claude.ai via le protocole MCP (Model Context Protocol). Claude peut interroger vos corpus directement depuis l'interface de chat, sans copier-coller, sans quitter la conversation.

Configuration :

  1. Dans claude.ai → Settings → Integrations
  2. Cliquez Add integration
  3. URL : https://retriv.run/api/mcp
  4. Autorisez via OAuth — retriv ne reçoit jamais votre mot de passe Claude
  5. Approuvez les 5 tools dans la liste des autorisations

Tools disponibles :

ToolDescription
list_corpusListe tous vos corpus avec métadonnées
search_corpusRecherche sémantique dans un corpus
chat_corpusQuestion avec réponse synthétisée et sources
search_categoryRecherche dans tous les corpus d'une catégorie
get_ontologyRécupère les entités et relations Neo4j d'une catégorie

Exemple d'usage depuis Claude :

"Recherche dans retriv la catégorie Technique tout ce qui concerne le GraphRAG"

"Dans mon corpus CV, quelles compétences correspondent à l'offre Evaneos ?"


Upload direct

Pour les fichiers ponctuels sans connecteur permanent.

Formats : PDF, Markdown (.md), TXT, JSON Taille max : 25 MB (STARTER) · 100 MB (PRO) OCR : automatique sur les PDFs scannés (STARTER et +)

Glissez-déposez vos fichiers dans la zone d'upload de l'interface. Choisissez la catégorie et le corpus cible, puis cliquez Indexer.


Ontologie (GraphRAG)

Un type spécial de dépôt — pas du contenu à chercher, mais un référentiel de relations.

Créez un fichier markdown naturel décrivant vos entités et leurs liens, puis sélectionnez Ontologie au lieu de Corpus lors de l'upload.

retriv extrait automatiquement les entités et relations via LLM, les stocke dans Neo4j, et les croise avec les chunks Qdrant à chaque requête.

→ Voir Ontologie pour le détail.