MCP Academy · Lección

Conectarlo a Claude Desktop

Edite la configuración para que Claude cargue su servidor.

Lección 2 de 413 pasos

Conectarlo a Claude Desktop es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.

Del script a un host real

Su servidor se ejecuta, pero todavía nadie se comunica con él. Conectémoslo a un host real: Claude Desktop. 🖥️

Lee un archivo de configuración

Claude Desktop descubre los servidores a partir de un único archivo JSON llamado claude_desktop_config.json. Allí enumera cada servidor y la aplicación los carga al iniciarse.

Dónde se encuentra el archivo

En macOS, el archivo se encuentra en Application Support; en Windows, está en la carpeta de roaming de AppData. Ábralo desde la configuración de la aplicación.

~/Library/Application Support/Claude/claude_desktop_config.json

La clave mcpServers

Cada servidor va dentro del objeto mcpServers de nivel superior. Cada clave es el nombre que usted elige; el valor describe cómo iniciarlo.

{
  "mcpServers": {}
}

Comando y argumentos

Para cada servidor, proporciona un comando que ejecutar y una matriz de args. Juntos indican exactamente cómo el host inicia su proceso.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

Use rutas absolutas

El host se inicia desde su propio directorio de trabajo, por lo que las rutas relativas fallan. Apunte siempre los args a una ruta absoluta de su script.

uv lo hace más sencillo

Si su proyecto utiliza uv, establezca el comando como uv y deje que ejecute su módulo en el entorno adecuado, sin necesidad de una instalación global.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

Pase variables de entorno

Los secretos, como las claves de API, van en un objeto env opcional. El host los inyecta al iniciar su servidor, por lo que no aparecen en el código.

"env": { "API_KEY": "sk-..." }

Reinicie para aplicar los cambios

Claude lee la configuración únicamente al iniciarse. Después de editarla, debe reiniciar por completo la aplicación para que detecte su nuevo servidor.

El icono del martillo

Cuando funciona, aparece un pequeño indicador de tools en el chat. Al hacer clic en él, se muestran las herramientas que su servidor ofrece ahora a Claude. 🔨

Elija el nombre con cuidado

La clave que elija en mcpServers se convierte en el nombre del servidor. Manténgalo corto y único para que varios servidores nunca entren en conflicto en el host.

Comprobación rápida

¿Qué cambio necesita Claude Desktop antes de cargar un servidor recién añadido?

Responde en la lección interactiva

Repaso

Ha añadido su servidor a claude_desktop_config.json con un comando, args y env, ha utilizado rutas absolutas y ha reiniciado. ¡Ya está activo en Claude! ✅

Gratis para empezar

Aprende Python con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos: 30
Lecciones: 120

Empezar a aprender gratis Ver el curso completo

Preguntas frecuentes

¿La lección «Conectarlo a Claude Desktop» es gratis?

Sí — el texto completo de «Conectarlo a Claude Desktop» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Conectarlo a Claude Desktop»?

Edite la configuración para que Claude cargue su servidor. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar MCP Academy?

No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Conectarlo a Claude Desktop»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de MCP Academy?

Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a MCP Academy