Localiza claude_desktop_config.json en Windows y macOS, evita la trampa de la ruta MSIX, pega un ejemplo mcpServers que funcione, reinicia la app correctamente y lee los registros MCP cuando un servidor no quiere cargar. Incluye un tutorial para depurar tu JSON con un modelo de Claude en PicassoIA.
Editaste el JSON, reiniciaste la app y no pasó nada. Ni icono de martillo, ni herramientas nuevas, ni mensaje de error. Ese fallo silencioso es lo más común con una configuración MCP de Claude Desktop, y casi siempre se debe a una de tres causas: editaste el archivo equivocado, el JSON tiene un pequeño error de sintaxis o la app nunca se cerró del todo antes de reabrirla. Este artículo repasa las tres, en el orden en que te las encontrarás.
Verás la ubicación exacta de claude_desktop_config.json en Windows y macOS (incluida la trampa de MSIX en Windows, que envía tus cambios a un archivo que nadie lee), un ejemplo de JSON que puedes pegar hoy mismo, una forma de confirmar que un servidor se conectó de verdad y una rutina breve de solución de problemas basada en los registros MCP. Hacia el final hay un tutorial para usar Claude Sonnet 5 en PicassoIA y depurar tu propia configuración, y un repaso a cómo conectar generadores de imágenes y video una vez que la base funciona.
💡 Versión corta: el archivo es
claude_desktop_config.json, necesita un objetomcpServersen el nivel superior, cada ruta dentro debe ser absoluta y la app debe cerrarse por completo y volver a abrirse después de cada cambio.
Claude Desktop lee un archivo JSON al arrancar para saber qué servidores MCP (servidores del Model Context Protocol) debe iniciar. El archivo no existe hasta que lo abres desde la pantalla de ajustes o lo creas a mano, así que una instalación nueva no tiene nada que encontrar todavía. Su ubicación depende del sistema operativo y, en Windows, de cómo instalaste la app.
En una instalación estándar de Windows, el archivo está aquí:
%APPDATA%\Claude\claude_desktop_config.json
Expandida, la ruta es C:\Users\<your name>\AppData\Roaming\Claude\claude_desktop_config.json. Pulsa Win+R, pega la primera forma y pulsa Intro para abrir la carpeta correcta.
Aquí está la trampa. Cuando Claude Desktop se instala como paquete MSIX (la Microsoft Store y algunas instalaciones de WinGet funcionan así), Windows virtualiza la carpeta AppData de esa app. Varios informes públicos de errores describen el mismo resultado: el botón Edit Config abre el archivo normal %APPDATA%, mientras que la app en sí lee una copia escondida dentro de la carpeta del paquete:
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
Si editas el primer archivo, tus servidores se ignoran sin ningún aviso. Una comprobación rápida en PowerShell te dice en cuál de las dos situaciones estás:
Test-Path "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc"
Si eso muestra True, pon tu bloque mcpServers en la ruta del paquete, reinicia y comprueba si aparece el servidor. Los nombres de las carpetas de paquete pueden cambiar entre versiones, así que trata la ruta de arriba como punto de partida. Si no coincide, busca dentro de %LOCALAPPDATA%\Packages una carpeta que empiece por Claude_.
En un Mac, el archivo está dentro de la carpeta Library, que el Finder oculta por defecto:
~/Library/Application Support/Claude/claude_desktop_config.json
En el Finder, elige Ir, luego Ir a la carpeta, y pega ~/Library/Application Support/Claude. Desde Terminal, open ~/Library/Application\ Support/Claude hace lo mismo.
No existe una versión oficial de Claude Desktop para Linux. Las versiones de la comunidad suelen seguir la convención XDG y leen ~/.config/Claude/claude_desktop_config.json, pero revisa las notas de la versión que uses antes de fiarte de esa ruta.
La vía con menos riesgo de error es la propia app:
Eso crea el archivo si falta y lo muestra en tu gestor de archivos. En una instalación MSIX de Windows, compara la carpeta que se abre con la ruta del paquete de arriba antes de fiarte de ella.
Aquí tienes todas las ubicaciones en un solo sitio:
| Sistema | Archivo de configuración | Carpeta de registros |
|---|---|---|
| Windows | %APPDATA%\Claude\claude_desktop_config.json | %APPDATA%\Claude\logs |
| Windows (MSIX) | %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\ | La carpeta logs junto a la configuración |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | ~/Library/Logs/Claude |
El archivo entero es un único objeto JSON. Claude Desktop busca una propiedad de nivel superior llamada mcpServers. Dentro, cada propiedad es un servidor, y el nombre de la propiedad es la etiqueta que ves en la app. Cada entrada es una pequeña receta para iniciar un programa en tu equipo, y Claude se comunica con ese programa a través de la entrada y salida estándar.
| Campo | Obligatorio | Qué hace |
|---|---|---|
command | Sí | El ejecutable que se lanza, como npx o node |
args | Normalmente | Una lista de argumentos, una cadena por elemento |
env | No | Variables de entorno que se pasan a ese proceso |
El command correcto depende de cómo se escribió el servidor. Los servidores de Node.js publicados en npm arrancan con npx. Los servidores que tú mismo creaste o clonaste arrancan con node seguido de la ruta al archivo compilado. Los servidores de Python suelen lanzarse con uvx, que necesita la herramienta uv instalada. En todos los casos la regla es la misma: lo que escribas como command debe funcionar al escribirlo en una terminal, porque eso es exactamente lo que Claude Desktop hace por ti.
Si Claude Desktop ya añadió otras entradas de nivel superior al archivo (las versiones más nuevas pueden guardar ahí algunas preferencias), déjalas como están y añade mcpServers junto a ellas. Sustituir todo el archivo por un fragmento pegado es la forma en que la gente pierde esos ajustes.
Aquí tienes el servidor oficial de sistema de archivos en un Mac. Sustituye username por el nombre de tu cuenta real:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
}
}
}
La versión para Windows es idéntica salvo por las rutas, y cada barra invertida debe duplicarse porque una sola barra invertida es un carácter de escape en JSON:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\username\\Desktop",
"C:\\Users\\username\\Downloads"
]
}
}
}
Tres detalles hacen casi todo el trabajo aquí. La marca -y hace que npx instale el paquete del servidor sin hacer una pregunta que nadie va a responder. Las carpetas tras el nombre del paquete son los únicos lugares que el servidor puede tocar. Y todas esas rutas son absolutas, porque las relativas son una causa clásica de que un servidor nunca arranque.
También necesitas Node.js, ya que npx viene incluido con él. Ejecuta node --version en una terminal; si muestra un número de versión, estás listo, y la versión LTS es la opción segura.
💡 Consejo: elige la etiqueta de
mcpServerspensando en las personas, no en la máquina.filesystem,notesoweathervalen todas, y el nombre solo aparece en los menús y en el nombre del archivo de registro.
Los servidores reales suelen necesitar una credencial. Ponla en el objeto env de ese servidor, nunca en args, donde aparecería en las listas de procesos. Este ejemplo ejecuta dos servidores uno al lado del otro:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Documents/notes"
]
},
"weather": {
"command": "node",
"args": ["/Users/username/tools/weather-server/build/index.js"],
"env": {
"WEATHER_API_TOKEN": "paste-your-token-here"
}
}
}
}
Fíjate en la coma entre los dos bloques de servidor y en que no hay coma tras el último. Esos dos fallos causan más archivos rotos que cualquier otra cosa.
El archivo de configuración es texto plano, así que trátalo como un archivo de contraseñas. No lo subas a un repositorio público, no lo pegues en un chat ni en una captura de pantalla con el token visible, y limita el acceso a las carpetas. Un servidor se ejecuta con los permisos de tu cuenta de usuario, lo que significa que puede hacer todo lo que puedes hacer a mano. Apunta el servidor de sistema de archivos a una sola carpeta de proyecto, no a todo tu directorio personal.
El archivo JSON lanza procesos locales. Un servidor MCP remoto alojado es otra cosa: ya se ejecuta en otro lugar y lo alcanzas mediante una URL. Claude Desktop espera que esos se añadan desde Ajustes y luego Conectores, no como entradas en claude_desktop_config.json. Pegar una URL en command es una de las formas más discretas de acabar con un servidor que nunca carga.
| Servidor local | Servidor remoto | |
|---|---|---|
| Dónde se ejecuta | En tu equipo | En una máquina alojada |
| Cómo se añade | mcpServers en el archivo JSON | Ajustes, luego Conectores |
| Necesita Node.js | A menudo | No |
| Fallo típico | Ruta incorrecta o JSON defectuoso | Problema de inicio de sesión o de permisos |
Claude Desktop lee la configuración una vez, al arrancar. Guardar el archivo no hace nada por sí solo. Cerrar la ventana tampoco basta, porque la app puede seguir ejecutándose en segundo plano. En macOS pulsa Cmd+Q o usa Claude y luego Salir. En Windows, ciérrala desde el icono de la bandeja del sistema si la app sigue ahí. Después, ábrela de nuevo.
Trabaja en pasos pequeños. Añade un servidor, reinicia, confírmalo y luego añade el siguiente. Si pegas cinco servidores de golpe y el archivo no carga, no tienes forma de saber qué bloque lo rompió.
Cuando la app vuelva a estar en marcha, mira el cuadro de entrada del chat y haz clic en el botón Añadir archivos, conectores y más. Pasa el cursor sobre Conectores, haz clic en Gestionar conectores y elige tu servidor de la lista. Un servidor que funciona muestra las herramientas que ofrece. El servidor de sistema de archivos, por ejemplo, enumera herramientas para leer archivos, escribirlos, moverlos y buscarlos.
Después haz una prueba real con un prompt como "Lista los archivos de mi carpeta Descargas". Claude pide permiso antes de llamar a una herramienta. Aprueba la llamada y la respuesta debería devolver nombres de archivo reales. Si responde que no tiene acceso a tus archivos, el servidor no se conectó.
Un solo carácter mal colocado impide que todo el archivo cargue. Estos son los sospechosos habituales:
// son errores.Este fragmento reúne tres de ellos en pocas líneas. ¿Los encuentras?
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\Users\username\Desktop",],
}
}
}
La ruta usa barras invertidas sencillas, la lista termina con una coma antes del corchete de cierre y la línea args termina con una coma antes de la llave de cierre. Corrige las tres y el archivo se analiza bien.
Antes de reiniciar, valida el archivo. Sirve cualquier validador de JSON, o puedes usar Node.js, que ya tienes:
node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')); console.log('valid')" claude_desktop_config.json
Si muestra valid, la sintaxis está bien y el problema está en otra parte.
Cuando el JSON es válido pero el servidor sigue fallando, el culpable suele ser el command. Una app de escritorio no lee tu perfil de shell, así que un Node.js instalado con un gestor de versiones puede serle invisible. Ejecuta which npx en una terminal y pon la ruta completa en el campo command en lugar de npx.
Primero, ejecuta el comando exacto a mano para ver si funciona fuera de la app:
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop
En Windows, si el registro menciona un error sobre ${APPDATA} dentro de una ruta, añade el valor expandido de %APPDATA% al bloque env de ese servidor, por ejemplo "APPDATA": "C:\\Users\\username\\AppData\\Roaming\\". Comprueba también que %APPDATA%\npm existe. Si no existe, instala npm de forma global con npm install -g npm y luego reinicia la app.
Los registros te dicen lo que vio la app. Abre la carpeta de registros de la tabla de arriba y busca dos tipos de archivos. mcp.log contiene mensajes generales sobre conexiones y fallos. Los archivos llamados mcp-server-NAME.log guardan la salida stderr de cada servidor, que suele ser donde está el mensaje de error real. En un Mac puedes seguirlos en directo:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
En Windows, PowerShell hace lo mismo:
Get-Content "$env:APPDATA\Claude\logs\mcp.log" -Tail 40 -Wait
Un registro que no cambia después de un reinicio es en sí mismo una pista: la app probablemente está leyendo un archivo de configuración distinto del que editaste, lo que te devuelve a la ruta de MSIX.
| Síntoma | Causa probable | Solución |
|---|---|---|
| Ningún servidor, ningún error | Archivo de configuración equivocado, o app no cerrada del todo | Revisa la ruta, cierra desde la bandeja o el menú |
| Servidor listado pero marcado como fallido | command incorrecto o falta Node.js | Usa la ruta completa a npx o node |
| Toda la configuración ignorada | JSON no válido | Valida el archivo y elimina las comas sobrantes |
| Las herramientas fallan al llamarlas | El servidor se cae en tiempo de ejecución | Lee mcp-server-NAME.log |
| No se puede acceder a una carpeta | Ruta no incluida en args | Añade la ruta absoluta de la carpeta |
Un segundo par de ojos es la forma más rápida de detectar una coma perdida. Claude Sonnet 5 en PicassoIA es un modelo de texto que lee JSON pegado, trazas de pila e incluso capturas de pantalla de un error, así que funciona bien como revisor de configuraciones.
Ve a la página de Claude Sonnet 5 en la colección de Large Language Models y abre el cuadro de prompt. Mantén una pestaña del navegador para el modelo y otra para tu editor, así podrás pegar y copiar de una a otra.
El modelo ofrece un puñado de ajustes, y algunos importan aquí:
low, que desactiva el pensamiento para obtener la respuesta más rápida. Eso basta para una comprobación de sintaxis. Pasa a medium o high cuando necesites que razone sobre rutas en varios servidores.Para comprobaciones rápidas de sí o no, Claude 4.5 Haiku responde más deprisa. Para un rompecabezas complicado de varios archivos, Claude Opus 4.7 es la opción más potente.
Sustituye antes cada token por un marcador de posición. Luego pega el archivo y haz una pregunta concreta:
This claude_desktop_config.json is on Windows. The filesystem server never
appears in Claude Desktop. Check the JSON syntax, check the path escaping,
and tell me which line to fix first.
Compara la respuesta con tu archivo línea por línea en lugar de pegarla a ciegas, y ejecuta sobre el resultado el validador de Node.js que vimos antes.
Una vez que tu base funciona, empieza la parte interesante: darle a Claude herramientas que generan cosas. PicassoIA ofrece una API para desarrolladores y una conexión MCP, ambas limitadas a cuatro modelos en el momento de escribir esto:
| Modelo | Tipo | Para qué sirve |
|---|---|---|
| PicassoIA Image | Imagen | Generación de imágenes a partir de texto |
| PicassoIA Image Editor Pro | Imagen | Edición y retoque de imágenes existentes |
| PicassoIA Video | Video | Generación de video |
| Seedance 2.5 Lite | Video | Video con audio |
Las conexiones MCP de PicassoIA se crean desde tu página de cuenta en picassoia.com después de iniciar sesión. Están alojadas, así que se aplica la vía de conectores de antes: añádelas desde Ajustes y luego Conectores, no como una entrada mcpServers. Los trabajos se ejecutan de forma asíncrona. Una petición inicia una predicción y el resultado se recupera cuando termina. Cada cuenta puede ejecutar 5 predicciones a la vez, y ese límite se comparte entre todas las conexiones MCP que hagas, así que una petición por lotes desde Claude puede hacer cola consigo misma.
💡 Consejo: pide primero una sola imagen, comprueba el resultado y luego aumenta. Un único prompt de foto en 16:9 te dice más rápido que un lote de diez imágenes si la conexión y los permisos están bien.
Una buena primera petición es concreta: "Crea una foto en 16:9 de una taza de cerámica sobre un escritorio de roble con luz suave de la mañana, usando PicassoIA Image." Claude elige la herramienta, espera al trabajo y te entrega el enlace. Si pide permiso cada vez, es el mismo paso de aprobación que viste con el servidor de sistema de archivos, y está funcionando como debe.
Tu archivo de configuración ya hace lo que debe: apunta al lugar correcto, se analiza sin errores, arranca sus servidores y registra lo que sale mal. Esa es la mitad aburrida de trabajar con herramientas de IA, y solo tienes que hacerla una vez.
La mitad divertida es crear. Abre PicassoIA Image y escribe un prompt sobre algo que te importe, una calle que conozcas o un producto que vendas. Retócalo con PicassoIA Image Editor Pro y luego anima el mejor resultado con PicassoIA Video. Explora todos los modelos en picassoia.com/en/all-models, elige uno que no hayas probado y crea tu primera imagen hoy mismo.
Elige tu idioma
