El blog de Deska

Configuración de servidores MCP para Claude Code

Guía técnica para configurar servidores MCP en Claude Code y extender las capacidades del agente con fuentes de datos locales y remotas.

2 de agosto de 2026 · 10 min de lectura

Claude Code representa un cambio en la forma en que los desarrolladores interactúan con los modelos de lenguaje de gran tamaño al mover la interfaz directamente a la terminal. Sin embargo, la verdadera utilidad de esta herramienta surge cuando comienzas con la configuración de servidores MCP para Claude Code. El Model Context Protocol (MCP) funciona como un estándar abierto que permite a los agentes de IA acceder a fuentes de datos y herramientas específicas que no forman parte de su entrenamiento principal. Al configurar estos servidores, le otorgas a Claude la capacidad de leer tu sistema de archivos local, interactuar con bases de datos o consultar información en tiempo real desde APIs externas.

Comprendiendo el rol de MCP en Claude Code

El Model Context Protocol actúa como un puente. Aunque Claude Code tiene capacidades integradas para editar archivos y ejecutar comandos de consola, permanece aislado de muchos entornos de datos especializados. Los servidores MCP resuelven esto proporcionando una forma estructurada para que el agente consulte sistemas externos. Cuando conectas un servidor MCP, esencialmente le das a Claude un nuevo conjunto de ojos y manos para tareas específicas.

Esta arquitectura es beneficiosa por varias razones. Mantiene la seguridad al asegurar que el agente solo acceda a lo que el servidor expone. También permite la modularidad. Puedes intercambiar servidores o actualizarlos sin cambiar la configuración principal de tu agente. Para los desarrolladores que trabajan en entornos complejos, esto significa que Claude puede entender de repente tus tickets de Jira, tu historial de Slack o tu esquema de PostgreSQL.

Requisitos básicos para la configuración de MCP

Antes de comenzar el proceso de configuración, asegúrate de que tu entorno esté listo tanto para el agente como para el protocolo. Necesitarás una instalación funcional de Claude Code, que normalmente requiere un entorno de Node.js.

Node.js versión 18 o superior es generalmente recomendada.
Una clave de API de Anthropic válida.
La utilidad mcp-get o un gestor de paquetes similar para servidores MCP.
Un emulador de terminal que soporte sesiones interactivas.

Una vez que estos elementos básicos estén en su lugar, el proceso consiste en definir dónde viven tus servidores y cómo debe ejecutarlos Claude.

Guía paso a paso: Configuración de servidores MCP para Claude Code

La configuración de los servidores MCP en Claude Code se gestiona a través de un archivo JSON. Este archivo le indica al agente qué comandos ejecutar para iniciar el servidor y qué variables de entorno son necesarias para la autenticación.

Identificación del archivo de configuración

Claude Code busca su configuración en un directorio específico según tu sistema operativo. Por lo general, se encuentra en tu directorio de inicio dentro de una carpeta oculta. Debes buscar un archivo llamado claude_desktop_config.json o un archivo específico claude-code.json. Aunque Claude Code es una herramienta de línea de comandos, a menudo comparte la lógica de configuración de MCP con la versión de escritorio de la interfaz de Claude.

Añadir un servidor local

Si tienes un script local que quieres que Claude utilice, debes definirlo en el objeto mcpServers. Por ejemplo, si tienes un script de Python que actúa como servidor MCP para tu documentación interna, tu configuración se vería así:

{
  "mcpServers": {
    "my-internal-docs": {
      "command": "python",
      "args": ["/ruta/hacia/tu/mcp-server.py"],
      "env": {
        "API_KEY": "tu-valor-secreto"
      }
    }
  }
}

Uso de servidores preconfigurados

Muchos desarrolladores prefieren usar servidores mantenidos por la comunidad. El ecosistema MCP incluye servidores listos para usar para Google Drive, GitHub y Slack. Para usarlos, a menudo apuntas el comando a npx seguido del nombre del paquete del servidor. Esto asegura que el servidor se ejecute sin requerir una instalación global manual en tu máquina.

Gestión de múltiples entornos de agentes en Deska

Aunque ejecutar Claude Code en una terminal estándar es efectivo, gestionar múltiples agentes y sus respectivos contextos MCP puede volverse desordenado. Aquí es donde Deska ofrece un enfoque diferente para el flujo de trabajo del desarrollador. En lugar de una sola ventana de terminal, puedes usar un lienzo infinito para organizar tu trabajo.

En Deska, puedes ejecutar Claude Code, Codex CLI y OpenCode uno al lado del otro como paneles individuales. Este diseño te permite monitorear cómo responden diferentes agentes a las mismas configuraciones de servidores MCP. Por ejemplo, podrías tener un panel de terminal ejecutando Claude con acceso a tu MCP de base de datos, mientras otro terminal ejecuta un agente diferente enfocado en archivos de frontend.

