Assistants IA

Ce que peut faire un assistant

Connecté à votre compte, un assistant travaille sur vos projets à votre demande. Il appelle les outils ci-dessous et vous dit ce qu'il a fait ; vous ne tapez jamais vous-même le nom d'un outil. Il ne peut ni modifier votre compte, vos utilisateurs ou votre facturation, ni supprimer de projets.

Ce qu'il vous faut

Un compte pvSpline avec une formule active.

Celui avec lequel vous vous connectez à l'application web. L'assistant travaille dans ce compte, avec ses projets et ses quotas mensuels : le temps moteur de ses simulations et le temps d'API cloud de ses requêtes. Pas encore de compte ? Se connecter explique comment en créer un, et Les formules et ce qu'elles débloquent présente les formules.

Les assistants IA activés pour votre société.

Une nouvelle société démarre avec les assistants désactivés ; un compte Direction les active (Activer les assistants pour votre société).

Un ordinateur en France.

pvSpline n'accepte que les connexions depuis la France : l'assistant doit donc tourner sur votre ordinateur, en France.

Activer les assistants pour votre société

Les assistants IA doivent d'abord être activés pour votre société. Un compte Direction les active, pour tous les membres à la fois, en cochant Assistants IA dans la carte Jetons de service, sous la case serveur et CI ; la carte indique alors ce qu'un assistant transmet à son fournisseur et quelle offre choisir chez ce dernier. Une nouvelle société démarre avec les assistants désactivés. Tant qu'ils le restent, la page de consentement refuse de connecter un assistant, et un assistant déjà connecté, ou qui utilise un jeton d'assistant, est refusé jusqu'à leur réactivation.

Les autres membres voient dans quel sens l'interrupteur est placé. Le décocher demande d'abord confirmation : tout assistant connecté au compte d'un collègue cesse de fonctionner. Les connexions sont conservées et refonctionnent dès que les assistants sont réactivés.

Brancher un assistant

Tous les clients prennent la même adresse de serveur :

https://api.pvspline.fr/mcp

L'entrée de votre client (L'entrée de votre client) donne cette adresse et rien d'autre : la première fois que l'assistant appelle pvSpline, il vous demande de vous connecter.

Chaque connexion apparaît ensuite dans Jetons de service, au nom de l'assistant suivi de (OAuth) ; Révoquer la déconnecte. L'accès dure une heure et se renouvelle de lui-même tant que l'assistant s'en sert, et une connexion inutilisée pendant 90 jours vous redemande de vous connecter. Une connexion compte dans votre limite de jetons actifs ; à la limite, la page répond Votre compte a trop de jetons actifs. Révoquez-en un dans Compte → Jetons de service, puis réessayez.

L'entrée de votre client

Les commandes et les fichiers de configuration sont les mêmes dans toutes les langues.

Claude Code.

Une commande dans un terminal, puis /mcp dans Claude Code pour vous connecter :

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

Cursor, Windsurf et les autres clients à fichier mcpServers.

Ajoutez l'entrée pvspline au fichier :

{
  "mcpServers": {
    "pvspline": {
      "url": "https://api.pvspline.fr/mcp"
    }
  }
}

VS Code.

Dans le fichier .vscode/mcp.json de l'espace de travail :

{
  "servers": {
    "pvspline": {
      "type": "http",
      "url": "https://api.pvspline.fr/mcp"
    }
  }
}

La page de consentement (/oauth/consent)

La page qu'ouvre l'assistant vous pose la question avant toute connexion : quel assistant demande l'accès, pour quel compte, où va ensuite votre navigateur, et ce que l'assistant pourra et ne pourra pas faire. Avant Autoriser, elle indique aussi ce que reçoit le fournisseur de l'assistant et ce que pvSpline ne lui transmet jamais (Les données de vos clients).

Un assistant qui ne sait pas s'identifier

Pour un assistant qui ne sait pas s'identifier, créez un jeton d'assistant dans Jetons de service : saisissez un nom, choisissez Assistant IA (MCP) dans la liste des portées et appuyez sur Créer un jeton. Un jeton d’assistant n’ouvre que le point d’accès des assistants IA, pas le reste de votre compte. Le jeton s'affiche une seule fois, comme tout jeton de service (Votre compte, votre équipe & vos calculs cloud). Guide de configuration, à la fin de l'indication que ce choix affiche sous le formulaire, ouvre ce chapitre dans un nouvel onglet : le jeton reste à l'écran pendant votre lecture.

Envoyez le jeton dans l'en-tête Authorization: Bearer : collez-le à la place de YOUR_MCP_TOKEN dans l'entrée de votre client.

Un client qui accepte des en-têtes HTTP.

La même entrée, avec le jeton :

{
  "mcpServers": {
    "pvspline": {
      "url": "https://api.pvspline.fr/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Un client qui ne lance que des commandes locales.

La même entrée, via mcp-remote :

{
  "mcpServers": {
    "pvspline": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.pvspline.fr/mcp",
        "--header",
        "Authorization:${PVSPLINE_AUTH}"
      ],
      "env": {
        "PVSPLINE_AUTH": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Votre première demande

Une fois l'assistant connecté, demandez-lui par exemple :

« Estime la production annuelle d'une toiture de 6 kWc orientée sud, inclinée à 30°, à Lyon, plus 3 kWc orientés est. Montre le profil mensuel et les principales pertes. »

Certains assistants vous demandent d'approuver une action la première fois qu'ils l'utilisent.

Bon à savoir

• Quotas. Chaque calcul lancé par un assistant nécessite une formule active et décompte le temps moteur qu'il utilise de votre quota mensuel de simulation, exactement comme un calcul lancé dans l'application web ; l'assistant peut vérifier ce qu'il reste. Chaque requête qu'il fait est décomptée de votre quota d'API cloud (le vôtre avec un abonnement, celui de la société avec l'offre gratuite), en secondes de temps serveur. Au-delà de ce quota, ses appels sont refusés avec le code API_ALLOWANCE_EXCEEDED jusqu'au 1er du mois (Quotas mensuels par formule).

• Le module. Les projets sont équipés d'un module courant de 425 W, sauf si vous en nommez un autre. Ouvrez le projet dans l'application web pour dessiner la vraie toiture, choisir les composants ou utiliser les données de votre compteur.

• Économies et temps de retour. Donnez à l'assistant votre consommation annuelle, votre tarif ou prix du kWh, et le coût de l'installation. Il répartit la consommation selon un profil type (logement, bureau, commerce…) et prend 22 h–6 h comme heures creuses pour un tarif heures pleines/heures creuses.

• Les chiffres. Les résultats sont des estimations P50/P90 du système modélisé, avec le même moteur et la même météo que l'application web. Économies et temps de retour utilisent le productible prudent P90, sauf réglage contraire du projet.

• Le rapport. Son rapport, ses graphiques et son classeur sont rédigés en anglais, quelle que soit la langue de l'interface. Son rapport PDF ne porte aucun QR code de vérification (Vérification du rapport), contrairement à ceux des calculs que vous lancez dans l'application web.

• Compteurs Enedis. Un projet dont la consommation provient d'un compteur Enedis ne se calcule que depuis l'application web, qui sait télécharger les données du compteur : l'assistant ne peut ni le lire, ni le modifier, ni le copier, ni le calculer.

• Votre projet ouvert. Une modification faite par l'assistant est une nouvelle version du projet. Si ce projet est ouvert dans l'application, l'enregistrement de votre version est refusé plutôt que d'écraser celle de l'assistant (Travailler avec les projets).

Les données de vos clients

Ce que l'assistant lit est transmis à son fournisseur (Anthropic, OpenAI ou un autre), qui le traite selon ses propres conditions, éventuellement hors de l'Union européenne : le nom des projets, leur emplacement approximatif (à un kilomètre près), leurs champs PV, consommations estimées, prix, coûts et résultats. pvSpline ne lui transmet jamais le nom ni l'adresse de vos clients, ni les données de leurs compteurs Enedis, ni vos rapports.

C'est votre société qui décide : une nouvelle société démarre avec les assistants désactivés, et un compte Direction les active ou les désactive pour toute la société (Activer les assistants pour votre société).

Pour les développeurs

Point d'accès

https://api.pvspline.fr/mcp, en Streamable HTTP. Il parle la version 2026-07-28 du protocole et les versions antérieures, négociées à l'initialisation.

Identification

OAuth 2.1 avec enregistrement dynamique des clients et PKCE. Un jeton d'accès dure une heure et le client le renouvelle ; une connexion inutilisée pendant 90 jours doit se réidentifier.

Jeton de secours

Un jeton de portée Assistant IA (MCP), envoyé en Authorization: Bearer <token>, ouvre ce point d'accès et rien d'autre (Un assistant qui ne sait pas s'identifier).

Découverte

Les métadonnées de la ressource protégée, https://api.pvspline.fr/.well-known/oauth-protected-resource/mcp ; la carte serveur, https://app.pvspline.fr/.well-known/mcp/server-card.json ; https://app.pvspline.fr/llms.txt ; et le nom du serveur dans le registre MCP, fr.pvspline/pvspline.

Le point d'accès et ses métadonnées ne répondent qu'aux requêtes venant de France.