Configurer le proxy MCP d’Avanoo (hébergé)

Avanoo MCP Proxy vous permet d’exposer des services SaaS approuvés via un point de terminaison MCP unique.

Avec le déploiement hébergé, Avanoo gère l’infrastructure proxy pour vous. Vous n’avez qu’à configurer les services disponibles et la portée de l’accès.

Fonctionnement

La configuration d’un proxy MCP Avanoo hébergé est simple :

1. Sélectionnez les services SaaS à autoriser

2. Ajoutez des instructions ciblées pour chaque service

3. Partagez l’URL du MCP Proxy avec vos utilisateurs

Vos utilisateurs ajoutent ensuite cette URL à leur client MCP, s’authentifient et commencent à utiliser les services que vous avez exposés.

Avant de commencer

Assurez-vous de disposer :

• l’accès à votre espace de travail Avanoo

• l’autorisation de configurer le proxy MCP Avanoo

• de la liste des services SaaS que vous souhaitez exposer

Configurer le proxy MCP hébergé

Étape 1 : Sélectionnez les services SaaS à autoriser

Choisissez les services SaaS que vous souhaitez exposer via Avanoo MCP Proxy.

Par exemple :

• Google Drive

• Slack

• Notion

• Jira

• GitHub

Seuls les services que vous activez ici seront exposés via ce MCP Proxy.

Étape 2 : Ajouter des instructions ciblées

Pour chaque service, vous pouvez ajouter des instructions afin d’aider à définir le périmètre des autorisations.

Ces instructions servent à restreindre l’accès. Ce ne sont pas des instructions comportementales générales pour l’assistant.

Utilisez-les pour préciser des éléments tels que :

• quel espace de travail, dépôt, projet ou dossier doit être accessible

• si l’accès doit être en lecture seule ou inclure des actions d’écriture

• quelles ressources doivent être exclues

Exemples :

Google Drive : uniquement les lecteurs partagés Product et Support. Accès en lecture seule.

GitHub : uniquement les dépôts de l’organisation avanoo. Accès en lecture seule aux issues, aux pull requests et au contenu des dépôts.

Jira : uniquement les projets ENG et OPS. Autoriser la lecture des tickets et la mise à jour de leur statut si la date d’échéance n’est pas dépassée.

Gardez ces instructions courtes et précises. Leur objectif est de définir les limites d’accès pour chaque service.

Étape 3 : Enregistrer la configuration

Une fois les services sélectionnés et les instructions ciblées ajoutées, enregistrez la configuration.

Le proxy MCP Avanoo est maintenant prêt à être utilisé.

Étape 4 : copiez l’URL du proxy MCP

Chaque proxy MCP hébergé est exposé via une seule URL.

Exemple :

https://mcp.avanoo.com/workspaces/<workspace-id>/proxy/<proxy-id>

Partagez cette URL avec les utilisateurs qui doivent accéder au proxy.

Se connecter depuis un client MCP

Les utilisateurs finaux n’ont besoin que de l’URL du MCP Proxy.

Pour vous connecter :

1. Ouvrez le client MCP

2. Ajoutez un nouveau serveur MCP

3. Collez l’URL d’Avanoo MCP Proxy

4. Authentifiez-vous lorsque vous y êtes invité

Après l’authentification, le client peut détecter et utiliser les services SaaS exposés par ce proxy.

Ce dont les utilisateurs finaux ont besoin

Les utilisateurs finaux n’ont besoin que de :

• l’URL du proxy MCP Avanoo

• l’autorisation de s’authentifier

Ils n’ont pas besoin de :

• configurer chaque service SaaS individuellement

• gérer plusieurs points de terminaison MCP

• comprendre la configuration du proxy sous-jacent

Mettre à jour un proxy hébergé existant

Vous pouvez mettre à jour un proxy MCP hébergé à tout moment.

Les mises à jour typiques incluent :

• l’ajout d’un nouveau service SaaS

• la suppression d’un service

• la modification des instructions ciblées

• l’affinement des limites d’accès

Les utilisateurs continuent de se connecter via la même URL du proxy MCP.

Dépannage

Un service n’apparaît pas

Vérifiez que :

• le service est activé dans la configuration du proxy

• la configuration a bien été enregistrée

• l’utilisateur s’est authentifié avec succès

L’accès est trop large ou trop limité

Vérifiez les instructions ciblées configurées pour ce service.

Dans la plupart des cas, les problèmes d’autorisations proviennent d’instructions trop vagues ou trop restrictives.

L’utilisateur ne parvient pas à se connecter

Vérifiez que :

• l’URL du MCP Proxy est correcte

• l’utilisateur se connecte avec le bon compte

• l’utilisateur a accès à l’espace de travail

Étapes suivantes

Après la configuration de votre proxy MCP hébergé :

• partagez l’URL du MCP Proxy avec les utilisateurs

• vérifiez que l’authentification fonctionne depuis votre client MCP

• vérifiez les instructions ciblées pour chaque service activé