Configuração do OpenCode MCP: 7 passos para servidores locais e remotos

Este guia cobre uma intenção específica: adicionar, autenticar, validar, limitar e corrigir ferramentas MCP. Instalação geral, Ollama e sessões continuam em páginas próprias para evitar canibalização.

Os exemplos seguem o schema e os comandos oficiais atuais. O provedor pode mudar URL, pacote, escopos ou autenticação; confirme tudo na documentação original e nunca execute pacote desconhecido em repositório sensível.

Servidor local é um processo filho iniciado pelo OpenCode. Serve para pacotes CLI confiáveis e ferramentas que precisam de arquivos locais. Runtime, gerenciador, diretório, ambiente e permissões determinam sua estabilidade.

Servidor remoto é um endpoint HTTP, útil para documentação, monitoramento e bancos compartilhados. Em troca, depende de rede e autenticação. Escolha o transporte oficialmente suportado.

O OpenCode combina fontes de configuração. Ferramentas comuns ficam no global e as específicas do repositório em opencode.json. Segredos pertencem ao ambiente ou OAuth, nunca ao Git.

Dê a cada servidor um nome estável e descritivo. Ele aparece em prompts, prefixos e regras por agente. enabled: false mantém uma integração documentada sem carregá-la sempre.

Entrada local exige type: "local" e array command. Verifique publicador e código, fixe versão quando estabilidade importar e teste fora de diretórios sensíveis.

Passe tokens por environment. Comece com leitura e conta de desenvolvimento. A ferramenta preserva todos os privilégios do token, mesmo quando o modelo parece limitado.

{
  "$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}" }
    }
  }
}

Troque o pacote fictício somente pelo comando oficial do proprietário.

Entrada remota exige type: "remote" e HTTPS. Use headers apenas conforme o provedor. OAuth pode iniciar automaticamente ou por opencode mcp auth <server-name>.

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

Confira opencode mcp list e use opencode mcp debug <server-name> para conexão ou OAuth. Depois faça consulta somente leitura e compare com o sistema de origem.

Registre nome, pacote ou URL, runtime, autenticação, prefixo, prompt de teste, timeout e rollback. Isso transforma um experimento em configuração reproduzível.

1. Confirmar fornecedorUsar pacote, endpoint e autenticação oficiais.
2. Escolher escopoGlobal, projeto ou agente especializado.
3. Adicionar entradaAtivar um servidor novo por vez.
4. Proteger segredosAmbiente ou OAuth, nunca Git.
5. Listar e depurarChecar estado, conexão e OAuth.
6. Testar leituraComparar com o sistema de origem.
7. Liberar escritaApós logs, diff e rollback.

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

Descrições das ferramentas ocupam contexto. Desative servidores amplos e restrinja-os ao agente especializado. Compare qualidade e tokens antes e depois.

Antes de compartilhar logs ou credenciais, leia o guia de sessões e privacidade do OpenCode e consulte o guia OpenCode Ollama se os MCPs rodarem com modelo local de contexto menor.

Investigue por camadas: processo ou endpoint, autenticação, descoberta no OpenCode e por fim prompt ou política. Alterar várias camadas esconde a causa.

Para Figma ou Supabase, siga primeiro a instalação oficial do fornecedor e depois esta lista comum. JSON genérico pode ignorar região, projeto e permissões.

Em equipe, revise o MCP como uma dependência: registre versão ou endpoint, escopos, runtime, responsável pela atualização e procedimento de revogação. Depois de qualquer upgrade, repita a consulta de leitura e confirme que nomes e parâmetros das ferramentas continuam compatíveis antes de liberar escrita.

Para instalação básica, volte ao guia de implantação do OpenCode. A precedência e as opções oficiais estão nas fontes.