Connecter Intervizio : assistants IA et API

• Votre compte Intervizio (adresse e-mail et mot de passe habituels). Pas de clé API : chaque personne se connecte avec son propre compte.
• Le connecteur activé par votre organisation. Un administrateur l'active une fois pour toutes dans Intervizio (voir Pour les administrateurs). S'il ne l'est pas, l'assistant vous le dira.
• Un ordinateur. La connexion à Intervizio n'est pas possible depuis le navigateur d'un téléphone ; une fois branché, le connecteur fonctionne aussi dans l'application mobile de votre assistant.
• Un abonnement à l'assistant qui autorise les connecteurs personnalisés (selon les offres de Claude, ChatGPT, Le Chat ou Gemini).

Au moment de l'autorisation, l'assistant ouvre une page Intervizio dans votre navigateur. Si vous êtes déjà connecté à Intervizio dans ce navigateur, c'est ce compte-là qui est utilisé, sans vous redemander de mot de passe. Si vous avez déjà autorisé cet assistant une première fois, la page peut même se refermer aussitôt.

1. 1

   Ouvrez Intervizio dans le navigateur que vous utilisez d'habitude

   Regardez en haut à droite quel compte est connecté.

2. 2

   Ce n'est pas le bon compte ?

   Déconnectez-vous (menu de votre profil › Se déconnecter), puis reconnectez-vous avec le bon compte.

3. 3

   Lancez ensuite la connexion depuis l'assistant

   Sur la page d'autorisation, vérifiez la ligne « Compte : votre adresse e-mail » avant de cliquer sur Autoriser.

1. 1

   Ouvrez les connecteurs

   Sur claude.ai (ou dans Claude Desktop) : Paramètres › Connecteurs, puis Ajouter un connecteur personnalisé.

2. 2

   Renseignez le formulaire

   Nom : Intervizio. URL du serveur MCP distant : https://api.intervizio.fr/mcp. Laissez vides les paramètres avancés (identifiant et secret OAuth) : Claude s'enregistre tout seul auprès d'Intervizio.

3. 3

   Cliquez sur Ajouter, puis sur Se connecter

   Une page Intervizio s'ouvre : connectez-vous si besoin, vérifiez le compte affiché, puis cliquez sur Autoriser.

4. 4

   Utilisez-le dans une conversation

   Dans le menu des outils de la conversation, vérifiez que Intervizio est activé, puis posez votre question : « Quelles interventions sont prévues demain ? »

Claude Code (ligne de commande) : ajoutez le serveur, puis tapez /mcp dans Claude Code et choisissez Authenticate : le navigateur s'ouvre sur la même page d'autorisation.

claude mcp add --transport http intervizio https://api.intervizio.fr/mcp

1. 1

   Activez le mode développeur

   Paramètres › Applications et connecteurs › Paramètres avancés › Mode développeur. Dans un espace Business ou Enterprise, un administrateur de l'espace doit d'abord l'autoriser.

2. 2

   Créez le connecteur

   Paramètres › Applications et connecteurs › Créer. Nom : Intervizio. URL du serveur MCP : https://api.intervizio.fr/mcp. Authentification : OAuth. Cochez la case de confiance, puis Créer.

3. 3

   Connectez votre compte

   ChatGPT ouvre la page Intervizio : vérifiez le compte affiché, puis Autoriser.

4. 4

   Utilisez-le

   Dans une conversation, ajoutez Intervizio depuis le menu + (outils / mode développeur), puis posez votre question.

1. 1

   Ouvrez les connecteurs

   Dans Le Chat : Intelligence › Connecteurs › Ajouter un connecteur, onglet Connecteur MCP personnalisé. Dans un espace d'équipe, cette étape peut être réservée à un administrateur.

2. 2

   Renseignez le connecteur

   Nom : Intervizio. URL : https://api.intervizio.fr/mcp. Le Chat détecte seul que la connexion se fait par compte (OAuth).

3. 3

   Connectez votre compte

   Cliquez sur Se connecter, vérifiez le compte affiché sur la page Intervizio, puis Autoriser. Le connecteur passe à l'état actif.

4. 4

   Utilisez-le

   Activez le connecteur Intervizio dans les outils de la conversation. Dans un espace partagé, chaque membre se connecte avec son propre compte.

Gemini CLI (ligne de commande) prend en charge les serveurs MCP distants avec connexion par compte. Ajoutez Intervizio dans ~/.gemini/settings.json, puis tapez /mcp auth intervizio dans Gemini CLI : la page d'autorisation Intervizio s'ouvre dans le navigateur.

