Los modelos de lenguaje operan habitualmente en entornos aislados del sistema operativo, limitados al texto que copiamos en la ventana de chat. Este claude desktop mcp tutorial te enseñará cómo vincular el cliente oficial de Claude con tus directorios locales y herramientas externas usando el protocolo abierto Model Context Protocol (MCP) impulsado por Anthropic, manteniendo en todo momento el control de tus datos sin exponer la totalidad de tu equipo.

Qué es Model Context Protocol y qué problema resuelve

El protocolo Model Context Protocol (MCP) aborda el problema de la fragmentación de integraciones en la inteligencia artificial. En lugar de crear conectores propietarios e incompatibles para cada herramienta o fuente de datos, MCP establece un formato estándar client-server basado en JSON-RPC.

Dentro de la arquitectura de MCP, existen tres capacidades operativas fundamentales:

• Resources: Datos pasivos y estructurados que el cliente puede leer de manera similar a un archivo de solo lectura o un endpoint de consulta.
• Tools: Funciones ejecutables con efectos secundarios (como crear un archivo, ejecutar un script o interactuar con APIs) que el modelo invoca según las instrucciones del usuario.
• Prompts: Plantillas predefinidas que ayudan a estructurar interacciones contextuales complejas.

Requisitos previos para configurar servidores MCP

Antes de modificar la configuración de Claude Desktop, debes asegurar que tu entorno local cuente con las siguientes dependencias técnicas:

1. Claude Desktop instalado: La versión de escritorio oficial para macOS o Windows.
2. Entorno de ejecución Node.js: Se requiere contar con Node.js en su versión LTS 18 o superior para ejecutar servidores empaquetados mediante npx.
3. Python (opcional para herramientas específicas): En caso de usar servidores desarrollados en Python, el gestor uvx permite ejecutarlos sin fricción.

Ubicación del archivo claude_desktop_config.json

Toda la vinculación entre el cliente de Claude y los servidores locales se gestiona desde un único archivo estructurado llamado claude_desktop_config.json. Puedes editarlo abriéndolo directamente desde Claude Desktop en la ruta de interfaz Ajustes / Settings > Developer > Edit Config, o bien navegando manualmente a su ubicación en disco:

Paso a paso en este Claude Desktop MCP tutorial

A continuación se detalla el proceso completo para integrar el servidor oficial de sistema de archivos (@modelcontextprotocol/server-filesystem) y el conector de repositorios de GitHub (@modelcontextprotocol/server-github).

Estructura del archivo de configuración

El siguiente bloque representa la sintaxis JSON utilizada para registrar tanto el servidor de archivos como el conector de GitHub de forma simultánea:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/usuario/Proyectos"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Seguridad y resolución de problemas comunes

El funcionamiento de MCP sobre STDIO requiere atender ciertos aspectos operacionales para evitar fallos de conexión: