Connecter Ondes PRO à JetBrains AI Assistant

Ajouter le serveur MCP d’Ondes PRO dans AI Assistant

Il vous faut un IDE JetBrains avec le plugin AI Assistant activé. Les intitulés ci-dessous sont ceux de la version anglaise des réglages, la plus répandue.

1. 1

   Ouvrez les réglages MCP d’AI Assistant

   Dans Settings, allez dans Tools → AI Assistant → Model Context Protocol (MCP).

2. 2

   Ajoutez un serveur par sa configuration JSON

   Cliquez sur Add et choisissez la saisie en JSON. La forme que JetBrains documente pour un serveur distant tient en une adresse :

   jsonCopier

   {
     "mcpServers": {
       "ondes": { "url": "https://votre-espace.ondes.pro/mcp/" }
     }
   }

3. 3

   Choisissez votre mode d’authentification

   Si votre version d’AI Assistant ouvre d’elle-même une fenêtre de votre espace Ondes PRO pour autoriser la connexion, la forme ci-dessus suffit. Sinon, ajoutez l’en-tête Authorization avec une clé API, comme dans la configuration plus bas.

4. 4

   Appliquez et vérifiez l’état

   Validez les réglages : le serveur ondes apparaît dans la liste avec son état. Une fois connecté, ses huit outils sont disponibles dans le chat d’AI Assistant.

5. 5

   Interrogez votre espace depuis l’IDE

   Dans le chat d’AI Assistant, demandez par exemple « Quelles actions propose la ressource des factures ? ». L’assistant appelle les outils du serveur pour répondre.

Configuration par clé API pour AI Assistant

C’est la voie la plus sûre de fonctionner aujourd’hui avec AI Assistant. Créez une clé dans API & Développeurs → Clés API ; donnez-lui les seules portées utiles, la lecture de la facturation par exemple.

{
  "mcpServers": {
    "ondes": {
      "url": "https://votre-espace.ondes.pro/mcp/",
      "headers": {
        "Authorization": "ApiKey opk_…"
      }
    }
  }
}

Pourquoi une clé API restreinte convient bien à un IDE

Exemple : coder les retours clients sans inventer d’endpoint

Marc développe le module de retours du back-office d’Atelier Lumen. Le Comptoir des Marées renvoie deux lampes de chevet ; il faut que le code sache traiter ce cas.

Ce qu’AI Assistant gagne avec le serveur Ondes PRO

• La documentation de votre espace, à jour à chaque appel, plutôt qu’un fichier copié dans le projet.
• Un garde-fou contre l’hallucination : ondes_impossible liste ce que l’API ne fait pas volontairement.
• Des fiches de ressources complètes : champs typés et obligatoires, filtres, tri, actions, permission exigée.
• Environ 2 700 tokens de contexte permanent seulement, contre quelque 44 000 pour l’ancien fichier de documentation.

Pour aller plus loin

• FacturationDevis, factures, relances et avoirs préparés par votre assistant, dans le respect des règles de facturation.Lire
• Construire une intégrationClés à portées, webhooks signés, idempotence et mode test pour un back-office qui ne crée jamais de doublon.Lire
• API REST v1Environ 135 ressources REST, des clés à portées, un schéma OpenAPI et des webhooks signés.Lire
• Sécurité du serveur MCPOAuth 2.1, jetons courts, révocation immédiate et garde-fous d’écriture : ce que votre DSI doit savoir.Lire

Questions fréquentes

À lire aussi

• ClaudeClaude Desktop, claude.ai et Claude Code : un connecteur personnalisé, une connexion OAuth, et c’est prêt.Lire
• CursorUn fichier `.cursor/mcp.json`, une connexion OAuth : l’agent de Cursor code contre votre vrai espace.Lire
• Visual Studio CodeLe mode agent de GitHub Copilot lit et appelle votre espace depuis `.vscode/mcp.json`.Lire
• ChatGPTLe mode développeur de ChatGPT accepte votre espace comme connecteur MCP, en OAuth.Lire
• WindsurfCascade se branche sur votre espace par `mcp_config.json` et la clé `serverUrl`.Lire
• ZedTrois lignes dans `context_servers`, et Zed mène seul l’autorisation OAuth.Lire