L'interface en ligne de commande opencode et les agents de codage similaires découvrent les serveurs MCP depuis la configuration. Ajouter Scavio offre à l'agent une recherche en direct sur Google SERP, Reddit, YouTube et la documentation en une seule classe d'outils. Ce tutoriel le met en place en moins de 10 minutes.
Prérequis
- opencode CLI installé
- Une clé API Scavio
- Node.js 20+ (pour le pont mcp-remote)
Parcours
Étape 1: Ouvrir la configuration MCP d'opencode
opencode lit les serveurs MCP depuis ~/.opencode/mcp.json.
Bash
mkdir -p ~/.opencode && touch ~/.opencode/mcp.jsonÉtape 2: Enregistrer le Scavio MCP
Utiliser mcp-remote pour relier HTTP SSE à un processus CLI.
JSON
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.scavio.dev/mcp"],
"env": { "SCAVIO_API_KEY": "${SCAVIO_API_KEY}" }
}
}
}Étape 3: Exporter la clé API
Charger depuis votre shell rc pour que le CLI l'hérite.
Bash
echo 'export SCAVIO_API_KEY=sk_live_...' >> ~/.zshrc && source ~/.zshrcÉtape 4: Vérifier que les outils sont visibles
Démarrer opencode et lister les outils.
Bash
opencode
> /tools
# Expect scavio_search, scavio_reddit, scavio_youtubeÉtape 5: Tester une requête en direct
Demander quelque chose qui nécessite des données fraîches.
Bash
> what does the latest r/opencodeCLI thread on web search say?Exemple Python
Python
# opencode CLI is a CLI-first tool; no Python setup needed.
# To test the MCP endpoint directly:
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': 'opencode CLI web search'})
print(r.json().get('organic_results', [])[:3])Exemple JavaScript
JavaScript
// opencode discovers tools from mcp.json; no JS code required.
// Direct API call for parity:
const API_KEY = process.env.SCAVIO_API_KEY;
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query: 'opencode CLI web search' })
});
console.log(((await r.json()).organic_results || []).slice(0, 3));Sortie attendue
JSON
opencode CLI exposes scavio_* tools in /tools. The agent calls them automatically when the user question needs live data.