{
  "mcpServers": {
    "intervizio": {
      "httpUrl": "https://api.intervizio.fr/mcp"
    }
  }
}

Application Gemini et Gemini Enterprise : si votre offre permet d'ajouter un connecteur ou un serveur MCP personnalisé, saisissez la même adresse (https://api.intervizio.fr/mcp, transport « Streamable HTTP ») et choisissez la connexion par compte (OAuth). Les menus dépendent de votre offre Google ; l'administrateur de votre espace peut devoir l'autoriser.

1. 1

   L'assistant demande l'accès

   La page Intervizio affiche : « Claude (ou ChatGPT…) demande l'accès à votre compte Intervizio », le compte concerné et les informations de profil demandées (identité, adresse e-mail).

2. 2

   Vous autorisez ou refusez

   Autoriser : l'assistant reçoit un jeton d'accès lié à votre compte. Refuser : rien n'est partagé.

3. 3

   L'assistant agit en votre nom, jamais au-delà

   Chaque question passe par Intervizio, qui applique vos droits et les outils ouverts par votre organisation. Votre mot de passe n'est jamais transmis à l'assistant.

• Vos droits, pas plus. L'assistant ne voit que les données que vous voyez dans Intervizio, et chaque action est vérifiée par Intervizio exactement comme dans l'application.
• Les outils de votre métier. Un technicien se voit proposer le démarrage d'intervention et son planning ; un comptable, la préfacturation, les frais et les factures ; un client, ses demandes et ses rapports.
• Ce que votre organisation a ouvert. Les consultations sont ouvertes d'office ; chaque action (créer, modifier, valider…) doit être ouverte par un administrateur, éventuellement pour certains rôles seulement.
• Il confirme avant d'agir. Chaque action est signalée à l'assistant comme modifiant des données réelles : il doit vous demander confirmation avant de l'exécuter.
• Jamais exposés : utilisateurs et rôles, paramètres, clés API, abonnement, suppression définitive, export RGPD, messagerie chiffrée.

1. 1

   Ouvrez le réglage

   Paramètres › Connexions › API & Développeurs, carte Connecteur MCP. Réservé aux administrateurs et à la direction des opérations.

2. 2

   Activez le connecteur

   État du connecteur : Activé. Tant qu'il est désactivé (c'est le cas par défaut), aucun assistant ne peut rien lire ni faire, même avec un compte autorisé.

3. 3

   Choisissez les outils

   Toutes les consultations sont cochées d'office ; les actions sont décochées. Cochez celles que vos équipes peuvent confier à un assistant. Pour une action cochée, cliquez sur un rôle pour la lui retirer (réservation par rôle).

4. 4

   Enregistrez

   Le réglage s'applique dès l'appel suivant de chaque assistant. Le journal en bas de la carte montre les derniers appels (outil, statut, durée — jamais les données).

• Depuis l'assistant (recommandé) : Claude › Paramètres › Connecteurs › Intervizio › Déconnecter ; ChatGPT › Paramètres › Applications et connecteurs › Intervizio ; Le Chat › Intelligence › Connecteurs. Pour Claude Code : claude mcp remove intervizio.
• Pour toute l'organisation : un administrateur désactive le connecteur (voir ci-dessus).
• Se déconnecter d'Intervizio ne déconnecte pas l'assistant : depuis la version du 12/10/2026, la déconnexion ne ferme que la session de l'appareil utilisé.

https://api.intervizio.fr/mcp

claude mcp add --transport http intervizio https://api.intervizio.fr/mcp --header "Authorization: Bearer iv_live_..."

Protocole : MCP, transport « Streamable HTTP », sans état. Autorisation : OAuth 2.1 (découverte par les métadonnées de ressource protégée, RFC 9728, annoncées dans l'en-tête WWW-Authenticate d'une réponse 401). Listes paginées : limit (1 à 50, 20 par défaut) et cursor (valeur next_cursor de la page précédente). Limites : 300 appels par minute et par adresse IP, 120 par utilisateur ou par clé, 20 actions par minute.

