Intégration MCP

Le Model Context Protocol (MCP) est une norme ouverte pour connecter les assistants IA à des outils externes et des sources de données. Scavio exécute un serveur MCP qui donne à tout client compatible l'accès à 11 outils couvrant Google Search, Amazon, Walmart, YouTube et Reddit. La configuration prend moins de 2 minutes.

Prérequis

1. Obtenez votre clé API sur dashboard.scavio.dev
2. Remplacez YOUR_SCAVIO_API_KEY dans les exemples ci-dessous par votre clé réelle

Claude Code

Exécutez cette commande unique dans votre terminal :

claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

Pour l'ajouter à une configuration de projet partagée (suivie par le contrôle de version), utilisez --scope project :

claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

Alternativement, ajoutez la configuration JSON directement :

claude mcp add-json scavio '{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}'

Vérifiez la connexion :

claude mcp list

Claude Desktop

1. Ouvrez Claude Desktop
2. Allez dans Paramètres > Développeur > Modifier la configuration
3. Ajoutez Scavio à votre claude_desktop_config.json :

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Enregistrez et redémarrez Claude Desktop

Emplacement du fichier de configuration :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Cursor

1. Ouvrez Cursor et allez dans Paramètres > Outils & MCP
2. Cliquez sur + Ajouter un nouveau serveur MCP
3. Sélectionnez le type HTTP et saisissez :
   • Nom : scavio
   • URL : https://mcp.scavio.dev/mcp
   • En-têtes : x-api-key: YOUR_SCAVIO_API_KEY
4. Cliquez sur Enregistrer

Ou modifiez manuellement .cursor/mcp.json à la racine de votre projet (ou ~/.cursor/mcp.json pour une configuration globale) :

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

1. Ouvrez Windsurf et cliquez sur l'icône marteau dans Cascade
2. Cliquez sur Configurer pour ouvrir la configuration MCP
3. Ajoutez Scavio à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Enregistrez le fichier et actualisez Windsurf

VS Code (GitHub Copilot)

1. Créez .vscode/mcp.json à la racine de votre projet :

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

2. Ouvrez la Palette de commandes (Ctrl+Shift+P / Cmd+Shift+P)
3. Exécutez MCP : Lister les serveurs pour vérifier la connexion

Pour une configuration globale, ajoutez la même configuration aux paramètres utilisateur de VS Code sous mcp.servers.

ChatGPT

ChatGPT prend en charge les serveurs MCP distants via sa fonctionnalité Apps & Connecteurs :

1. Allez dans Paramètres ChatGPT > Apps & Connecteurs
2. Cliquez sur Ajouter un connecteur personnalisé
3. Saisissez l'URL du serveur MCP : https://mcp.scavio.dev/mcp
4. Configurez l'authentification avec votre clé API
5. Enregistrez et commencez à utiliser les outils Scavio dans vos conversations

La prise en charge MCP de ChatGPT nécessite un abonnement Plus ou Team et peut nécessiter une configuration OAuth selon votre configuration.

Cline (Extension VS Code)

1. Ouvrez VS Code avec Cline installé
2. Cliquez sur l'icône Serveurs MCP dans la barre latérale de Cline
3. Cliquez sur Configurer les serveurs MCP
4. Ajoutez Scavio à la configuration :

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

5. Enregistrez et Cline détectera automatiquement le nouveau serveur

Zed Editor

1. Ouvrez Paramètres (Cmd+,)
2. Naviguez vers la section Assistant
3. Ajoutez Scavio sous les serveurs MCP :

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

Tout client compatible MCP

Scavio fonctionne avec tout outil prenant en charge le Model Context Protocol. La configuration universelle :

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

Outils disponibles

Une fois connecté, votre assistant IA peut utiliser ces 11 outils :

Dépannage

Le serveur ne se connecte pas ?

• Vérifiez que votre clé API est correcte et active
• Vérifiez vos crédits avec get_usage ou sur dashboard.scavio.dev
• Assurez-vous que l'URL est exactement https://mcp.scavio.dev/mcp (sans barre oblique finale)

Les outils n'apparaissent pas ?

• Redémarrez votre client IA après avoir ajouté la configuration
• Vérifiez les erreurs de syntaxe JSON dans votre fichier de configuration
• Confirmez que le serveur MCP apparaît comme "connecté" dans les paramètres MCP de votre client

Prochaines étapes

• API Google Search -- référence complète des points de terminaison
• API Amazon -- recherche de produits et détails
• API YouTube -- recherche et métadonnées
• API Walmart -- recherche de produits et détails
• API Reddit -- recherche de publications et commentaires imbriqués
• Limites de débit -- limites par forfait et en-têtes