OpenCode: OpenCode MCP (Model Context Protocol)

Última atualização: 2026-08-31

--- title: Configuração do Servidor MCP do OpenCode description: Configure servidores MCP para expandir capacidades de ferramentas e integrações externas order: 17 lang: pt-br

MCP permite que o OpenCode se conecte a ferramentas e serviços externos via protocolo padronizado, expandindo enormemente as capacidades da IA.

1. O Que Você Vai Aprender

• Conceito do protocolo MCP
• Adicionar servidores MCP
• Servidores MCP comuns
• Depuração e troubleshooting

2. O Que é MCP

MCP (Model Context Protocol) é um protocolo padronizado da Anthropic que permite modelos de IA se conectarem a ferramentas e fontes de dados externas.

Valor central: As capacidades da IA não se limitam mais às ferramentas integradas — podem ser expandidas sob demanda.

3. Adicionar Servidores MCP

Linha de comando:

opencode mcp add

Arquivo de configuração:

{
  "mcp": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/mcp-server"],
      "env": { "API_KEY": "sk-xxx" }
    }
  }
}

Ver servidores:

opencode mcp list

4. Servidores MCP Comuns

5. Exemplos de Configuração

Filesystem:

{
  "mcp": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

GitHub:

{
  "mcp": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

6. Permissões de Ferramentas MCP

Controle via tools e permission:

{
  "agent": {
    "readonly": {
      "tools": { "mymcp_*": false }
    }
  }
}

7. Depuração

opencode mcp debug

❓ FAQ

P: Servidores MCP afetam o desempenho?

R: Sim. Cada servidor MCP é um processo separado usando recursos adicionais. Adicione apenas os necessários.

P: Posso desenvolver servidores MCP personalizados?

R: Sim. MCP é um protocolo aberto. Use TypeScript ou Python. Veja https://modelcontextprotocol.io

📖 Resumo

• MCP é um protocolo padronizado para conexão IA-para-ferramentas-externas
• Adicione via opencode mcp add ou arquivo de configuração
• Servidores comuns: filesystem, GitHub, PostgreSQL, search
• Controle ferramentas MCP via tools e permission
• Adicione apenas servidores necessários para evitar desperdício de recursos

📝 Exercícios

1. Básico: Adicione um servidor filesystem MCP para a IA acessar um diretório especificado.

2. Intermediário: Configure o servidor GitHub MCP para operações diretas em repositórios.

3. Avançado: Desenvolva um servidor MCP personalizado simples com funcionalidade de ferramenta específica.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós