Connecter Quid+ à Gemini Enterprise
Cette page permet à l’administrateur Google Cloud d’une organisation abonnée de connecter News Tank Quid+ à Gemini Enterprise, en quatre étapes, sans intervention de News Tank.
Une fois le connecteur ajouté, chaque utilisateur de votre application Gemini Enterprise interroge les articles News Tank de son abonnement, avec des réponses sourcées. Le connecteur est en lecture seule : il ne modifie rien chez News Tank ni dans votre projet Google Cloud.
Prérequis
- Rôle : Discovery Engine Editor (roles/discoveryengine.editor) sur le projet Google Cloud de votre application Gemini Enterprise.
- Règles d’organisation : levez la contrainte qui bloque la création d’un data store « Custom MCP Server » ; autorisez le domaine quid.newstank.fr (adresses du serveur, d’autorisation et de jeton) dans la contrainte allowedEgressFqdns ; si l’application des contraintes est activée sur le projet ou s’il est protégé par VPC Service Controls, ajoutez aussi custom_mcp à allowedDataSources. Détail dans la section « Before you begin » de la documentation Google (liens en bas de page).
- Côté News Tank : un abonnement actif, et pour chaque utilisateur un compte News Tank (son adresse e-mail professionnelle). Vous créez vous-même l’identifiant client à l’étape 1.
Valeurs à saisir
Toutes les valeurs ci-dessous sont fixes, sauf l’identifiant et le secret client, propres à votre organisation et créés à l’étape 1.
| Champ (libellé de la console) | Valeur |
|---|---|
| MCP Server URL | https://quid.newstank.fr/mcp
|
| Authorization URL | https://quid.newstank.fr/oauth/authorize
|
| Authorization URL Parameters | laisser vide |
| Token URL | https://quid.newstank.fr/oauth/token
|
| Client ID | créé à l’étape 1 |
| Client Secret | créé à l’étape 1, à conserver comme un mot de passe |
| Scopes | mcp.read offline_access
|
| Enable PKCE Support | activé (S256) — obligatoire chez News Tank |
| Use HTTP Basic Authentication | laisser cochée (réglage par défaut) |
L’adresse de retour à déclarer est déjà incluse dans la commande de l’étape 1 : https://vertexaisearch.cloud.google.com/oauth-redirect
Étape 1 — Créer votre identifiant News Tank
Cette étape produit l’identifiant client (ntkc_…) et le secret client, à saisir à l’étape 2. Avant de lancer la commande, remplacez « Votre organisation » par le nom de votre organisation : vos utilisateurs le verront sur l’écran d’autorisation News Tank. Apostrophes et accents sont acceptés ; évitez les guillemets (droits ou typographiques) et les caractères $ et ` (accent grave).
Depuis un terminal macOS ou Linux, ou Google Cloud Shell :
curl -s -X POST https://quid.newstank.fr/oauth/register -H 'Content-Type: application/json' --data-binary @- <<'EOF'
{"client_name":"Gemini Enterprise (Votre organisation)","redirect_uris":["https://vertexaisearch.cloud.google.com/oauth-redirect"],"token_endpoint_auth_method":"client_secret_basic"}
EOF
Depuis Windows PowerShell :
$body = @{ client_name = "Gemini Enterprise (Votre organisation)"; redirect_uris = @("https://vertexaisearch.cloud.google.com/oauth-redirect"); token_endpoint_auth_method = "client_secret_basic" } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri https://quid.newstank.fr/oauth/register -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
La réponse contient client_id et client_secret. Copiez-les aussitôt : le secret ne s’affiche qu’une fois. Conservez-le comme un mot de passe.
Cet identifiant n’ouvre aucun accès à lui seul : chaque utilisateur se connecte ensuite avec son propre compte News Tank. Secret perdu : recommencez cette étape et remplacez l’identifiant à l’étape 2.
Étape 2 — Ajouter le serveur MCP
1. Dans la console Google Cloud, ouvrez la page Gemini Enterprise, puis Apps, et sélectionnez votre application.
2. Ouvrez Connected Data Stores, puis New data store. Recherchez Custom MCP Server et cliquez sur Add MCP server.
3. Sous Authentication settings, choisissez OAuth 2.0 et renseignez les valeurs du tableau.
4. Cliquez sur Verify Auth. Si la page de connexion News Tank s’ouvre, identifiez-vous avec un compte News Tank actif. Cliquez ensuite sur Continue.
5. Advanced options (facultatif) : vous pouvez y ajouter une description du serveur. Cliquez de nouveau sur Continue.
6. Dans Configure your data connector, choisissez la localisation dans la liste Multi-region (global, us ou eu) et saisissez News Tank Quid+ dans Your data connector name.
7. Cliquez sur Create : le data store apparaît dans Connected Data Stores.
8. Ouvrez-le et attendez que son état passe de Creating à Active : il est alors utilisable.
Étape 3 — Activer les actions
Par défaut, Google désactive toutes les actions d’un serveur MCP ajouté.
1. Dans le data store créé, ouvrez Actions, puis Reload custom actions.
2. Sélectionnez toutes les actions News Tank Quid+, puis cliquez sur Enable actions.
Les actions News Tank Quid+ sont toutes en lecture seule : Gemini ne demande pas de confirmation à l’utilisateur avant de les appeler.
Étape 4 — Connexion de chaque utilisateur
Chaque utilisateur se connecte une fois à son compte News Tank.
1. Au premier usage dans Gemini Enterprise, la page de connexion News Tank s’ouvre : l’utilisateur s’identifie comme sur le site (son e-mail, puis le code reçu ou son mot de passe).
2. Sur l’écran d’autorisation, il coche si elle s’affiche la case « J’accepte les conditions générales d’utilisation de News Tank », puis clique sur « Autoriser l’accès ».
3. Pour vérifier : poser une question d’actualité de son secteur. La réponse doit citer des articles News Tank.
L’accès se révoque à tout moment depuis le compte News Tank de l’utilisateur.
Édition Business
Sur Gemini Enterprise édition Business, l’ajout se fait sans console Google Cloud, par l’administrateur de l’équipe. Google présente cette fonction comme une préversion.
1. Sur business.gemini.google, ouvrez Settings & help, sélectionnez votre équipe, puis Manage team → Connected apps → Add MCP Server.
2. Dans MCP info, saisissez l’adresse du serveur (MCP Server URL du tableau) et le nom News Tank Quid+, puis cliquez sur Next.
3. Choisissez OAuth 2.0 et renseignez les mêmes valeurs que dans le tableau, puis cliquez sur Verify Auth et Continue.
4. Dans Configure your data connector, choisissez la localisation (Multi-region), nommez le connecteur News Tank Quid+ et cliquez sur Add.
5. Activez la connexion pour l’équipe : elle est désactivée par défaut.
La connexion de chaque utilisateur se fait ensuite comme à l’étape 4.
Dépannage
| Symptôme | À vérifier |
|---|---|
| « Custom MCP Server » absent ou création refusée | Contrainte d’organisation levée ; rôle Discovery Engine Editor sur le bon projet. |
| « Verify Auth » échoue | Identifiant et secret recopiés sans espace ; case PKCE cochée ; quid.newstank.fr autorisé en sortie si votre organisation filtre le réseau. |
| Gemini répond sans citer News Tank | Actions activées (étape 3) ; nouvelle conversation ; question qui relève d’un média de votre abonnement. |
| La connexion News Tank échoue pour un utilisateur | Utilisateur titulaire d’un compte News Tank sur un abonnement actif. |
Pour toute autre difficulté, écrivez-nous.