OSMOzzz/Documentation

Documentation OSMOzzz

OSMOzzz connecte votre client IA à toutes vos données — emails, fichiers, notes, calendrier, outils cloud — 100 % en local. Rien ne quitte votre machine.


Installation

Téléchargez le fichier .pkg et double-cliquez dessus. L'installeur place le binaire dans /usr/local/bin/osmozzz.

  1. Téléchargez la dernière version depuis la page d'accueil ou GitHub Releases.
  2. Double-cliquez sur le fichier osmozzz.pkg et suivez l'installeur.
  3. C'est tout. Le binaire est installé dans /usr/local/bin/osmozzz.

Lancer OSMOzzz

C'est automatique. Le script d'installation enregistre OSMOzzz comme service système — il démarre au login et tourne en arrière-plan sans aucune intervention. Le dashboard s'ouvre dans votre navigateur dès la fin de l'installation.

Accédez au dashboard à tout moment sur http://localhost:7878. C'est depuis là que vous configurez vos connecteurs (Gmail, GitHub, Notion, Jira…).


Clients IA compatibles MCP

MCP (Model Context Protocol) est un protocole ouvert. OSMOzzz fonctionne avec tous les clients IA qui le supportent. Sélectionnez votre client pour obtenir la configuration exacte.

Claude Desktop

Ouvrez ou créez le fichier de configuration de Claude Desktop, ajoutez le bloc mcpServers et relancez l'application.

json~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "osmozzz": {
      "command": "/usr/local/bin/osmozzz",
      "args": ["mcp"]
    }
  }
}

Concepts

C'est quoi MCP ?

Le Model Context Protocol est un standard ouvert créé par Anthropic en 2024. Il définit comment un client IA (Claude, Cursor, Zed…) peut appeler des outils externes — appelés tools MCP — pour accéder à des données ou déclencher des actions.

OSMOzzz agit comme un pare-feu MCP. Il se place entre votre client IA et vos outils cloud — Notion, GitHub, Slack, Gmail, Linear, Jira… Votre client IA ne se connecte jamais directement à ces services : il passe par OSMOzzz, qui centralise les accès, filtre les données sensibles et contrôle ce que l'IA peut voir ou faire.

Confidentialité & contrôle

OSMOzzz intègre quatre systèmes de sécurité indépendants, accessibles depuis le dashboard → Actions MCP.

Flux d'actions

Chaque appel tool de votre client IA est enregistré en temps réel : connecteur utilisé, requête exécutée, résultats retournés, et toutes les transformations de sécurité appliquées. Vous savez exactement ce que votre IA a fait et ce qu'elle a vu, à chaque instant. Vous pouvez également valider manuellement certaines actions avant exécution, et consulter l'historique complet des appels passés.

Sources

Contrôlez l'accès de votre client IA connecteur par connecteur : activez ou désactivez l'accès en un clic, et choisissez si les tools s'exécutent automatiquement ou nécessitent votre validation manuelle avant d'être exécutés.

Confidentialité

Masquez automatiquement les adresses email et numéros de téléphone dans toutes les réponses transmises à votre IA. Configurez des alias d'identité pour remplacer les vrais noms par des pseudonymes — votre IA travaille avec "Collaborateur-A" plutôt qu'avec "Jean Dupont".

Bases de données

Définissez la visibilité de chaque colonne de vos bases SQL colonne par colonne : valeur brute transmise à l'IA, token opaque stable (l'IA peut raisonner dessus sans jamais voir la vraie valeur), ou colonne entièrement bloquée.

Les 705+ tools MCP

OSMOzzz expose 705+ tools à votre client IA via 26 connecteurs cloud. Cliquez sur un connecteur pour voir la liste de ses tools.

ConnecteurTools
Gmail7
GitHub40
GitLab135
Linear17
Jira23
Notion22
Slack50
Supabase30
Sentry27
Cloudflare89
Stripe27
HubSpot26
PostHog18
Discord28
Vercel15
Railway14
Render14
Twilio16
Resend14
Figma15
Google Calendar12
Airtable5
Trello4
Todoist4
n8n22
Shopify31

Stack technique

OSMOzzz est entièrement écrit en Rust — un binaire unique sans runtime, sans Node.js, sans Python. Le dashboard React est embarqué directement dans le binaire.

ComposantTechnologie
LangageRust 2021
Runtime asyncTokio
API REST & dashboardAxum
Dashboard UIReact 18 + TypeScript + Vite
Transport MCPJSON-RPC 2.0 stdin/stdout
Connecteurs natifsreqwest (HTTP direct)
Proxies MCPBun / bunx (subprocesses npm)
Stockage configTOML (~/.osmozzz/*.toml)

Features à venir

Réseau P2P mesh

La prochaine grande fonctionnalité d'OSMOzzz : connecter plusieurs instances entre elles en pair-à-pair. Votre IA pourra interroger les outils d'un collègue — ses emails, son Linear, son Supabase — avec des permissions granulaires définies par chaque pair.

Chaque machine aura une identité cryptographique unique (Ed25519). Toutes les données sortantes passeront par les filtres de confidentialité du propriétaire avant d'être transmises. Le réseau est chiffré de bout en bout via iroh (QUIC).

  1. Permissions granulaires — chaque pair choisit connecteur par connecteur ce qu'il partage : automatique, validation manuelle, ou bloqué.
  2. Confidentialité bout en bout — alias d'identité et filtre de confidentialité appliqués sur toutes les données sortantes avant envoi au pair.
  3. Zéro configuration réseau — connexion via relay chiffré, fonctionne derrière NAT et firewall sans ouvrir de port.