Configura MCP en Claude Code y recupera fallos de PhotoCraft

Claude Code guarda la configuración MCP local y de usuario en ~/.claude.json, y la de proyecto en .mcp.json. Elige el ámbito según quién vaya a usar el servidor: los servidores configurados para un proyecto piden aprobación en las sesiones interactivas antes de utilizarse. La documentación oficial de Claude Code detalla estas opciones.

Elige el ámbito MCP adecuado

MCP —el Protocolo de Contexto de Modelo— permite conectar Claude Code con herramientas externas. La diferencia práctica entre sus tres ámbitos está en a qué proyectos se aplica la configuración y si se comparte con el equipo.

Si quieres que la configuración sea personal y solo afecte a un proyecto, usa el ámbito local. Para cargarla en tus distintos proyectos, elige el de usuario. Si vas a compartirla con el equipo, el archivo .mcp.json permite incluir la configuración en el proyecto; cada usuario tendrá que aprobar el servidor en una sesión interactiva.

Añadir un servidor MCP y comprobar su estado

Antes de registrarlo, ten a mano el comando y los argumentos del servidor de la aplicación que quieras conectar. El conjunto Craft reúne 13 aplicaciones con servidores MCP propios; el artículo de pasqualepillitteri.it señala que los ejecutables y las opciones dependen de cada aplicación.

1. Añade el servidor. Para un servidor local que usa stdio (entrada y salida estándar), la forma general es:claude mcp add <nombre> -- <comando> [argumentos] El separador -- indica dónde terminan las opciones de Claude Code y dónde empiezan el comando y los argumentos que recibirá el servidor.
2. Comprueba su estado. Ejecuta claude mcp list para consultar los servidores o usa /mcp desde Claude Code para ver su estado y gestionarlos. La documentación de Claude Code describe ambos comandos.

El mensaje de que la configuración se ha añadido no basta, por sí solo, para confirmar que el servidor se ha conectado: comprueba su estado con esos comandos.

Revisa el resultado que genera cada aplicación

Las tareas descritas por pasqualepillitteri.it ilustran por qué conviene inspeccionar el archivo o el documento resultante. En un ejercicio con DeckCraft, una gráfica se superpuso al título de la diapositiva; en otro con WordCraft, la carta quedó inicialmente en dos páginas. Son incidencias de esas tareas concretas, no una clasificación general de las aplicaciones.

Los límites de archivos del servidor no cubren otras herramientas

En PhotoCraft, las raíces de lectura y escritura configuradas delimitan el acceso del propio servidor a los archivos. Esa restricción no se extiende automáticamente a otras herramientas disponibles en Claude Code. En una tarea con FilmCraft descrita por pasqualepillitteri.it, el servidor no guardó un fotograma en la ruta solicitada y se utilizó una herramienta de shell de Claude Code para guardarlo.

La documentación de Claude Code recomienda confiar en un servidor antes de conectarlo, sobre todo si puede recibir contenido externo que incluya intentos de inyección de instrucciones. El límite de archivos de un servidor MCP no sustituye los permisos de las demás herramientas.

Qué hacer si falla un lote de PhotoCraft

Un lote de command_batch de PhotoCraft no es una transacción: si una operación posterior falla, los pasos anteriores que se completaron siguen aplicados. La documentación MCP de PhotoCraft indica cómo recuperarse:

1. Inspecciona el estado del documento y su historial antes de volver a ejecutar las operaciones.
2. Comprueba por separado los archivos escritos en disco. Deshacer cambios del documento no elimina los archivos que ya se hayan guardado.
3. Experimenta en una copia o en un documento nuevo para evitar trabajar sobre el original mientras pruebas operaciones.