Argos — Connecteur SharePoint on-premise pour agents IA (MCP)

Argos indexe vos sites SharePoint on-premise (2013 → Subscription Edition) et met leurs documents à disposition de vos agents IA via un serveur MCP (Model Context Protocol). Un dashboard web permet de piloter les connexions, le traitement des documents et les accès.

Support : pour toute question, contactez support-it@devana.ai

✨ Fonctionnalités

• Synchronisation SharePoint : arborescence et métadonnées de chaque bibliothèque et des pages SharePoint, périmètre par dossiers, filtres de métadonnées, synchronisation incrémentale (seules les modifications sont relues).
• Authentification SharePoint : NTLM, Kerberos (keytab), Basic, avec certificat d'autorité interne.
• Extraction du contenu : texte, tableaux et images des documents (PDF, Office, pages SharePoint…) par Odin, en deux passes :
  • rapide pour tout le périmètre ;
  • complète (OCR et description des images) ensuite, bridée pour que les demandes des utilisateurs restent prioritaires.
• Lecture à la demande : un document jamais traité, demandé par un agent, est extrait immédiatement en priorité.
• Recherche : plein texte, similarité de noms, recherche sémantique et graphe de connaissances (personnes, entreprises, projets…).
• Serveur MCP : outils de navigation, de lecture, de recherche et de comparaison, utilisables par Devana et tout client MCP (Claude, Cursor, VS Code, SDK…).
• Accès maîtrisés :
  • clés API dédiées par application ;
  • espaces MCP limités à certains sites ou dossiers, pour des agents aux droits restreints.
• Supervision : métriques de performance et de synchronisation dans le dashboard, sondes de santé, métriques Prometheus.

🏗️ Architecture

                         Utilisateurs (navigateur)          Agents IA (clients MCP)
                                    │  HTTPS                        │  HTTPS + clé API
                                    ▼                               ▼
                    ┌───────────────────────────────────────────────────────────┐
                    │  Reverse proxy / Ingress   (/ → dashboard, /mcp /graphql /auth → API)
                    └───────────────────────────────────────────────────────────┘
                          │                              │
                   ┌─────────────┐   ┌──────────────────────────────────┐
                   │  Dashboard  │──▶│  API Argos                        │──▶ Devana (connexion OAuth)
                   │ (front-end) │   │  dashboard · serveur MCP          │
                   └─────────────┘   └──────────────────────────────────┘
                                                  │
     SharePoint on-premise ◀── REST ──  ┌──────────────────────────────────┐
     (NTLM · Kerberos · Basic)          │  Workers Argos (×N)               │──▶ Modèles LLM
                                        │  synchronisation · traitements    │    (graphe, embeddings)
                                        └──────────────────────────────────┘
                                          │            │             │
                                    PostgreSQL       Redis         Stockage S3
                                    (pgvector)     (dédié)        (bucket unique)
                                                       │             │
                                        ┌──────────────────────────────────┐
                                        │  Odin + Zeus (instance dédiée)    │──▶ Modèle de vision
                                        │  extraction du contenu            │
                                        └──────────────────────────────────┘

⚠️ Odin et Redis doivent être dédiés à Argos. Argos et Odin échangent par des files de traitement dans Redis. Une instance Odin, ou un Redis, partagée avec une plateforme Devana mélangerait les demandes des deux services.

✅ Prérequis

Accès

• Registre d'images : identifiants pour registry.devana.ai, fournis par Devana.
• Plateforme Devana : un client OAuth pour la connexion au dashboard (voir Configuration).
• SharePoint : un compte de service ayant un accès en lecture aux sites à indexer (voir Connexions SharePoint).
• Modèles LLM (API compatible OpenAI, cloud ou auto-hébergée) :
  • un modèle de vision pour Zeus ;
  • optionnellement, un modèle de chat (graphe de connaissances) et un modèle d'embeddings (recherche sémantique), configurés dans le dashboard.

Ressources indicatives

Pour une installation sur un seul serveur (Docker Compose) : 4 vCPU, 16 Go de RAM, disque dimensionné selon le volume à indexer.

Réseau

🚀 Installation

Après l'installation :

1. Première connexion : le premier utilisateur connecté (ou ceux listés dans BOOTSTRAP_ADMIN_EMAILS) devient administrateur.
2. Modèles LLM : Paramètres › Modèles (LLM).
3. Connexions SharePoint : Connexions SharePoint › Nouvelle connexion, puis Tester la connexion et Synchronisation complète.
4. Agents : créez une clé API MCP et connectez vos agents (voir Serveur MCP).

📚 Documentation par section

• Installation Docker Compose : installation sur un serveur
• Installation Kubernetes / OpenShift : manifestes, exposition, mise à l'échelle
• Configuration : variables d'environnement, OAuth Devana, réglages du dashboard
• Connexions SharePoint : authentification (NTLM, Kerberos, Basic), périmètre, métadonnées
• Serveur MCP : clés API, espaces, configuration des clients, outils
• Exploitation : supervision, sauvegardes, mises à jour, dépannage