Avec une clé API d'organisation, seuls ces outils sont disponibles : search_demandes, get_demande, create_demande, search_interventions, get_intervention, get_report_documents, get_planning, list_technicians. La clé doit porter la ressource correspondante (et l'opération Création pour create_demande). Une clé dédiée à un client (fiche d'intégration) n'est pas acceptée par le connecteur.

1. 1

   Créez une clé de démonstration

   Paramètres › Connexions › API & Développeurs › Générer une clé, type Démo (détails).

2. 2

   Appelez la racine de l'API

   La réponse confirme que la clé fonctionne et indique ses autorisations.

3. 3

   Passez en Live

   Une fois l'intégration au point, créez une clé Live et révoquez la clé de démonstration.

curl -i -H "x-api-key: iv_test_VOTRE_CLE" https://api.intervizio.fr/v1

{
  "name": "InterVizio API",
  "version": "v1",
  "mode": "test",
  "organization_id": "7d0e…",
  "scopes": [
    "*"
  ],
  "operations": [
    "read"
  ],
  "resources": [
    "interventions",
    "demandes",
    "clients",
    "sites",
    "invoices",
    "prebillings",
    "contracts",
    "extra-costs",
    "projects",
    "ratings",
    "shipments",
    "subcontractors",
    "team"
  ],
  "writable": [
    "clients",
    "sites",
    "demandes",
    "interventions"
  ],
  "special": [
    "stats",
    "clients/{id}/statement"
  ]
}

• Qui : un administrateur de l'organisation, avec la double authentification (2FA) activée (Paramètres › Sécurité). Chaque création et chaque révocation demande le code à 6 chiffres.
• Où : Paramètres › Connexions › API & Développeurs › Générer une clé.
• Type : Démo (iv_test_…, listes plafonnées à 10 résultats, demandes créées sans prévenir la coordination) ou Live (iv_live_…, données réelles).
• Ressources : accès complet, ou seulement certaines ressources (dont Statistiques pour /stats).
• Opérations : Lecture (toujours incluse), Création, Modification.
• Expiration : facultative, mais une clé vaut 12 mois au plus ; sans date choisie, elle expire au bout de 12 mois. Prévoyez son remplacement.

Chaque requête porte la clé dans l'en-tête x-api-key (recommandé) :

x-api-key: iv_live_VOTRE_CLE

L'en-tête Authorization: Bearer … est aussi accepté ; si les deux sont présents, x-api-key l'emporte. La clé ne se passe jamais dans l'URL.

Authorization: Bearer iv_live_VOTRE_CLE

Toutes les ressources se lisent. La colonne « Filtre status » indique si le paramètre ?status= s'applique ; « Écriture » si la ressource se crée et se modifie.

La suppression n'est pas exposée. Les statistiques et relevés sont décrits dans Lecture.

Chaque liste renvoie pagination : limit et offset appliqués, total (nombre total de lignes) et capped (vrai avec une clé Démo, plafonnée). Avancez de offset += data.length jusqu'à atteindre total. Les lignes sont triées de la plus récente à la plus ancienne : une ligne créée pendant le parcours décale les suivantes, lisez donc vite ou dédoublonnez par id.

// Lire toutes les interventions, page par page (200 au plus par page).
const base = "https://api.intervizio.fr/v1/interventions";
const enTetes = { "x-api-key": process.env.INTERVIZIO_API_KEY };
let offset = 0, toutes = [];
for (;;) {
  const r = await fetch(`${base}?limit=200&offset=${offset}`, { headers: enTetes });
  if (r.status === 429) { await new Promise((ok) => setTimeout(ok, 60_000)); continue; }
  if (!r.ok) throw new Error(`${r.status} ${(await r.json()).error}`);
  const { data, pagination } = await r.json();
  toutes = toutes.concat(data);
  offset += data.length;
  if (data.length === 0 || offset >= pagination.total) break;
}

import os, requests

r = requests.get(
    "https://api.intervizio.fr/v1/interventions",
    headers={"x-api-key": os.environ["INTERVIZIO_API_KEY"]},
    params={"limit": 10, "status": "completed"},
    timeout=30,
)
r.raise_for_status()
print(r.json()["data"])

Tout autre champ du corps est ignoré. Le corps est un objet JSON (Content-Type: application/json).

curl -X POST -H "x-api-key: iv_live_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"name":"Nouveau client","city":"Paris","email":"contact@client.example"}' \
  "https://api.intervizio.fr/v1/clients"

{
  "data": {
    "id": "3f6c2a9e-8b1d-4c7a-9e2f-5a1b7c0d4e21",
    "name": "Nouveau client",
    "city": "Paris",
    "email": "contact@client.example"
  }
}

curl -X PUT -H "x-api-key: iv_live_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{"phone":"0102030405"}' \
  "https://api.intervizio.fr/v1/clients/3f6c2a9e-8b1d-4c7a-9e2f-5a1b7c0d4e21"

Une demande créée par l'API arrive non attribuée : statut pending (toute autre valeur à la création : 400 ; il se modifie ensuite par PUT), mention « Reçue par l'API ». La coordination est prévenue par e-mail et dans l'application — sauf avec une clé Démo, et au-delà de 10 demandes en une minute pour l'organisation (les suivantes restent dans la liste et au journal).

• external_ref — votre référence (1 à 200 caractères), unique par client. Idempotence : un POST qui répète une référence connue ne crée rien et renvoie 200 avec la demande existante et "idempotent": true ; la référence est cherchée avant tout autre contrôle.
• contract_id — un contrat de ce client (sinon 400) ; il détermine le modèle de rapport du technicien.
• checklist — vos points à contrôler, posés au technicien en tête de son questionnaire de clôture : { key, label, type, required?, help?, options?, show_if? } ; types text, textarea, number (min, max, unit), yes_no, choice et multi_choice (options { value, label }), date (AAAA-MM-JJ), time (HH:MM), section. Clés en minuscules [a-z0-9_], préfixées dem_ si besoin. En PUT, la liste est remplacée entière (null ou [] la vide) ; après une première réponse du technicien, elle ne se modifie plus (409). 100 questions et 64 Ko au plus.

curl -X POST -H "x-api-key: iv_live_VOTRE_CLE" -H "Content-Type: application/json" \
  -d '{
    "title": "Remplacement du routeur — magasin de Caen",
    "client_id": "{client_id}",
    "contract_id": "{contract_id}",
    "external_ref": "TICKET-2026-0415",
    "priority": "high",
    "requested_date": "2026-10-20",
    "checklist": [
      { "key": "etat_baie", "label": "État de la baie", "type": "choice", "required": true,
        "options": [ { "value": "ok", "label": "Conforme" }, { "value": "ko", "label": "Non conforme" } ] },
      { "key": "detail_baie", "label": "Détail de la non-conformité", "type": "textarea",
        "show_if": { "key": "etat_baie", "op": "eq", "value": "ko" } },
      { "key": "photos_faites", "label": "Photos avant / après réalisées ?", "type": "yes_no", "required": true }
    ]
  }' \
  "https://api.intervizio.fr/v1/demandes"

