Guide d'utilisation du connecteur MCP PowPop (泡泡)
PowPop est une application sociale basée sur la géolocalisation : les utilisateurs découvrent sur une carte les humains numériques publics, les utilisateurs réels et les publications à proximité, peuvent dialoguer avec les humains numériques et participer à des campagnes de check-in. Ce connecteur encapsule ces fonctionnalités en 9 outils en lecture seule.
Authentification et prérequis
- Le contenu public ne nécessite pas de connexion : les humains numériques, publications, attractions, campagnes, plans d'adhésion et autres données publiques à proximité peuvent être consultés de manière anonyme.
- Les fonctionnalités liées au compte nécessitent une autorisation : si le premier appel retourne une erreur 401, cela signifie que l'utilisateur n'a pas encore terminé l'autorisation OAuth. Guidez l'utilisateur pour trouver PowPop dans les paramètres du connecteur et terminer l'autorisation (la page d'autorisation est fournie par PowPop), puis réessayez une fois l'autorisation effectuée. L'état d'autorisation est géré automatiquement par la plateforme (renouvellement automatique du token), il n'est pas nécessaire de le demander à plusieurs reprises.
- Attention au système de coordonnées : les outils impliquant des coordonnées utilisent tous le système GCJ-02 (Gaode/Mars) . Si l'utilisateur fournit directement les coordonnées GPS (WGS-84), il y aura un décalage d'environ 300 à 600 mètres ; privilégiez la demande d'un nom de lieu à l'utilisateur, qui sera converti via
geocode_placeou le paramètreplacede l'outil.
Aperçu des outils
| Outil | Utilité | Paramètres clés | Scénario typique |
|---|---|---|---|
find_nearby | Découvrir les humains numériques, utilisateurs réels et publications à proximité | lat+lng ou place (au choix) ; radius_meters par défaut 1000 ; types pour filtrer un type spécifique | « Qui/quoi y a-t-il près de chez moi ? » |
geocode_place | Convertir un nom de lieu en coordonnées et rapporter la confiance de correspondance | place | Première étape avant d'avoir besoin de coordonnées |
get_digital_human | Profil complet d'un humain numérique (personnalité/présentation/position/humeur) | id (provenant de find_nearby) | « Prochaine étape » après avoir trouvé un humain numérique |
get_post_detail | Texte intégral d'une publication + liste des commentaires | post_id (provenant de find_nearby/search_posts) | Développer la discussion d'une publication spécifique |
nearby_attractions | Attractions et quartiers d'affaires à proximité (par distance) | lat+lng ou place ; radius_meters par défaut 3000 | « Qu'est-ce qu'il y a d'intéressant à faire près d'ici ? » |
search_posts | Rechercher des publications publiques par mot-clé | keyword (correspond au texte, insensible à la casse) | « Publications sur la Cité Interdite » |
list_campaigns | Toutes les campagnes publiques (avec liste des lieux de check-in intégrée) | Aucun | « Quelles sont les campagnes en cours ? » |
list_membership_plans | Tarifs des adhésions/forfaits | Aucun | « Combien coûte l'adhésion ? » |
whoami | Vérifier l'identité actuelle autorisée | Aucun | « Qui suis-je ? » « Suis-je connecté ? » |
Le schéma des paramètres fait foi sur le retour en temps réel de
tools/list. Seuls les paramètres courants sont listés ci-dessus ; en cas de différence pour les paramètres optionnels ou les valeurs par défaut, ne discutez pas avec l'utilisateur et appelez selon le schéma en temps réel.
Points d'utilisation de chaque outil
find_nearby — Outil principal de découverte à proximité
- Choix de la position (par ordre de préférence) :
place(nom de lieu, recommandé, encodage automatique) >lat+lng(GCJ-02). Si aucun des trois n'est fourni, le serveur ne peut pas se localiser et retourne une erreur. typespeut filtrer selon les besoins :digital_humans(humains numériques) /users(utilisateurs réels) /posts(publications), par défaut tout est retourné.- Le retour contient un résumé par catégorie et la distance ; les cartes d'humains numériques peuvent être développées avec
get_digital_human. - Exemple : l'utilisateur dit « Qui est près du centre commercial Guomao ? » →
{ "place": "Guomao", "types": ["digital_humans"] }.
geocode_place — Encodage de nom de lieu + confiance
- Retourne
lat/lng,matched_name(nom POI réellement trouvé par le serveur) etconfidence(0~1). - Si la confiance est inférieure à 0,8, vous devez obligatoirement communiquer à l'utilisateur à la fois « le nom de lieu que vous avez saisi » et « le nom de lieu réellement trouvé » pour confirmation , ne considérez pas la correspondance floue comme une réponse définitive pour continuer la requête.
get_digital_human — Détails d'un humain numérique
iddoit provenir de l'identifiant d'humain numérique retourné par find_nearby ou un autre outil, ne le construisez pas arbitrairement.- Retourne la personnalité (persona), la présentation, la position et l'humeur actuelle, adapté pour présenter l'humain numérique puis guider l'utilisateur dans la conversation.
get_post_detail — Détails d'une publication
post_idprovient du retour defind_nearbyousearch_posts.- Seules les publications publiques (is_public) peuvent être consultées ; les publications non publiques retourneront une erreur lisible, transmettez-la fidèlement à l'utilisateur.
nearby_attractions — Attractions et quartiers d'affaires
- Partage la même convention de paramètres de position que
find_nearby(placeoulat+lng, GCJ-02), rayon par défaut de 3000 mètres. - Retourne deux groupes : attractions (attractions) et quartiers d'affaires (business_districts), chacun avec la distance, pouvant être intégrés dans une réponse de type « recommandations à proximité ».
search_posts — Recherche de publications par mot-clé
keywordeffectue une correspondance floue insensible à la casse sur le texte de la publication.- Les résultats contiennent un résumé, la position et un lien vers l'image à la une ; lorsque vous citez une publication spécifique, incluez si possible sa position pour rendre la réponse plus complète.
- Exemple : « Recherche des publications sur l'automne » →
{ "keyword": "automne" }.
list_campaigns — Liste des campagnes
- Aucun paramètre. Retourne toutes les campagnes publiques (par exemple la campagne de check-in « 100 musées à Pékin »), chaque campagne contient une liste de lieux de check-in (acts).
- Lorsque l'utilisateur demande « Quelles sont les campagnes / check-in disponibles ? », privilégiez l'appel à cet outil.
list_membership_plans — Plans d'adhésion
- Aucun paramètre. Retourne les prix groupés par canal : forfait à durée d'Alipay et abonnement PayPal/Huawei.
- Appelez cet outil lorsque l'utilisateur demande les prix, l'adhésion ou les forfaits ; relayez les prix fidèlement, ne prenez pas de décision d'achat à la place de l'utilisateur.
whoami — Vérification d'identité
- Aucun paramètre. Lorsque l'utilisateur est autorisé, retourne les informations du compte PowPop (pseudo, nombre de badges, statut d'adhésion) ; lorsqu'il n'est pas autorisé, indique la méthode de connexion.
- Avant d'effectuer toute action « en tant qu'utilisateur », ou lorsque l'utilisateur demande son identité/état de connexion, appelez d'abord cet outil.
Gestion des erreurs et récupération
| Phénomène | Cause | Traitement |
|---|---|---|
| 401 / Non autorisé | OAuth non terminé ou expiré | Guidez l'utilisateur pour réautoriser PowPop dans les paramètres du connecteur, puis réessayez |
Erreur lisible dans le champ error (ex. « paramètre manquant », « impossible d'analyser ») | Paramètre manquant ou entrée invalide | Corrigez les paramètres selon le message d'erreur puis réessayez ; ne renvoyez pas l'erreur anglaise brute à l'utilisateur, traduisez-la en une indication actionable en français |
| Résultat vide (0 entrée) | Aucun contenu public dans cette zone/pour ce mot-clé | Informez honnêtement l'utilisateur « Aucun résultat trouvé », suggérez-lui de changer de mot-clé, d'élargir le rayon ou de changer de lieu |
| Timeout (>30 secondes) | Serveur sans réponse | Ne réessayez pas en continu ; informez l'utilisateur de réessayer plus tard |
Confirmation des opérations à haut risque
Les 9 outils de ce connecteur sont tous en lecture seule , il n'y a pas d'opération d'écriture ou de paiement, aucune confirmation supplémentaire n'est nécessaire. En cas d'intention d'achat d'adhésion, fournissez uniquement les informations de prix de list_membership_plans, guidez l'utilisateur pour finaliser l'achat dans l'application PowPop, ne prenez pas de décision à sa place dans la conversation.
Dernière synchronisation : 2026-10-18, correspond à la version du serveur MCP powpow-mcp 0.14.5 (9 outils). En cas de modification du contrat des outils du serveur (ajout/suppression/modification de paramètres), ce fichier doit être mis à jour et la version du connecteur doit être augmentée pour une nouvelle soumission ; les corrections internes pures du serveur ne nécessitent pas de mise à jour.