Configurer Pneumatic avec MCP

Le MCP Pneumatic relie un assistant IA à votre compte pour qu’il fasse la configuration avec vous. Cursor, Claude et tout autre client qui parle MCP peuvent créer des modèles, lancer des workflows, terminer des tâches, abonner des webhooks et configurer des fournisseurs et des agents IA. L’assistant agit en tant que l’utilisateur derrière la clé API que vous lui donnez.

Créer une clé pour l’assistant

  1. Connectez-vous à Pneumatic.
  2. Ouvrez Integrations dans le menu de gauche.
  3. Sous Your API Keys, choisissez Create.
  4. Nommez la clé pour la reconnaître plus tard, par exemple MCP.
  5. Copiez la clé quand Pneumatic l’affiche. La clé complète n’est visible que cette fois.

Révoquez cette clé sur le même écran quand vous voulez que l’assistant s’arrête. Tout ce qui utilise encore la clé s’arrête avec elle.

Les administrateurs et les propriétaires du compte créent et révoquent les clés. Les utilisateurs invités ne peuvent pas appeler l’API.

Ajouter le serveur

L’adresse du serveur est https://mcp.pneumatic.app/mcp.

Envoyez la clé à chaque requête :

Authorization: Bearer YOUR_API_KEY

Cursor

Créez .cursor/mcp.json dans le projet, ou ajoutez le même bloc dans les réglages Cursor, sous MCP.

{
  "mcpServers": {
    "pneumatic": {
      "url": "https://mcp.pneumatic.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Rechargez la fenêtre, puis demandez à l’assistant de lister vos modèles. Une liste de modèles de votre compte signifie que la connexion fonctionne.

Claude

Ajoutez un connecteur personnalisé et collez https://mcp.pneumatic.app/mcp. Si le connecteur a un champ d’en-tête, utilisez la même valeur Authorization. S’il ouvre une page dans le navigateur, connectez cette page avec cette clé API.

Quand la page indique que le client est inconnu, retirez le connecteur et ajoutez-le de nouveau.

Tout autre client

Pointez-le vers la même URL. Un client qui gère la connexion MCP s’enregistre et ouvre le navigateur. Un client qui ne prend qu’un jeton envoie la clé API sous la forme Authorization: Bearer YOUR_API_KEY.

Que lui demander de configurer

Les droits de la clé sont les droits de l’assistant. Une clé d’administrateur peut modifier les réglages IA du compte. Une clé de membre peut travailler avec les modèles, workflows et tâches que ce membre peut déjà ouvrir.

Demandez un résultat précis, puis ouvrez-le dans Pneumatic et vérifiez-le avant de vous y fier.

  • Un fournisseur IA : un nom, l’URL de base du fournisseur et la clé API de ce fournisseur.
  • Un agent IA : un nom, le fournisseur, le modèle et le prompt système.
  • Un modèle de workflow : décrivez le processus, puis relisez les étapes, les exécutants et les champs.
  • Une exécution de workflow : le modèle et les valeurs de lancement.
  • Un webhook : les événements à envoyer et l’URL qui doit les recevoir.

La référence champ par champ est la documentation API.

Quand le client ne se connecte pas

  • La requête n’a pas d’en-tête Authorization. Le serveur répond que l’en-tête est absent.
  • La clé est fausse, copiée avec un espace, ou déjà révoquée. Le serveur répond que la clé API Pneumatic est invalide ou révoquée. Créez une nouvelle clé. L’ancienne ne peut plus être affichée.
  • L’en-tête n’a pas le préfixe Bearer .
  • La page du navigateur indique que le client est inconnu. Retirez le connecteur dans le client MCP et ajoutez-le de nouveau.