Kudosity MCP

Le serveur Kudosity Model Context Protocol (MCP) permet aux éditeurs assistés par IA (comme Cursor et Windsurf) et aux assistants (comme Claude Desktop) d'explorer et d'exécuter directement les API Kudosity. Avec MCP, votre IA peut rechercher des spécifications d'API, générer des extraits de code et exécuter des requêtes en direct — le tout sans quitter votre environnement de développement.

Qu'est-ce que MCP ?

Model Context Protocol (MCP) est un standard ouvert qui permet aux applications d'IA d'accéder de manière sécurisée à des sources de données et des outils externes. Le serveur Kudosity MCP fournit aux agents IA :

• Accès direct à l'API aux fonctionnalités Kudosity — envoyer des messages, mettre à jour des listes de contacts, etc.
• Recherche dans la documentation — permet à votre IA de rechercher intelligemment dans les spécifications de l'API et les tutoriels pour fournir des réponses précises.
• Données en temps réel de votre compte Kudosity — interrogez et exécutez des opérations en direct directement depuis le chat.
• Génération de code pour les intégrations Kudosity
• Exécution d'API en direct — au-delà des exemples statiques, exécutez de vraies requêtes
• Toujours à jour — alimenté par les définitions de source de l'API Swagger

Capacités du serveur MCP

Le serveur Kudosity MCP offre des outils complets pour la découverte d'API, la documentation, la génération de code et l'exécution en direct :

🔍 Découverte et exploration d'API

• list-specs — découvrir les API de messagerie disponibles (SMS, RCS, WhatsApp, etc.)
• list-endpoints — lister tous les chemins et méthodes d'API pour un service
• get-endpoint — inspecter les méthodes et paramètres pris en charge pour n'importe quel chemin
• search-specs — rechercher dans les spécifications des mots-clés ou des motifs

📋 Schéma et documentation de l'API

• get-request-body — récupérer le schéma du corps de la requête pour n'importe quel point de terminaison
• get-response-schema — voir le schéma de réponse pour des points de terminaison et codes de statut spécifiques
• list-security-schemes — vérifier les méthodes d'authentification et les exigences
• search-documentation — rechercher dans le contenu de la documentation de l'API

⚡ Génération de code

• get-code-snippet — générer des exemples prêts à l'emploi en curl, JavaScript, Python, etc.
• Fournit automatiquement l'authentification et les paramètres appropriés

🚀 Exécution d'API en direct

• execute-request — exécuter de vrais appels API en utilisant le format HAR
• Envoyer des SMS de test
• Valider n'importe quel point de terminaison Kudosity avec des identifiants en direct
• Renvoie les réponses réelles et les erreurs

API disponibles

Le serveur MCP donne accès à ces API Kudosity :

• Transmit Message API — service de messagerie v2 prenant en charge SMS, RCS, MMS, WhatsApp et les webhooks
• Transmit SMS API — SMS complet avec listes de contacts avancées, mots-clés et rapports

Configuration du serveur Kudosity MCP

Kudosity héberge un serveur MCP distant à l'adresse https://developers.kudosity.com/mcp. Configurez vos outils de développement IA pour vous connecter à ce serveur.

Configuration de l'authentification

Pour les API qui nécessitent une authentification, vous devrez configurer vos identifiants API. Selon les points de terminaison, les méthodes diffèrent :

• api.transmitsms.com (points de terminaison v1) — Authentification Basic avec clé API et secret encodés en Base64
• api.transmitmessage.com (points de terminaison v2) — Authentification par clé API avec votre clé dans l'en-tête x-api-key

Pour les points de terminaison v1 (api.transmitsms.com) - Authentification Basic :

1. Obtenez vos identifiants depuis le tableau de bord Kudosity → Développeurs → Paramètres API
2. Combinez comme suit : API_KEY:API_SECRET
3. Encodage Base64 :
   • Terminal : echo -n "API_KEY:API_SECRET" | base64
   • Console du navigateur : btoa("API_KEY:API_SECRET")
   • Outil en ligne : base64encode.org

Pour les points de terminaison v2 (api.transmitmessage.com) - Authentification par clé API :

Utilisez votre clé API directement dans l'en-tête x-api-key (aucun encodage Base64 requis).

Pour les points de terminaison v1 (api.transmitsms.com) - Ajouter àclaude_desktop_config.json:

JSON

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Important : Redémarrez votre outil IA après avoir enregistré le fichier de configuration.

Vous pouvez également installer l'intégration Claude MCP pour ce projet en utilisant :

Bash

claude mcp add kudosity --scope project -- npx mcp-remote https://developers.kudosity.com/mcp

Tester votre configuration MCP

Une fois configuré, vous pouvez tester votre connexion au serveur MCP :

1. Redémarrez votre outil IA (Claude Desktop, Cursor, etc.)
2. Démarrez une nouvelle discussion avec l'assistant IA
3. Posez des questions sur Kudosity — essayez des questions comme :
   • "Quelles API Kudosity propose-t-il ?"
   • "Montrez-moi un exemple d'envoi de SMS"
   • "Créez une commande curl pour envoyer mon premier SMS via Kudosity"
   • "Comment puis-je commencer à envoyer des SMS avec Kudosity ?"

Si cela fonctionne, l'IA répondra avec des détails sur l'API Kudosity et des exemples de code extraits directement de votre compte et de la documentation.

Mis à jour il y a environ 2 mois

---

Copier la page