# Connecter Ondes PRO à Claude

> Ajoutez Ondes PRO comme connecteur personnalisé dans Claude ou Claude Code : OAuth en un clic, configuration prête à copier, exemples. Testé par notre équipe.

Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/clients/claude

Claude se connecte au serveur MCP de votre espace Ondes PRO comme **connecteur personnalisé** — dans l’application de bureau, sur claude.ai, ou dans le terminal avec Claude Code. Comptez une minute, sans clé à copier : la connexion passe par OAuth.

## Ajouter Ondes PRO à Claude Desktop ou claude.ai

Les connecteurs personnalisés sont disponibles sur toutes les offres Claude (l’offre gratuite en autorise un). Ils sont en bêta chez Anthropic : l’intitulé exact des menus peut évoluer.

1. **Repérez l’adresse de votre espace** — C’est l’adresse de votre administration Ondes PRO suivie de `/mcp/`. Tapez votre sous-domaine dans le champ en haut de page : toutes les configurations s’adaptent.

```
https://votre-espace.ondes.pro/mcp/
```
2. **Ouvrez les connecteurs** — Dans Claude, ouvrez **Personnaliser**, puis **Connecteurs**, puis **+ Ajouter** et **Ajouter un connecteur personnalisé**. Dans une organisation Team ou Enterprise, un administrateur l’ajoute une fois depuis les réglages de l’organisation.
3. **Collez l’adresse et validez** — Nommez le connecteur « Ondes PRO » et collez l’adresse. Laissez les réglages OAuth avancés vides : le serveur s’annonce de lui-même.
4. **Autorisez la connexion** — Une fenêtre de votre espace Ondes PRO s’ouvre. Connectez-vous, lisez l’écran de consentement — il dit en clair ce que la connexion permettra — puis autorisez. Claude affiche alors les outils du serveur.
5. **Posez votre première question** — Essayez « Quelles factures sont en retard ? » ou « Résume-moi l’activité de la boutique cette semaine ». Claude choisit lui-même les outils à appeler.

![Écran de consentement d’Ondes PRO : destination, adresse de retour, nom déclaré par l’application, compte, et avertissement sur les droits complets de la connexion.](https://ondes.pro/integrations/mcp-consentement-oauth.webp)

## Avec Claude Code, dans le terminal

Pour un développeur qui construit une intégration, Claude Code est le chemin le plus direct : il lit la documentation de votre espace pendant qu’il écrit le code. Tapez ensuite `/mcp` dans Claude Code et choisissez « ondes » pour vous connecter.

Où se règle la connexion : Une commande dans le terminal, puis `/mcp` dans Claude Code pour se connecter.

**Connexion par OAuth (recommandée)** (Terminal)

```bash
claude mcp add --transport http ondes https://votre-espace.ondes.pro/mcp/
```

**Connexion par clé API** (Terminal)

```bash
claude mcp add --transport http ondes https://votre-espace.ondes.pro/mcp/ \
  --header "Authorization: ApiKey opk_…"
```

_Testé par notre équipe. Documentation de l’éditeur : https://code.claude.com/docs/en/mcp_

## OAuth ou clé API : laquelle choisir ?

**OAuth** est le choix par défaut : rien à copier, rien à stocker, et la connexion apparaît dans votre espace sous le nom de la machine, révocable d’un clic. Elle agit avec vos droits complets.

La **clé API** convient quand vous voulez restreindre l’accès — par exemple une clé en lecture seule sur la facturation pour un collaborateur qui prépare des tableaux de bord. Créez-la dans **API & Développeurs → Clés API** ; elle ne s’affiche qu’une fois. Une clé ne dépasse jamais les droits de son porteur. Les deux voies sont détaillées sur la page [sécurité du serveur MCP](https://ondes.pro/fr/integrations/mcp/securite).

## À quoi ressemble une conversation

_Exemple de conversation · données de démonstration (Atelier Lumen)_

> **Vous** : Quelles factures sont en retard, et de combien ?
>
> 🔧 `ondes_ressource` Lit la fiche `billing/factures` pour connaître les filtres disponibles.
>
> 🔧 `ondes_appeler` `GET billing/factures?statut=en_attente` — 3 factures dont l’`etat` vaut `en_retard`.
>
> **Assistant** : Trois factures sont en retard, pour **4 860 € TTC** : Brasserie La Canopée (FAC-2026-0187, 18 jours), Studio Nord (FAC-2026-0191, 9 jours) et Galerie Ressac (FAC-2026-0196, 3 jours). Voulez-vous que je prépare une relance pour les deux plus anciennes ?

## Idées de demandes

- « Crée une carte dans le tableau Atelier pour la commande de l’Hôtel Ker Aven, échéance vendredi. »
- « Combien reste-t-il de lampadaires Arc en stock, et quand faut-il relancer la production ? »
- « Prépare un code promo de 15 % valable jusqu’à dimanche pour la newsletter. »
- « Liste les courriels non lus de contact@ qui parlent d’un devis. »
- « Planifie une visio avec Studio Nord mardi à 10 h et envoie l’invitation. »

> **Si Claude ne voit pas vos modules** — La connexion suit votre rôle : un module que votre rôle n’ouvre pas reste invisible pour Claude. Il faut aussi la permission **API & Développeurs** pour se connecter. Si un outil manque, demandez à l’administrateur de votre espace d’ajuster votre rôle, puis reconnectez le connecteur.

## Autres assistants

- [ChatGPT](https://ondes.pro/fr/integrations/mcp/clients/chatgpt) — Le mode développeur de ChatGPT accepte votre espace comme connecteur MCP, en OAuth.
- [Cursor](https://ondes.pro/fr/integrations/mcp/clients/cursor) — Un fichier `.cursor/mcp.json`, une connexion OAuth : l’agent de Cursor code contre votre vrai espace.
- [Visual Studio Code](https://ondes.pro/fr/integrations/mcp/clients/visual-studio-code) — Le mode agent de GitHub Copilot lit et appelle votre espace depuis `.vscode/mcp.json`.
- [Windsurf](https://ondes.pro/fr/integrations/mcp/clients/windsurf) — Cascade se branche sur votre espace par `mcp_config.json` et la clé `serverUrl`.

## Questions fréquentes

### L’offre gratuite de Claude suffit-elle ?

Oui pour essayer : elle autorise un connecteur personnalisé. Les offres payantes de Claude en acceptent davantage et donnent plus d’usage.

### Claude peut-il modifier mes données sans me demander ?

Claude demande votre accord avant d’utiliser un outil qui écrit, selon vos réglages d’autorisation dans Claude. Côté Ondes PRO, les écritures partent en mode test quand la ressource en a un, et l’assistant intégré propose ses changements sous forme de plan à confirmer.

### Comment déconnecter Claude ?

Dans votre espace, onglet **MCP** de **API & Développeurs** : chaque connexion est listée par machine avec sa dernière activité, et « Révoquer » la coupe immédiatement. Vous pouvez aussi retirer le connecteur dans Claude.

### Claude Code et Claude Desktop partagent-ils la même connexion ?

Non : chaque application s’autorise séparément et apparaît comme une connexion distincte dans votre espace. C’est voulu — vous pouvez révoquer l’une sans toucher à l’autre.