# Connecteurs IA

> Connectez vos apps et serveurs MCP à vos agents IA, pour que votre réceptionniste IA et Allo AI puissent y chercher des informations et y agir.

Connectez vos apps et serveurs MCP à vos agents IA. Le MCP (Model Context Protocol) est le standard ouvert qui permet aux agents IA d'utiliser d'autres logiciels. Vous connectez une application ou un serveur MCP une fois pour tout l'espace de travail, vous choisissez les outils que l'IA peut utiliser, puis vous l'activez pour chaque réceptionniste IA. Pendant un appel, votre agent peut alors vérifier une commande, retrouver un client ou mettre à jour une fiche, sans qu'un membre de l'équipe intervienne.

**Disponible sur :** web et app de bureau. Inclus dans tous les plans. Les agents ont besoin de l'[option réceptionniste IA](/fr/help/billing/add-ons) pour utiliser les connecteurs pendant les appels.

<Note>
  Cette page porte sur l'ajout de vos applications dans Allo. Pour utiliser Allo depuis Claude ou ChatGPT, consultez la page [Serveur MCP](/fr/help/integrations/mcp).
</Note>

## Ce que vos agents peuvent faire pendant les appels

Une fois un connecteur activé pour un agent, votre réceptionniste IA peut utiliser ses outils pendant qu'il parle à un appelant ou répond à un SMS. Il peut retrouver un client, vérifier le statut d'une commande ou d'un ticket, ou créer et mettre à jour une fiche, selon les outils que vous avez activés. L'agent n'utilise que les outils autorisés, et un outil en lecture seule ne modifie jamais vos données.

Après l'appel, la fiche de l'appel indique chaque connecteur utilisé par l'agent. Pour choisir les connecteurs et les outils de chaque agent, consultez [votre réceptionniste IA et vos applications](/fr/help/features/ai-receptionist-connectors).

## Qui peut configurer les Connecteurs IA

Le propriétaire de l'espace de travail et les administrateurs gèrent les connecteurs dans **Paramètres** → **Connecteurs IA**. Les autres membres de l'équipe ne voient pas cette page. Dans l'onglet **Connecteurs IA** d'un agent, ils voient les connecteurs utilisés par l'agent, sans pouvoir les modifier.

Un espace de travail compte au maximum 10 connecteurs.

## Comment connecter un serveur MCP

Vous pouvez connecter n'importe quelle application qui propose un serveur MCP. L'éditeur de l'application ou votre développeur vous donne l'adresse du serveur.

<Steps>
  <Step title="Ajoutez le serveur">
    Dans **Paramètres** → **Connecteurs IA**, cliquez sur **Ajouter un MCP personnalisé**.
  </Step>
  <Step title="Renseignez les informations">
    - **Nom** : le nom que les agents voient à côté des outils du serveur, par exemple `Linear`
    - **Description** (facultatif) : à quoi sert le serveur, pour que votre équipe sache pourquoi il est là
    - **URL du serveur** : une adresse `https` publique
    - **Clé API** (facultatif) : envoyée au serveur comme jeton Bearer
    - **En-têtes HTTP** (facultatif) : pour les serveurs qui attendent une clé dans leur propre en-tête, comme `x-api-key`

    Allo stocke la clé API et les valeurs des en-têtes chiffrées. Personne ne peut plus les lire dans Allo, administrateurs compris.
  </Step>
  <Step title="Confirmez que vous faites confiance au serveur">
    Cochez **Je fais confiance à ce serveur**. Quand les agents utilisent ses outils, ils lui envoient des informations issues de vos appels et messages, et ses réponses peuvent modifier ce que disent les agents. Allo ne vérifie pas les serveurs tiers.
  </Step>
  <Step title="Testez la connexion">
    Cliquez sur **Tester la connexion**. Allo affiche le nombre d'outils proposés par le serveur.
  </Step>
  <Step title="Choisissez les outils">
    Activez les outils que l'IA peut utiliser, puis cliquez sur **Enregistrer**.
  </Step>
</Steps>

## HubSpot

HubSpot a un connecteur prêt à l'emploi sous **Applications** : pas besoin d'adresse de serveur. Cliquez sur **Connecter avec OAuth**, puis terminez la connexion à HubSpot dans la fenêtre qui s'ouvre. Activez ensuite les outils que l'IA peut utiliser et cliquez sur **Enregistrer**, ou sur **Choisir plus tard**.

Aujourd'hui, le connecteur HubSpot fonctionne uniquement dans Allo AI, pas pour les agents pendant les appels. Consultez [HubSpot comme connecteur et comme intégration CRM](#hubspot-comme-connecteur-et-comme-intégration-crm).

## Comment fonctionne l'accès aux outils

Chaque outil a trois niveaux d'accès :

| Niveau | Ce que l'IA peut faire |
| --- | --- |
| **Lecture et écriture** | Consulter des informations, et créer, modifier ou supprimer des données |
| **Lecture seule** | Consulter des informations, sans jamais rien modifier |
| **Aucun accès** | Rien, l'IA ne voit jamais l'outil |

C'est le serveur qui décide si un outil lit ou modifie des données. Un outil qui modifie des données ne peut pas être limité à la lecture : pour cet outil, vous choisissez entre **Lecture et écriture** et **Aucun accès**. Allo signale ces outils avec la mention **Modifie des données**.

Vous pouvez activer jusqu'à 100 outils par connecteur.

## Comment modifier un connecteur

Cliquez sur **Gérer les outils** à côté du connecteur pour changer ses outils, son nom ou sa description.

- **Actualiser les outils** demande au serveur la liste à jour de ses outils. Les nouveaux outils restent désactivés jusqu'à ce que vous les activiez.
- **Paramètres avancés** → **Lier des paramètres** permet à Allo de renseigner lui-même une donnée d'un outil, à partir d'une valeur comme le **Numéro de téléphone de l'appelant**, l'**E-mail du contact** ou l'**ID CRM du contact**. L'IA ne peut ni voir ni modifier une valeur liée. Si la valeur n'est pas disponible (par exemple, pas d'appelant dans une conversation Allo AI), l'outil ne s'exécute pas.

Pour retirer un connecteur, ouvrez son menu et cliquez sur **Supprimer**. Tous les agents perdent ses outils immédiatement et Allo supprime la clé. Les appels et messages passés conservent la trace de ce que les agents ont fait.

## Où Allo utilise vos connecteurs

- **Réceptionniste IA** : un agent n'utilise que les connecteurs activés dans son onglet **Connecteurs IA**. Consultez [votre réceptionniste IA et vos applications](/fr/help/features/ai-receptionist-connectors).
- **Allo AI** : [Allo AI](/fr/help/features/ai-assistant) peut utiliser vos connecteurs dans le chat. Chaque réponse indique les connecteurs et les outils utilisés.

## HubSpot comme connecteur et comme intégration CRM

Vous pouvez connecter HubSpot à deux endroits, chacun avec sa propre connexion :

- L'[intégration CRM HubSpot](/fr/help/integrations/hubspot), dans **Paramètres** → **Intégrations**, synchronise vos appels, SMS et contacts.
- Le connecteur HubSpot, dans **Paramètres** → **Connecteurs IA**, permet à l'IA de consulter et de mettre à jour des fiches HubSpot.

Connecter l'un ne connecte pas l'autre. Aujourd'hui, le connecteur HubSpot fonctionne uniquement dans Allo AI. Dans l'onglet **Connecteurs IA** d'un agent, il apparaît avec la mention **Coming soon**.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Je ne vois pas Connecteurs IA dans les paramètres">
    Seuls le propriétaire de l'espace de travail et les administrateurs voient **Connecteurs IA**. Demandez à l'un d'eux de faire la configuration ou de changer votre rôle dans les [paramètres de l'équipe](/fr/help/team/manage-members). Si vous êtes administrateur et ne voyez toujours pas la page, [contactez le support](/fr/help/support/contact).
  </Accordion>

  <Accordion title="« Seuls les administrateurs de l'espace de travail peuvent modifier les connecteurs. »">
    Votre rôle permet de voir les connecteurs, pas de les modifier. Adressez-vous au propriétaire de l'espace de travail ou à un administrateur.
  </Accordion>

  <Accordion title="« Connexion non terminée. Réessayez. »">
    La fenêtre de connexion s'est fermée ou a expiré avant la fin. Cliquez sur **Terminer la connexion** à côté de l'application et connectez-vous à nouveau. Une seule connexion à la fois est possible.
  </Accordion>

  <Accordion title="« Impossible de joindre ce serveur. »">
    Vérifiez l'**URL du serveur** et que le serveur est en ligne. Allo accepte uniquement une adresse `https` publique, pas une adresse privée ou interne.
  </Accordion>

  <Accordion title="« Le serveur a refusé cette clé API. »">
    La clé est incorrecte, expirée ou il lui manque une autorisation. Créez une nouvelle clé dans l'application, puis collez-la à nouveau.
  </Accordion>

  <Accordion title="« Cette adresse ne répond pas comme un serveur MCP. »">
    L'URL mène à un site ou à une API, pas à un serveur MCP. Demandez l'adresse du serveur MCP à l'éditeur. Elle se termine souvent par `/mcp`.
  </Accordion>

  <Accordion title="Le serveur propose trop d'outils">
    Allo ne peut pas lister un serveur qui propose plus d'outils que sa limite. Demandez à l'éditeur d'exposer moins d'outils, ou de les filtrer avant de vous connecter.
  </Accordion>

  <Accordion title="« Votre espace de travail compte déjà 10 connecteurs. »">
    Un espace de travail compte au maximum 10 connecteurs. Supprimez-en un que vous n'utilisez plus pour en ajouter un autre.
  </Accordion>

  <Accordion title="« Certains outils ne sont plus proposés par ce serveur. »">
    Le serveur a retiré ou renommé des outils. Ouvrez **Gérer les outils** et cliquez sur **Actualiser les outils** pour mettre la liste à jour.
  </Accordion>
</AccordionGroup>

## Besoin d'aide ?

<CardGroup cols={2}>
  <Card title="Réceptionniste IA et vos applications" icon="/media/allo-icons/AI.svg" href="/fr/help/features/ai-receptionist-connectors">
    Choisissez les connecteurs et les outils que chaque agent peut utiliser pendant les appels.
  </Card>
  <Card title="Contacter le support" icon="/media/allo-icons/CircleQuestion.svg" href="/fr/help/support/contact">
    Écrivez-nous si quelque chose ne fonctionne pas comme décrit ici.
  </Card>
</CardGroup>
