Serveur MCP

Ce que fait le serveur MCPCopier le lien

Le Model Context Protocol (MCP) permet à un assistant IA d'utiliser des outils extérieurs. Le serveur MCP de Nudge donne à votre assistant les mêmes actions que l'application Nudge : consulter et modifier contacts, rendez-vous, formulaires, workflows, agents, bases de connaissance, intégrations, analyses, équipe, facturation et réglages. La référence des outils liste les 224 outils.

Quelques demandes possibles une fois connecté :

• « Quels rendez-vous ai-je demain, et lesquels risquent un no-show ? »
• « Trouve les leads en attente dans À valider et résume les trois meilleurs. »
• « Ajoute un webhook qui envoie les nouveaux leads vers https://hooks.example.com/nudge. »
• « Qu'ont le plus demandé les visiteurs sur la page tarifs ce mois-ci ? »

Connecter votre assistantCopier le lien

Les noms de menus changent souvent dans les applications tierces ; si un libellé diffère, cherchez « connecteurs », « intégrations » ou « serveurs MCP ».

Ce que vous autorisezCopier le lien

L'écran de consentement indique « Connecter client à AskNudge » et précise que l'assistant pourra agir avec vos droits actuels dans vos espaces Nudge, et qu'il pourra consulter, créer, modifier et supprimer des données, gérer les accès et la facturation. Autoriser donne l'accès, Refuser le décline.

L'accès dure jusqu'à ce que vous le révoquiez : les clients qui ont demandé offline_access renouvellent leur jeton seuls. Pour couper l'accès, retirez le connecteur dans votre client ou déconnectez vos sessions dans Nudge.

Se connecter avec un jeton de sessionCopier le lien

Pour un client qui ne sait pas faire d'OAuth mais peut envoyer un en-tête Authorization, vous pouvez utiliser une copie de votre session.

const { token, expiresAt } = await fetch('/api/mcp/token', {
  method: 'POST',
  headers: { 'x-mcp-token-request': '1' },
}).then((response) => response.json())
console.log(token, expiresAt)

Comment les outils sont appelésCopier le lien

Les noms d'outils suivent la forme module__action, par exemple bookings__list_bookings ou contacts__update_contact. Chaque outil prend deux arguments :

Vous les écrivez rarement vous-même : l'assistant lit la description de chaque outil et les remplit. Par exemple, pour annuler un rendez-vous :

{
  "name": "bookings__cancel_booking",
  "arguments": {
    "orgSlug": "acme",
    "args": ["bk_4n7q2w9e5r1t8y3a", { "reason": "Le client a demandé à reporter." }]
  }
}

Le résultat est la valeur renvoyée par l'action, en texte JSON. Quand une action refuse (permission manquante, données invalides, identifiant inconnu), l'outil renvoie un résultat d'erreur avec un message lisible, par exemple Forbidden: bookings.cancel.

Envoyer des fichiersCopier le lien

Trois outils prennent un fichier : knowledge__upload_document, avatar__upload_avatar et avatar__upload_org_logo. L'assistant transmet le fichier en base64 dans un objet _formData, jusqu'à 8 Mo par fichier :

{
  "orgSlug": "acme",
  "args": [{ "_formData": { "file": { "name": "tarifs.pdf", "type": "application/pdf", "base64": "JVBERi0x…" }, "baseId": "…" } }]
}

Indications sur les outilsCopier le lien

Chaque outil porte les annotations MCP standard pour que votre client sache quand demander confirmation : readOnlyHint pour les lectures (get_…, list_…, count_…, find_…, check_…), destructiveHint pour les actions qui suppriment, effacent, révoquent, déconnectent ou annulent, et openWorldHint pour celles qui sortent de Nudge (envoi d'e-mails, imports, paiement).

LimitesCopier le lien

Le serveur n'accepte les requêtes de navigateur que depuis l'application Nudge, claude.ai et chatgpt.com. Les applications de bureau, les IDE et les clients côté serveur n'envoient pas d'en-tête Origin et ne sont pas concernés.

DépannageCopier le lien