Cómo instalar MCP para agentes de IA

Guía completa del Model Context Protocol (MCP): qué es, cómo funciona y cómo configurar servidores MCP en OpenCode, Claude Code y Cursor. Incluye 20 servidores listos para usar.

¿Qué es MCP?

Model Context Protocol (MCP) es un protocolo abierto estandarizado por Anthropic que permite a los asistentes de IA conectarse con herramientas externas — bases de datos, sistemas de archivos, APIs, navegadores — a través de un mismo contrato.

Piensa en MCP como USB-C para la IA: un conector universal donde cada servidor MCP es un periférico que le da superpoderes al asistente. En lugar de que cada IA implemente su propia integración con GitHub, Postgres o el sistema de archivos, MCP unifica todo bajo un mismo protocolo.

Cómo funciona

MCP sigue una arquitectura cliente-servidor:

• Cliente MCP — el asistente IA (OpenCode, Claude Code, Cursor, etc.) que se conecta a los servidores
• Servidor MCP — un proceso que expone herramientas (tools), recursos (resources) y plantillas (resource templates) que la IA puede usar
• Protocolo — comunicación via JSON-RPC sobre stdio (local) o HTTP+SSE (remoto)

Cada servidor MCP declara qué tools ofrece. Por ejemplo, el servidor filesystem expone tools como read_file, write_file, list_directory. La IA decide cuándo llamarlas según la tarea.

Types de servidores

• Locales (stdio) — se ejecutan como procesos hijo. El más común. Ej: filesystem, github, sqlite
• Remotos (HTTP+SSE) — servidores en la nube a los que te conectas via URL. Ej: Supabase, Stripe, Slack

Instalación en OpenCode

OpenCode configura los MCPs en el archivo opencode.json de la raíz del proyecto. Cada servidor se define como un objeto con command, args y env:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/ruta/al/proyecto"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Para activarlos, abre OpenCode y usa el comando:

opencode
# OpenCode detecta automáticamente los MCPs en opencode.json
# y los carga al iniciar sesión

Instalación global vs local

• Local (recomendado) — en el opencode.json del proyecto. Los MCPs están disponibles solo en ese proyecto
• Global — en ~/.config/opencode/opencode.json. Los MCPs están disponibles en todos los proyectos

Instalación en Claude Code

Claude Code usa el mismo formato. Crea o edita el archivo claude.json en la raíz del proyecto:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

Instalación en Cursor

En Cursor ve a Settings → Cursor Settings → MCP Servers → Add New Server. Cada servidor se configura con nombre, comando y args.

Seguridad y permisos

Cada servidor MCP tiene acceso a lo que su configuración permita. Un servidor filesystem mal configurado podría leer todo tu disco. Buenas prácticas:

• Limita los directorios que expone el servidor filesystem a solo lo necesario
• Usa tokens con permisos mínimos (GitHub token de solo lectura si no necesitas escribir)
• No compartas opencode.json con tokens en repositorios públicos
• Usa variables de entorno para los tokens, nunca valores hardcodeados

Solución de problemas

• El MCP no aparece: verifica que el comando existe y que los args son correctos. Prueba ejecutar el comando manualmente en tu terminal
• Error de conexión: los servidores locales se comunican por stdio. Si el proceso falla al iniciar, el MCP no estará disponible
• Token inválido: verifica que las variables de entorno están bien escritas y que los tokens no han expirado
• Logs: revisa la salida del servidor. La mayoría escribe errores a stderr que el cliente captura

Verifica que funciona

Una vez configurado, abre OpenCode y pide algo como "Lista los archivos del directorio actual" (usa filesystem) o "Busca en mi repo issues etiquetados como bug" (usa GitHub). Si el asistente responde con datos reales, el MCP está funcionando.