API v1 · MCP · Webhooks disponibles

Vos réunions, transcriptions et synthèses partout où vous en avez besoin.

L'API Gilbert donne accès en lecture et en écriture à toutes vos données : réunions, participants, transcriptions, synthèses, action items. Intégrez-les à votre CRM, Notion, Slack, Zapier, votre data warehouse, ou à Claude et Cursor — en quelques minutes, sans développement lourd.

Découvrir l'API REST Connecteurs IA (MCP)Demander une clé API →

base_url=https://gilbert-assistant.ovh/api/v1

Vue d'ensemble

L'API Gilbert, concrètement ?

Une API, c'est une porte d'entrée qui permet à d'autres outils (votre CRM, Zapier, Claude…) de lire vos données Gilbert automatiquement, sans que quelqu'un ait besoin de copier-coller. Ce que vous voyez dans l'app Gilbert est disponible via l'API au même instant, au format machine (JSON).

Réunions enregistréesAudio + métadonnées

TranscriptionsTexte avec locuteurs

SynthèsesMarkdown + action items

CoreAPI Gilbertv1 · REST · OpenAPI 3gilbert-assistant.ovh/api/v1

CRM / ERPSalesforce, HubSpot, Pipedrive…

Assistants IAClaude, ChatGPT, Cursor…

AutomatisationsZapier, Make, n8n, Slack…

Pas besoin d'être développeur pour commencer. Des outils comme Zapier ou Make permettent de connecter Gilbert à Slack, Notion ou votre CRM en glisser-déposer. L'API est là quand vous voulez aller plus loin.

Cas d'usage

Ce que vous pouvez faire.

Quelques scénarios concrets, du plus simple (no-code, 10 min) au plus avancé (dev sur mesure). Chaque carte indique la méthode utilisée : REST APIMCPWebhook

Synchroniser chaque rendez-vous client dans Salesforce

À la fin d'une réunion, créer automatiquement une note dans la fiche du compte avec la synthèse et les action items.

WebhookREST API

Poster les synthèses dans un canal Slack

« Synthèse de la réunion produit » envoyée dans #produit-weekly dès que la transcription est prête.

Webhook

Créer une page Notion par réunion

Titre, date, participants, synthèse et transcript dans une page dédiée. Organisation par base de données.

REST API

Interroger ses réunions depuis Claude

« Résume-moi ma réunion de lundi avec Acme », « Trouve toutes les réunions où on a parlé de budget ».

MCP

Alimenter un data warehouse

Chaque réunion poussée dans BigQuery / Snowflake pour analyses : temps passé, sujets récurrents, NPS.

WebhookREST API

Automatiser sans coder (Zapier, Make, n8n)

« Quand une réunion est transcrite → envoie-moi un email + crée une tâche Asana + ajoute la ligne Google Sheets. »

Webhook

Archivage dans votre SI interne

Stockage long terme, GED, DMS juridique ou médical. Extraction automatique des métadonnées RGPD.

REST API

Recherche transverse dans vos réunions

Moteur de recherche interne sur toutes les réunions de l'équipe, avec aperçu du contexte.

REST API

Accès

Trois façons d'accéder à vos données.

Selon votre besoin et votre profil technique. L'API REST est le socle commun — les deux autres sont des raccourcis pour des usages particuliers.

Le socle commun

API REST v1

La méthode la plus flexible. Toutes vos données accessibles via des requêtes HTTP standard, depuis n'importe quel langage ou outil no-code. Documentation OpenAPI 3.

Pour : dev sur mesure, CRM, data warehouse, Zapier/Make/n8n
Authentification : clé API Bearer
Format : JSON, OpenAPI 3 complet
SDKs : générables en 5 min via Stainless / openapi-generator

Voir la doc API →

Pour les agents IA

Connecteurs MCP

Plug-and-play pour Claude, ChatGPT, Cursor. Vos réunions deviennent interrogeables en langage naturel directement depuis l'assistant. 3 sous-options selon le client.

Gilbert Connect — OAuth 1-clic pour claude.ai
MCP Hosted — endpoint HTTP avec Bearer
gilbert-mcp — package npm stdio local

Choisir un connecteur →

Temps réel · push

Webhooks

À l'inverse de l'API REST (vous allez chercher les données), les webhooks vous notifient dès qu'un événement survient : réunion terminée, transcription prête…

Événements : meeting.completed, meeting.failed
Signature HMAC-SHA256 pour la sécurité
Retry automatique avec backoff exponentiel
Idéal pour Zapier, Make, n8n, Slack bot

Voir les webhooks →

API REST v1

Le cœur de la plateforme.

Une API REST standard, documentée via OpenAPI 3. Authentification par clé API Bearer, réponses JSON, pagination, filtres, rate limiting par tier. Toute l'app Gilbert (web & mobile) utilise cette API.

