Vue d'ensemble du serveur MCP

Qyvo expose sa plateforme de WhatsApp Marketing en tant que serveur Model Context Protocol. Connectez n'importe quel client compatible MCP et un agent LLM peut lister et tagger des contacts, rédiger et planifier des broadcasts, déclencher des séquences, répondre dans l'inbox et lire des analytiques — le tout limité à votre espace de travail.

Endpoint

https://www.qyvo.io/mcp

Aspect	Valeur
Transport	HTTP (paquet Laravel laravel/mcp, spec MCP 2024-11)
Auth	Authorization: Bearer <token>
Nom du serveur	Qyvo
Version du serveur	1.0.0
Outils	35, regroupés par ressource
Prompts	4 (Campaign Assistant, Segmentation, Performance, Inbox Triage)
Ressources	1 (directives Meta WhatsApp)

Toutes les opérations sont scopées automatiquement à l'espace de travail propriétaire du jeton. Vous ne pouvez rien lire, écrire ou envoyer en dehors de celui-ci.

Pourquoi MCP, et non l'API REST ?

L'API REST et le serveur MCP exposent le même espace de travail — même tenant, mêmes données, mêmes sémantiques d'écriture. Deux raisons de choisir MCP plutôt que REST :

1. Descriptions d'outils conçues pour les LLMs. Chaque outil arrive avec une description ajustée pour aider l'agent à choisir le bon. L'annotation IsDestructive(false) permet aux clients (Claude Code, Cursor) d'auto-approuver les opérations sûres sans solliciter l'utilisateur à chaque appel.
2. Ressources et prompts. Le serveur MCP publie une ressource Guidelines qui rappelle à l'agent la politique Meta (fenêtre 24 h, opt-in, catégories de templates), et quatre Prompts qui pré-emballent les workflows courants.

Si vous écrivez votre propre code applicatif, REST est plus simple. Si vous connectez un agent LLM, MCP est la bonne surface.

Chemins rapides

• Démarrage rapide — générez un jeton et vérifiez le handshake.
• Connecter un client :
  • Claude Desktop
  • Cursor
  • ChatGPT
  • n8n
• Référence des outils — le catalogue complet des 35 outils, par ressource.
• Exemples de prompts — quoi demander à l'agent une fois connecté.

Portée et sécurité

• Chaque outil résout le tenant à partir du jeton bearer. Il n'y a aucune façon d'opérer cross-tenant.
• Les outils en lecture seule (list_*, get_*) sont annotés IsReadOnly et IsIdempotent. Les clients qui respectent les annotations les auto-approuvent silencieusement.
• Les outils à effet de bord mais réversibles (create_*, update_*, tag_*, trigger_*, send_message, import_contacts, sync_templates) sont annotés IsDestructive(false). La plupart des clients sollicitent quand même la première fois, puis proposent « toujours autoriser ».
• Les outils réellement destructeurs (delete_contact, delete_segment, delete_broadcast, delete_template) sont annotés IsDestructive et les clients sollicitent une confirmation à chaque appel.