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.
