Claude Code y MCP: donde vive la configuración, cómo agregar un servidor y cómo corregir errores

27 agosto 202656 vistas

Descubrimos qué archivo Claude Code utiliza para almacenar los ajustes MCP para el escritorio y CLI, cómo configurar el servidor manualmente o a través de un comando, y qué hacer si las herramientas no son visibles después de un reinicio.

Claude Code y MCP: donde vive la configuración, cómo agregar un servidor y cómo corregir errores

Qué es el MCP y por qué conectarlo al Código Claude

Claude Code puede trabajar no sólo con sus características incorporadas, sino también con herramientas externas a través del protocolo MCP. Esto le permite ejecutar el sitio web paresing, trabajo de diseño, cheques de seguridad, y mucho más directamente del chat.

Para obtener un servidor funcionando, necesita describir una vez cómo lanzarlo: qué comando se utiliza, qué argumentos se aprueban, y qué teclas de acceso son necesarias. El reto principal es que la configuración vive en diferentes lugares dependiendo de la versión que estés usando.

Configuración en la aplicación de escritorio

Si está usando la versión de escritorio, el archivo de configuración se encuentra en C:\Users\Boss\AppData\Roaming\Claude\claude_desktop_configEl archivo no tiene extensión, aunque en realidad es simple JSON. La manera más rápida de abrirla es a través de %APPDATA%\Claude variable — ahí es donde claude_desktop_config.json vidas.

La estructura es simple: la mcpServers llave, dentro de ella — el nombre del servidor, y bajo eso — command, args, y env.

json { "mcpServers": { "nombre de servidor": { "mand": "command", "args": ["arguments"], "env": { "API KEY": "tu-key" } } }

Por ejemplo, para Firecrawl (sitio paring) necesitas correr npx -y firecrawl-mcp y pasar el FIRECRAWL_API_KEY llave. Para Pencil (diseño) - especificar la ruta completa al archivo exe y el --app desktop argumento. En el mismo archivo, también puede añadir, por ejemplo, Burp Suite para tareas de seguridad.

Después de guardar la configuración, asegúrate de cerrar completamente la aplicación, no sólo minimizarla, sino dejarla pasar por la bandeja. En el próximo lanzamiento, aparecerá un icono de martillo con el número de herramientas disponibles en la parte inferior de un nuevo chat. Si eso no sucede, busque un error en el JSON.

Configuración de servidores para la versión CLI

La versión terminal de Claude Code ignora el configuración de escritorio. Poner cualquier cosa es inútil — el archivo es ignorado silenciosamente. En su lugar, el archivo C:\Users\USERNAME\.claude.json en el directorio principal se utiliza. Nota: este es un archivo, no un .claude carpeta. La diferencia es un punto, y es fácil de perder.

Puede agregar un servidor de dos maneras. El primero es a través de un comando terminal: claude mcp add firecrawl --scope user -- npx -y firecrawl-mcpEl segundo es editar manualmente .claude.jsonSi el archivo aún no existe, simplemente creelo. Si necesita pasar una llave a través de una variable de entorno, es más conveniente editar el archivo a mano — la línea de comandos no es adecuada para eso.

Para un proyecto específico, para evitar llevar configuración a través de todos los proyectos a la vez, un .mcp.json se crea en la raíz. Este archivo se puede comprometer a git si todo el equipo utiliza los mismos servidores. Añadiendo este aspecto: claude mcp add firecrawl --scope project -- npx -y firecrawl-mcp

Cómo comprobar y gestionar servidores

Dentro de una sesión, la forma más fácil de comprobar el estado es a través de la /mcp comando — enumera todos los servidores y muestra cuáles están funcionando. Para el terminal hay comandos separados:

  • claude mcp list - todos los servidores y sus estados;
  • claude mcp get firecrawl - detalles de un servidor específico;
  • claude mcp remove firecrawl --scope user - eliminar un servidor.

Errores comunes y cómo solucionarlos

A menudo, un servidor no aparece debido a errores en el JSON. Una coma de seguimiento al final de un bloque, una coma que falta entre servidores, soportes sin igual — todo esto causa que el archivo sea ignorado silenciosamente sin ninguna advertencia. Compruebe la sintaxis antes de reiniciar la aplicación.

Si lo ves npx: command not found al iniciar un servidor, Node.js no está instalado o no se añade a PATH. Instala Node.js, reinicie la terminal y asegúrese de node --version y npx --version versiones de salida.

En Windows, también es importante escribir correctamente caminos con espacios. Por ejemplo, C:\Program Files\... en JSON necesita escaparse con dobles barras de respaldo: "C:\\Program Files\\Pencil\\resources\\..."De lo contrario, la aplicación no encontrará el archivo.

Preguntas frecuentes

Material similar

Todos los materiales
Verificar candidatos cuesta más que generarlos: señuelos contra la búsqueda de vulnerabilidades con LLM
Noticias

Verificar candidatos cuesta más que generarlos: señuelos contra la búsqueda de vulnerabilidades con LLM

El trabajo analiza la asimetría de costes en la búsqueda agéntica de defectos: generar candidatos es barato, pero confirmarlos mediante análisis de alcanzabilidad, ejecución y PoC requiere la mayor parte del presupuesto, por lo que la verificación puede convertirse en un objetivo de defensa por sí misma. La propuesta RedHerring —señuelos adaptados al repositorio con un certificado oculto— redujo entre un 38,7 y un 60,4 % el número de vulnerabilidades reales encontradas con el mismo coste en 33 proyectos de OSS-Fuzz; incluso tras advertir al agente, la reducción se mantuvo en el 37,2 %.

9 noviembre 2026
Las restricciones numéricas y las técnicas de corrección determinan la preservación de las características de la jerarquía hiperbólica
Investigación

Las restricciones numéricas y las técnicas de corrección determinan la preservación de las características de la jerarquía hiperbólica

El trabajo analiza cómo la viabilidad de la restricción a una variedad, la precisión aritmética y la normalización limitan los estados alcanzables y, por tanto, influyen en qué evidencias de la estructura aprendida permanecen en el modelo. De ello se desprende que un checkpoint plano guardado no puede considerarse prueba de que la geometría no funciona sin tener en cuenta por separado las limitaciones numéricas y las correcciones.

7 noviembre 2026
Modelo del mundo para agentes basados en LLM cerrados: corrección en puntos de riesgo
Noticias

Modelo del mundo para agentes basados en LLM cerrados: corrección en puntos de riesgo

Se propone PAWM, un predictor externo que no duplica la observación paso a paso, sino que se activa cuando es probable que ocurra un fallo y desvía al agente de una acción equivocada. Tras el ajuste fino supervisado (SFT) con escenarios sintéticos y el coentrenamiento con GRPO, el método logró una mejora del 24,3 % en ScienceWorld y del 7,7 % en WebArena-Lite para Claude Sonnet 4.5.

4 noviembre 2026
Claude Code and MCP ¿Dónde está la configuración y cómo añadir el servidor