Aller au contenu principal

MCP et agents

Laissez votre assistant IA créer images et vidéos

Le serveur MCP officiel donne à Claude, Cursor, Codex, VS Code et d’autres assistants l’accès au catalogue de modèles en direct, aux devis exacts et à la création de tâches. Vous demandez avec vos mots, et il s’arrête pour obtenir votre confirmation avant tout débit.

Créer une clé APIGuide complet dans la documentation

Qu’est-ce qu’un serveur MCP ?

MCP (Model Context Protocol) est un standard pour donner de nouveaux outils à un assistant IA. Ajoutez le serveur SpicyAPI et votre assistant peut parcourir les modèles, vérifier les prix et créer images ou vidéos pour vous.

  1. Vous et votre assistantClaude, Cursor, Codex, VS Code…
  2. Serveur MCP SpicyAPITourne sur votre ordinateur via npx
  3. Modèles d’image et de vidéoCatalogue en direct, prix exacts
L’assistant choisit l’outil à appeler. Tout ce qui coûte de l’argent s’arrête et attend votre accord.

Idéal pour

  • Des visuels en codantDemandez une image d’en-tête ou un clip produit sans quitter l’éditeur.
  • Explorer les modèlesDemandez quel modèle convient à un besoin et combien il coûtera.
  • Lots en mains libresLaissez l’agent créer, attendre et récupérer plusieurs tâches.

Ce qui se passe quand vous demandez

  1. Étape 1Trouve un modèle adapté dans le catalogue en direct et lit ce qu’il accepte
  2. Étape 2Envoie votre fichier local, s’il y en a un
  3. Étape 3Obtient un devis exact en dollars US et vous demande votre accord avant tout débit
  4. Étape 4Lance la tâche, l’attend et vous remet le lien du résultat
Exemple de session

  1. Vous: Transforme beach.jpg en un clip de six secondes de vagues au coucher du soleil.

  2. spicyapi_models_listspicyapi_model_get
    Assistant: Modèle vidéo trouvé, avec image de départ
  3. spicyapi_upload_file
    beach.jpg envoyé
  4. spicyapi_task_quote

    Voici le prix exact en dollars US. Créer la tâche ?

  5. spicyapi_task_createspicyapi_task_wait
    Terminé. Voici votre lien de téléchargement.
Illustration d’une session type. Rien n’est débité avant votre approbation.

Ajoutez-le à votre assistant

Chaque client lance le même serveur local via npx. Choisissez le vôtre pour obtenir la commande ou le bloc de configuration exact.

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

Un seul serveur stdio pour tous les clients MCP. Collez le bloc dans le fichier de configuration du client.

Les clients tiers changent de format de configuration d’une version à l’autre. Si un extrait ici ne correspond plus, c’est la documentation du client qui fait foi.

Vous utilisez Claude ? Générer des images et des vidéos depuis Claude →

Outils exposés

Les outils en lecture seule sont gratuits. Les deux outils qui dépensent de l’argent, et celui qui supprime du contenu, vous demandent toujours confirmation d’abord.

GratuitGratuits, en lecture seule12

  • spicyapi_service_statusContrôle d’état public, sans clé
  • spicyapi_docs_searchRechercher dans la documentation intégrée
  • spicyapi_models_listModèles activés et vos prix
  • spicyapi_model_getUn modèle et son schéma d’entrée
  • spicyapi_balance_getSolde disponible, réservé et total
  • spicyapi_usage_getCe que la clé actuelle a dépensé
  • spicyapi_tasks_listTâches récentes de la clé actuelle
  • spicyapi_task_getUne tâche, avec ses liens de résultat prêts
  • spicyapi_task_waitAttendre jusqu’à 5 minutes la fin d’une tâche
  • spicyapi_task_quoteChiffrer une requête exacte sans la créer
  • spicyapi_upload_fileEnvoyer un fichier local à utiliser en entrée
  • spicyapi_download_url_createUn nouveau lien de téléchargement pour un résultat

Demande confirmation avant de débiterDemandent confirmation avant d’agir3

  • spicyapi_task_createLancer une tâche de génération
  • spicyapi_task_retryRelancer une tâche échouée ou expirée
  • spicyapi_task_purgeSupprimer définitivement le contenu d’une tâche terminée
Ouvrir le paquetVoir le code source

Ajoutez l’Agent Skill pour l’ordre des appels

Le serveur MCP donne des capacités à l’agent ; l’Agent Skill lui dit comment s’en servir : lire le schéma, confirmer le devis, réutiliser une seule clé d’idempotence par tentative. Claude Code et Codex prennent en charge les deux.

Ouvrir le paquetVoir le code source
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

Fichiers que votre agent peut lire

Ces fichiers orientent assistants et outils d’intégration vers la présentation du produit, le catalogue et la documentation canonique.

agent.md

Contrat d’intégration agent et limites de sécurité, en version concise.

/agent.md →

llms.txt

Index sélectionné du site et des modèles pour la recherche IA.

/llms.txt →

llms-full.txt

Contexte étendu sur le produit, les flux, les endpoints et la découverte.

/llms-full.txt →

Manifeste agent

Découverte JSON structurée pour outils et clients autonomes.

/api/agent →

Corriger les erreurs courantes

La plupart des problèmes du début sont l’un de ces trois-là. Chaque carte montre ce que vous voyez et l’unique chose à changer.

  • outils

    Les outils n’apparaissent pas

    Redémarrez l’assistant après avoir modifié sa configuration, et vérifiez que le JSON est valide.

  • clé

    Clé API manquante

    Placez SPICY_API_KEY dans le bloc env de la configuration du serveur. Les applis de bureau ne voient pas une clé exportée dans votre shell.

  • accord

    Impossible de créer des tâches

    Votre client ne peut pas afficher de demandes de confirmation. Les outils gratuits fonctionnent ; pour créer des tâches, utilisez un client compatible avec l’elicitation MCP.

Questions fréquentes