Documentation interactive (Swagger)ReDoc openapi.json Premier appel en 30s →

URL de base

Un seul endpoint racine

Toutes les requêtes partent de cette URL :

https://gilbert-assistant.ovh/api/v1

Authentification

Header Authorization Bearer

Chaque requête porte votre clé API :

Authorization: Bearer glbrt_live_XXXX

Niveaux d'accès — scopes

Chaque clé API est émise avec un ou plusieurs scopes (permissions). Les endpoints vérifient le scope avant d'accepter la requête — une clé meetings:read ne peut pas supprimer de réunions, même si l'utilisateur est admin.

Scope	Ce que ça permet	Tier requis
`meetings:read`	Lire réunions, transcriptions, synthèses. Rechercher.	Free+
`meetings:write`	Éditer titre, description, dossier, noms des locuteurs.	Pro+
`meetings:upload`	Uploader un fichier audio pour transcription depuis l'API.	Pro+
`meetings:delete`	Supprimer des réunions.	Enterprise
`webhooks:manage`	Créer, modifier, supprimer des webhooks.	Free+ (quota par tier)
`admin:read`	Lecture des métadonnées de l'organisation (membres, quotas).	Enterprise

Endpoints principaux

Liste non exhaustive. Pour la référence complète (paramètres, schémas de réponse, codes d'erreur), consultez la documentation OpenAPI interactive.

Réunions· gestion des enregistrements et métadonnées

GET
/meetingsListe paginée avec filtres (status, date, dossier).
meetings:read
GET
/meetings/{id}Détail complet d'une réunion.
meetings:read
POST
/meetings/uploadUpload un fichier audio (mp3/m4a/wav/webm) pour transcription.
meetings:upload
PATCH
/meetings/{id}Édite titre, description, dossier, tags.
meetings:write
PUT
/meetings/{id}/speakersRenomme les locuteurs (Speaker 1 → Jean Dupont).
meetings:write
DELETE
/meetings/{id}Supprime définitivement une réunion.
meetings:delete

Contenu· transcriptions, synthèses, recherche

GET
/meetings/{id}/transcriptTranscription texte seule, formatée avec locuteurs préfixés.
meetings:read
GET
/meetings/{id}/summarySynthèse markdown structurée (décisions, action items, participants).
meetings:read
GET
/searchRecherche full-text avec snippets highlighted (PostgreSQL FTS).
meetings:read

Organisation· dossiers, partages, membres

GET
/foldersListe vos dossiers et ceux partagés avec vous.
meetings:read
POST
/meetings/{id}/sharePartage une réunion avec un autre membre.
meetings:write
GET
/organization/membersListe des membres de l'organisation (admin uniquement).
admin:read

Webhooks· notifications temps réel

GET
/webhooksListe vos webhooks actifs.
webhooks:manage
POST
/webhooksCrée un webhook (URL + événements + secret).
webhooks:manage
DELETE
/webhooks/{id}Supprime un webhook.
webhooks:manage

Liste exhaustive et schémas JSON : la documentation OpenAPI liste tous les endpoints, paramètres de requête, exemples de réponse et codes d'erreur. Vous pouvez tester directement depuis le navigateur (bouton « Try it out »).

Quickstart

Premier appel en 30 secondes.

Obtenez une clé API (scope meetings:read) auprès de votre administrateur Gilbert, puis choisissez votre langage.

terminal.sh

# Lister les 50 dernières réunions terminées
curl -s "https://gilbert-assistant.ovh/api/v1/meetings?status=completed&per_page=50" \
  -H "Authorization: Bearer glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX"

Pas de SDK officiel ? Normal. L'API suit strictement OpenAPI 3. Des outils comme Stainless ou openapi-generator génèrent un SDK Python, TypeScript, Go, Java, Swift… en 5 minutes depuis notre spec.

Webhooks

Le push temps réel.

À l'inverse de l'API REST où vous allez chercher les données, un webhook vous les pousse dès qu'un événement survient. Idéal pour déclencher Slack, Zapier, ou votre SI interne sans polling.

Comment ça marche

Vous fournissez à Gilbert une URL https://votre-app.fr/webhooks/gilbert et choisissez les événements à écouter. Dès qu'un événement survient, Gilbert envoie un POST JSON à votre URL.

meeting.completed — transcription prête
meeting.failed — erreur de transcription
meeting.updated — édition manuelle
share.received — réunion partagée avec vous

Sécurité

Chaque POST est signé avec HMAC-SHA256. Le secret est généré à la création du webhook et affiché une seule fois. Vérifiez la signature via le header X-Gilbert-Signature.

Retry automatique avec backoff (5s, 30s, 2 min, 10 min)
Désactivation après 10 échecs consécutifs
Logs des livraisons visibles dans l'admin

Exemple de payload — meeting.completedPOST

{
  "event": "meeting.completed",
  "timestamp": "2026-04-19T14:32:10Z",
  "data": {
    "meeting_id": "mtg_01H...",
    "title": "Point commercial Acme",
    "duration_seconds": 1847,
    "participants_count": 4,
    "transcript_available": true,
    "summary_available": true,
    "url": "https://gilbert-assistant.ovh/meetings/mtg_01H..."
  }
}

Connecteurs IA

Model Context Protocol (MCP).

Au-dessus de l'API REST, Gilbert expose un serveur Model Context Protocol qui rend vos réunions interrogeables en langage naturel depuis Claude, ChatGPT (bientôt), Cursor et Continue. Trois manières de vous y connecter, selon votre client IA.

Utilisateur final

Gilbert Connect

Connecteur OAuth 1-clic pour claude.ai. Aucune clé à gérer, consent UI natif.

Installation claude.ai →

Développeur IA

MCP Hosted (HTTP)

Endpoint distant JSON-RPC 2.0 avec clé API Bearer. Claude Desktop, Cursor, Continue.

Config Claude Desktop →

Installation locale

gilbert-mcp (stdio)

Package npm publié sur le registre MCP. Exécution locale via npx.

Installation npm →

Gilbert Connect — OAuth 1-clic

Gilbert Connect

Pour les utilisateurs de claude.ai

OAuth 2.1PKCE S256Dynamic Client Registration

URL du connecteur MCP à coller dans claude.ai :

https://gilbert-assistant.ovh/api/mcp

Claude.ai détecte le flow OAuth via /.well-known/oauth-protected-resource. L'utilisateur se connecte à Gilbert via une fenêtre pop-up, autorise, et c'est fini — aucune clé à copier-coller.

Futurs connecteurs prévus

ChatGPT custom GPT · Cursor native auth · Continue MCP. Même endpoint OAuth pour tous.

1claude.ai → Paramètres → Connectors → Add custom connector
2Collez l'URL https://gilbert-assistant.ovh/api/mcp
3Cliquez Connect. Une fenêtre Gilbert s'ouvre (login + consent).
4Autorisez l'accès. Une clé API OAuth MCP apparaît dans votre admin.
5Posez vos questions — les tools apparaissent dans la conversation.

MCP Hosted — endpoint HTTP

MCP Hosted

Pour les clients MCP HTTP

HTTP · StreamableAuth : BearerJSON-RPC 2.0

Endpoint :

https://gilbert-assistant.ovh/api/mcp

Envoyez directement vos requêtes JSON-RPC. Aucun process local, pas de Node.

Claude Desktop (config « url »)
Cursor / Continue (HTTP transport)
MCP Inspector (debug officiel)
curl / fetch / httpx

claude_desktop_config.json

{
  "mcpServers": {
    "gilbert": {
      "url": "https://gilbert-assistant.ovh/api/mcp",
      "headers": {
        "Authorization": "Bearer glbrt_live_VOTRE_CLE"
      }
    }
  }
}

gilbert-mcp — package npm local

gilbert-mcp

Installation locale stdio

npm · gilbert-mcp GitHub MCP RegistryMIT · v1.0.2

Le binaire gilbert-mcp est un serveur MCP stdio, pas une CLI. Il est spawné par le client IA (Claude, Cursor) et communique via stdin/stdout en JSON-RPC.

Package npm uniquement. pip install gilbert-mcp ne marche pas. Les devs Python utilisent directement l'API REST v1.

claude_desktop_config.json

{
  "mcpServers": {
    "gilbert": {
      "command": "npx",
      "args": ["-y", "gilbert-mcp"],
      "env": {
        "GILBERT_API_KEY": "glbrt_live_VOTRE_CLE"
      }
    }
  }
}

Les 5 tools exposés

list_meetings · get_meeting · get_transcript
get_summary · search_meetings

Tarifs API

Tiers et quotas.

Chaque clé API est rattachée à un tier qui détermine ses quotas et les fonctionnalités accessibles.

Fonctionnalité	Free	Pro	Enterprise
Requêtes / minute	30	60	300
Requêtes / jour	1 000	5 000	50 000
Lecture meetings / transcripts / summaries
Recherche full-text
Connecteurs MCP (Connect / Hosted / Local)
Webhooks	1 max	5 max	Illimité
Upload audio via API	—	600 min/jour · 500 MB/fichier	10 000 min/jour · 2 GB/fichier
Édition (titre, dossier, locuteurs)	—
Suppression de réunions	—	—
SLA & support prioritaire	—	—

ready to ship

Prêt à intégrer Gilbert ?

Une question, besoin d'une clé API, ou envie d'explorer une intégration sur mesure — on vous répond.

Demander une clé API Lire la documentation

Gilbert API · v1 · MCP · OAuth 2.1 · gilbert-mcp v1.0.2