Configuration OpenCode MCP : 7 étapes pour serveurs locaux et distants

Ce guide couvre une intention précise : ajouter, authentifier, vérifier, limiter et dépanner des outils MCP. L'installation générale, Ollama et les sessions restent sur leurs pages dédiées afin d'éviter la cannibalisation.

Les exemples suivent le schéma et les commandes officiels actuels. Le fournisseur peut modifier URL, paquet, scopes ou authentification ; vérifiez toujours sa documentation et n'exécutez jamais un paquet inconnu dans un dépôt sensible.

Un serveur local est un processus enfant lancé par OpenCode. Il convient aux paquets CLI fiables et aux outils ayant besoin de fichiers locaux. Sa fiabilité dépend du runtime, du gestionnaire de paquets, du répertoire, des variables et des permissions.

Un serveur distant est un endpoint HTTP, pratique pour documentation, observabilité ou bases partagées. Il dépend toutefois du réseau et de l'authentification. Choisissez le transport officiellement pris en charge.

OpenCode fusionne les sources de configuration. Les outils communs vont dans la configuration globale et ceux du dépôt dans opencode.json. Les secrets restent dans l'environnement ou OAuth, jamais dans Git.

Donnez à chaque serveur un nom stable et explicite. Ce nom sert dans les prompts, préfixes et règles par agent. enabled: false permet de documenter une intégration sans la charger à chaque session.

Une entrée locale exige type: "local" et un tableau command. Vérifiez l'éditeur du paquet, fixez une version lorsque la stabilité compte et testez dans un répertoire sans données sensibles.

Injectez les jetons avec environment. Commencez en lecture seule et sur un environnement de développement : l'outil conserve les privilèges de son jeton, même si le modèle semble prudent.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "docs_search": {
      "type": "local",
      "command": ["npx", "-y", "trusted-mcp-package"],
      "enabled": true,
      "environment": { "MCP_TOKEN": "{env:MCP_TOKEN}" }
    }
  }
}

Remplacez le paquet fictif uniquement par la commande officielle du propriétaire.

Une entrée distante exige type: "remote" et HTTPS. Utilisez headers uniquement selon la documentation. OpenCode gère OAuth et permet opencode mcp auth <server-name> pour lancer volontairement le flux.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "monitoring": {
      "type": "remote",
      "url": "https://provider.example/mcp",
      "oauth": {}
    }
  }
}

Contrôlez avec opencode mcp list, puis utilisez opencode mcp debug <server-name> pour la connexion ou OAuth. Testez ensuite une requête en lecture seule et comparez-la à la source.

Consignez nom, paquet ou URL, runtime, authentification, préfixe, prompt de test, délai et retour arrière. Cette preuve rend l'installation reproductible par un autre développeur.

1. Vérifier le fournisseurUtiliser paquet, endpoint et authentification officiels.
2. Choisir la portéeGlobale, projet ou agent spécialisé.
3. Ajouter une entréeActiver un seul nouveau serveur à la fois.
4. Protéger les secretsVariables ou OAuth, jamais Git.
5. Lister et déboguerContrôler état, connexion et OAuth.
6. Tester en lectureComparer avec le système source.
7. Autoriser l'écritureAprès logs, diff et retour arrière.

opencode mcp list
opencode mcp auth <server-name>
opencode mcp debug <server-name>
opencode mcp logout <server-name>

Les descriptions d'outils consomment du contexte. Désactivez les serveurs trop larges et réservez-les à un agent spécialisé. Comparez la qualité et les tokens avant et après.

Avant de partager journaux ou identifiants, consultez le guide des sessions et de la confidentialité OpenCode puis le guide OpenCode Ollama si les MCP fonctionnent avec un modèle local au contexte réduit.

Dépannez par couches : processus ou endpoint, authentification, découverte OpenCode, puis prompt et politique. Modifier plusieurs couches simultanément masque la cause.

Pour Figma ou Supabase, suivez d'abord l'installation officielle du fournisseur, puis appliquez cette méthode commune. Un JSON générique peut ignorer permissions, région ou projet.

Pour l'installation de base, revenez au guide de déploiement OpenCode. La priorité et les options officielles figurent dans les sources.