- El Model Context Protocol (MCP) permite integrar Claude con bases de datos, APIs y herramientas externas de forma estandarizada.
- Existen múltiples métodos de despliegue, incluyendo servidores locales mediante stdio y opciones remotas vía HTTP o WebSocket.
- La configuración de Claude Desktop se gestiona principalmente a través de un archivo JSON donde se definen los comandos y credenciales.
Si alguna vez has sentido que a Claude le falta acceso al «mundo real» para resultar verdaderamente útil, el Model Context Protocol (MCP) es precisamente la pieza que estabas buscando. Se trata de un estándar abierto para conectar asistentes de inteligencia artificial con herramientas y fuentes de datos externas, como sistemas de archivos, bases de datos, repositorios de código o aplicaciones empresariales.
Gracias a MCP, Claude puede dejar de limitarse a responder con la información incluida en una conversación. Dependiendo del servidor instalado y de los permisos concedidos, el asistente puede consultar documentos, analizar incidencias, buscar información en una base de datos o ejecutar acciones mediante herramientas externas.
La integración con Claude puede realizarse mediante servidores locales ejecutados en el propio ordenador o mediante conectores remotos accesibles a través de Internet. Sin embargo, las posibilidades reales dependen siempre de las herramientas que ofrezca cada servidor, de sus permisos y de las confirmaciones de seguridad configuradas.
Tipos de implementaciones de servidores MCP
Antes de empezar conviene distinguir entre servidores MCP locales y remotos. Los primeros se ejecutan en el ordenador del usuario y resultan especialmente útiles para acceder a archivos, scripts y aplicaciones instaladas en la propia máquina. Los segundos se alojan en Internet y permiten conectar Claude con servicios en la nube, plataformas corporativas y herramientas compartidas.
Los servidores locales suelen utilizar el transporte stdio. En este sistema, Claude inicia el servidor como un proceso independiente y se comunica con él mediante la entrada y la salida estándar. Es una opción sencilla y eficiente cuando tanto el cliente como el servidor se encuentran en el mismo equipo.
Para las conexiones remotas, el transporte recomendado actualmente es Streamable HTTP. Este sistema permite que Claude se conecte a un servidor mediante una dirección web y resulta más apropiado para servicios alojados en la nube. El antiguo transporte basado en HTTP con SSE todavía puede encontrarse en algunas implementaciones, pero se mantiene principalmente por compatibilidad con servidores anteriores.
Aunque existen servidores que utilizan WebSockets mediante implementaciones propias, WebSockets no forma parte de los transportes estándar actuales de MCP. Por tanto, no conviene asumir que cualquier cliente compatible con el protocolo podrá conectarse de esta forma.
Configuración paso a paso en Claude Desktop
La manera más sencilla de ampliar Claude Desktop es utilizar sus extensiones de escritorio. Desde Ajustes > Extensiones puedes consultar el directorio disponible, instalar una extensión y completar los campos necesarios, como rutas de archivos o credenciales de acceso.
También es posible instalar extensiones personalizadas distribuidas como archivos .mcpb. Para ello, debes entrar en los ajustes avanzados de las extensiones, localizar las opciones para desarrolladores y seleccionar el archivo correspondiente. Este formato puede ofrecer una instalación más cómoda y proteger determinados datos sensibles mediante el almacén seguro de credenciales del sistema operativo. Guía oficial de extensiones locales de Claude Desktop
Si el servidor no está disponible como extensión, todavía puedes configurarlo manualmente mediante el archivo claude_desktop_config.json. En Windows se encuentra normalmente en esta ruta:
%APPDATA%\Claude\claude_desktop_config.json
Dentro de este archivo se utiliza la propiedad mcpServers para indicar qué comando debe ejecutar Claude y qué argumentos necesita. Es fundamental respetar la sintaxis JSON, ya que una coma sobrante, unas comillas incorrectas o una llave mal cerrada pueden impedir que el servidor arranque.
Un ejemplo útil es el servidor MCP oficial de GitHub. El antiguo paquete @modelcontextprotocol/server-github ya no recibe soporte, por lo que no debe instalarse siguiendo tutoriales antiguos. La implementación vigente es GitHub MCP Server y puede ejecutarse localmente mediante Docker con la imagen ghcr.io/github/github-mcp-server.
Una configuración básica para Claude Desktop puede tener esta estructura:
{ "mcpServers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "TU_TOKEN" } } } }Para que funcione, necesitas tener Docker instalado y ejecutándose. También debes crear un token de acceso personal en GitHub y concederle exclusivamente los permisos necesarios para las tareas que quieras realizar. Siempre que sea posible, es preferible usar un token de permisos específicos en lugar de un token clásico con acceso general a todos los repositorios.
Ten presente que guardar el token directamente en el archivo JSON hace que quede almacenado como texto legible en el ordenador. Por eso, en equipos compartidos o entornos empresariales resulta más seguro utilizar una extensión MCPB, un gestor de secretos o un método equivalente de almacenamiento protegido.
Después de modificar el archivo, debes cerrar Claude Desktop por completo y volver a abrirlo. Reiniciar únicamente la ventana puede no ser suficiente para que la aplicación vuelva a cargar la configuración.
Gestión avanzada y resolución de problemas
Si un servidor aparece instalado pero sus herramientas no están disponibles, el primer paso consiste en reiniciar Claude Desktop y revisar su configuración. También debes comprobar que las rutas utilizadas existen, que Docker o el proceso necesario están funcionando y que las credenciales tienen los permisos adecuados.
Cuando se utiliza una configuración JSON, conviene validarla con un comprobador de sintaxis. Un archivo aparentemente correcto puede fallar por un detalle mínimo y provocar que Claude ignore uno o varios servidores MCP.
También debes distinguir entre la configuración de Claude Desktop y la de Claude Code. Comandos como claude mcp list, los alcances de configuración y el archivo .mcp.json pertenecen principalmente a Claude Code, por lo que no deben utilizarse como instrucciones generales para la aplicación de escritorio.
En Claude Code existen tres alcances principales:
- Local: el servidor queda disponible únicamente dentro del proyecto actual y para el usuario que lo configuró.
- Project: la configuración se almacena en un archivo
.mcp.jsonque puede compartirse con el resto del equipo. - User: el servidor queda disponible para el usuario en diferentes proyectos.
Compartir un archivo .mcp.json permite que un equipo utilice una misma lista de servidores, pero cada integrante debe revisar y aprobar la configuración antes de ejecutar procesos procedentes del repositorio. Tampoco deben introducirse claves privadas directamente en un archivo que vaya a subirse al control de versiones.
Para referenciar credenciales sin incluirlas en el repositorio puede utilizarse la expansión de variables de entorno mediante expresiones como ${GITHUB_TOKEN}. Esto evita publicar el valor del secreto, aunque cada usuario tendrá que definir la variable correspondiente en su propio entorno.
Los servidores que devuelven cantidades enormes de información también pueden provocar problemas de contexto y rendimiento. En Claude Code, la variable MAX_MCP_OUTPUT_TOKENS permite ajustar el límite aplicado a determinadas respuestas. Por ejemplo:
MAX_MCP_OUTPUT_TOKENS=50000 claudeEste ajuste pertenece a Claude Code y no debe confundirse con una opción general de Claude Desktop. Aumentar el límite tampoco es siempre la mejor solución, ya que puede incrementar el consumo de contexto y dificultar que el modelo identifique la información relevante.
Si estás desarrollando un servidor, puedes declarar el metadato anthropic/maxResultSizeChars para indicar que una herramienta necesita devolver respuestas especialmente extensas. Claude Code admite valores de hasta 500.000 caracteres para el contenido de texto de una herramienta, aunque normalmente resulta preferible paginar, filtrar o resumir los resultados. Documentación MCP de Claude Code
Autenticación y seguridad en el protocolo
La seguridad es especialmente importante porque algunos servidores MCP permiten leer información privada o ejecutar acciones sobre servicios externos. Antes de instalar uno, comprueba quién lo mantiene, qué comandos ejecuta y qué permisos solicita.
Los servidores remotos pueden utilizar OAuth 2.0 para autenticar al usuario sin obligarlo a copiar manualmente un token. Cuando el servidor y el cliente son compatibles, Claude puede abrir un flujo de autorización para que el usuario inicie sesión y apruebe el acceso solicitado.
No obstante, es importante entender dónde se produce la conexión. Los servidores MCP locales configurados mediante claude_desktop_config.json se ejecutan y se comunican desde el ordenador del usuario. En cambio, los conectores remotos añadidos a la cuenta de Claude pueden recibir conexiones procedentes de la infraestructura de Anthropic, por lo que el servidor debe ser accesible desde Internet y estar correctamente protegido.
En Claude Code también pueden utilizarse mecanismos avanzados como headersHelper, que ejecutan un programa para generar encabezados de autenticación dinámicos. Esto resulta útil con tokens de corta duración, sistemas SSO o infraestructuras empresariales, pero es una función específica del cliente y no una capacidad automática de cualquier servidor MCP.
Para reducir riesgos, conviene aplicar el principio de mínimo privilegio: conceder acceso únicamente a los repositorios, carpetas y operaciones imprescindibles. También debes evitar instalar servidores desconocidos, revisar las acciones propuestas por Claude y mantener actualizados tanto el cliente como las imágenes de Docker y las extensiones utilizadas.
Conectar Claude Desktop con un servidor MCP permite convertir el asistente en una herramienta integrada con archivos, repositorios, bases de datos y servicios empresariales. La clave está en elegir correctamente entre una extensión local y un conector remoto, utilizar el transporte adecuado y revisar cuidadosamente los permisos antes de autorizar cualquier acción.
Con una configuración segura, MCP puede eliminar numerosos procesos manuales y permitir que Claude trabaje con información actualizada sin tener que copiarla continuamente dentro del chat. Sin embargo, el acceso final siempre estará limitado por las herramientas ofrecidas por el servidor y por los permisos concedidos por el usuario.
Soy un apasionado de la tecnología que ha convertido sus intereses «frikis» en profesión. Llevo más de 10 años de mi vida utilizando tecnología de vanguardia y trasteando todo tipo de programas por pura curiosidad. Ahora me he especializado en tecnología de ordenador y videojuegos. Esto es por que desde hace más de 5 años que trabajo redactando para varias webs en materia de tecnología y videojuegos, creando artículos que buscan darte la información que necesitas con un lenguaje entendible por todos.
Si tienes cualquier pregunta, mis conocimientos van desde todo lo relacionado con el sistema operativo Windows así como Android para móviles. Y es que mi compromiso es contigo, siempre estoy dispuesto a dedicarte unos minutos y ayudarte a resolver cualquier duda que tengas en este mundo de internet.