Deska es una aplicación de escritorio gratuita disponible para Mac, Windows y Linux. Está construida como un entorno local-first, lo que significa que tu código, archivos y sesiones de agentes permanecen en tu máquina. Esto se alinea bien con los objetivos de seguridad de MCP, ya que el flujo de datos se mantiene dentro de tu red local en la medida de lo posible.

Comparación de Claude Code con otros espacios de trabajo de IA

El panorama de herramientas para desarrolladores se está expandiendo rápidamente. Herramientas como Cursor, Windsurf y Deska ofrecen formas de integrar la IA en el proceso de programación, pero difieren en su enfoque.

Función	Claude Code (CLI)	IDEs de IA tradicionales	Deska
Interfaz	Solo terminal	Centrada en código	Lienzo infinito
Soporte MCP	Nativo	Varía según plugin	Mediante paneles
Privacidad	Archivos locales	Nube o local	Local-first
Multi-Agente	Secuencial	Limitado	Lado a lado

Los IDEs de IA tradicionales se centran mucho en el editor mismo. Proporcionan una excelente autocompletado y refactorización en línea. Claude Code se centra en el poder de la línea de comandos y la autonomía del agente. Deska actúa como un gestor de espacio de trabajo que te permite combinar estas herramientas. Puedes usar el editor de código Monaco dentro de un panel de Deska mientras ejecutas Claude Code en un panel de terminal adyacente, obteniendo lo mejor de ambos mundos.

Resolución de problemas comunes de MCP

La configuración de servidores MCP para Claude Code no siempre es perfecta. Aquí hay obstáculos comunes y cómo abordarlos:

Permiso denegado: Asegúrate de que el usuario que ejecuta la terminal tenga derechos de ejecución para el script o binario del servidor.
Errores de ruta: Utiliza siempre rutas absolutas en tu configuración JSON. Las rutas relativas a menudo se resuelven en el directorio incorrecto cuando el agente inicia el proceso del servidor.
Versión de Node incompatible: Si un servidor MCP utiliza características modernas de JavaScript, asegúrate de que tu versión global de node coincida con los requisitos.
Variables de entorno: Algunos servidores requieren claves específicas como GITHUB_TOKEN. Si estas faltan en el bloque env de tu configuración, el servidor no se inicializará.

Si encuentras problemas persistentes con las sesiones de terminal, el asistente Ask Deska puede ayudarte a gestionar tu espacio de trabajo. Puedes pedirle que abra paneles específicos o que verifique el estado de tus sesiones actuales, lo cual es útil al depurar configuraciones complejas de múltiples agentes.

FAQ: Configuración de servidores MCP para Claude Code

¿Cómo añadir Google Drive a Claude Code mediante MCP?

Para añadir Google Drive, debes configurar un servidor que utilice la API de Google Workspace. Necesitarás crear credenciales en Google Cloud Console, descargar la clave JSON y luego referenciar un servidor MCP de Google Drive de la comunidad en tu archivo de configuración de Claude, pasando las credenciales como variables de entorno.

¿Por qué mi servidor MCP no aparece en Claude Code?

Esto suele ocurrir debido a un error de sintaxis en el archivo claude_desktop_config.json o una ruta incorrecta al ejecutable del servidor. Verifica que tu JSON sea válido y que el comando listado en la configuración pueda ejecutarse manualmente en tu terminal. Revisa los registros en la terminal donde iniciaste Claude Code para ver errores de inicialización.

¿Puedo ejecutar varios servidores MCP a la vez?

Sí, el objeto mcpServers en el archivo de configuración puede contener múltiples entradas. Claude Code inicializará todos los servidores listados al arrancar, permitiendo que el agente obtenga contexto de varias fuentes como GitHub, Slack y tu sistema de archivos local simultáneamente.

Comienza con un mejor espacio de trabajo

La configuración de servidores MCP para Claude Code es el primer paso hacia una experiencia de desarrollo con IA más integrada. Al darle a tu agente las herramientas adecuadas, reduces el trabajo manual de copiar y pegar contexto. Si quieres un espacio de trabajo que te permita visualizar estos agentes y sus resultados en un lienzo infinito, prueba Deska. Puedes descargar la aplicación de forma gratuita y comenzar a ejecutar tus agentes de programación favoritos uno al lado del otro. Ya sea que uses tus propias claves de API o un plan gestionado, Deska ofrece la flexibilidad para construir tu entorno de desarrollo ideal impulsado por IA.