{
  "error": "Points à contrôler invalides.",
  "details": [
    {
      "code": "options_missing",
      "key": "dem_etat_baie"
    },
    {
      "code": "show_if_forward",
      "key": "dem_detail_baie"
    }
  ]
}

Une fiche d'intégration client (Paramètres › Connexions › Intégrations) peut porter sa propre clé, créée par un administrateur ou la direction des opérations (2FA exigée). Elle ne lit, ne crée et ne modifie que les demandes, interventions et sites de ce client : toute autre ressource, ou une ligne d'un autre client, renvoie 403 ; les colonnes internes (coûts, marges, personnel, sous-traitant…) sont retirées des réponses. Elle ne fonctionne pas avec le connecteur MCP, et cesse de fonctionner si le client quitte l'organisation. En recréer une révoque la précédente.

Une erreur renvoie { "error": "…" } (message en français) avec le code HTTP :

• 120 requêtes par minute et par clé (fenêtre glissante d'une minute).
• 300 requêtes par minute et par adresse IP, contrôlées avant même la clé (frein aux essais de clés).
• Pages de 200 lignes au plus (10 avec une clé Démo).

Au-delà : 429. Attendez 60 secondes avant de réessayer, puis espacez les appels (l'en-tête Retry-After n'est pas toujours transmis par le relais api.intervizio.fr).

• Une clé par intégration, nommée clairement (« ERP comptable », « Export Power BI ») : vous saurez laquelle révoquer.
• Le moins de droits possible : seulement les ressources utiles, Lecture seule si l'intégration n'écrit pas.
• Démo d'abord, Live ensuite.
• Rangez la clé dans un coffre de secrets ou une variable d'environnement, jamais dans le code, un e-mail ou un tableur partagé.
• Rotation avant l'échéance (12 mois au plus) : créez la nouvelle clé, déployez-la, vérifiez son « Dernier usage », puis révoquez l'ancienne.
• Clé exposée ou personne partie : révoquez immédiatement (icône corbeille + code 2FA) ; l'effet est instantané.
• Surveillez « Dernier usage » dans la liste : une clé inutilisée se révoque, un usage inattendu se signale.

Commencez par l'appel de vérification, qui affiche le code et le message exacts :

curl -i -H "x-api-key: VOTRE_CLE" https://api.intervizio.fr/v1