OpenCode: OpenCode MCP (Model Context Protocol)

Last updated: 2026-08-31

--- title: OpenCode MCP Server Configuration description: Configure MCP servers to extend tool capabilities and external integrations order: 17 lang: en

MCP lets OpenCode connect to external tools and services via a standardized protocol, greatly expanding AI capabilities.

1. What You Will Learn

• MCP protocol concept
• Adding MCP servers
• Common MCP servers
• Debugging and troubleshooting

2. What is MCP

MCP (Model Context Protocol) is a standardized protocol by Anthropic that lets AI models connect to external tools and data sources.

Core value: AI capabilities are no longer limited to built-in tools—they can be extended on demand.

3. Adding MCP Servers

Command line:

opencode mcp add

Config file:

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

View servers:

opencode mcp list

4. Common MCP Servers

5. Configuration Examples

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. MCP Tool Permissions

Control MCP tools via tools and permission config:

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

7. Debugging

opencode mcp debug

❓ FAQ

📖 Summary

• MCP is a standardized protocol for AI-to-external-tool connections
• Add via opencode mcp add or config file
• Common servers: filesystem, GitHub, PostgreSQL, search
• Control MCP tools via tools and permission config
• Only add needed servers to avoid resource waste

📝 Exercises

1. Basic: Add a filesystem MCP server for AI to access a specified directory.

2. Intermediate: Configure GitHub MCP server for direct GitHub repository operations.

3. Advanced: Develop a simple custom MCP server providing specific tool functionality.

Web-Tutorial Tech Team

A team of developers maintaining programming tutorials. Each tutorial is written and reviewed by developers with expertise in that field. We work to keep our content accurate and reliable — if you spot an issue, please let us know.

About Us