Guía de Claude Code CLI MCP: conecta datos y servicios externos

Objetivos de Aprendizaje

Al finalizar este tutorial, podrá:

• Comprender cómo funciona MCP (Model Context Protocol) con Claude Code
• Añadir servidores MCP a Claude Code CLI mediante el comando claude mcp add
• Verificar el estado de conexión de sus servidores MCP
• Utilizar herramientas MCP en conversaciones con Claude Code
• Gestionar el ámbito del servidor (local, usuario, proyecto)

Tiempo necesario: 15–20 minutos

Dificultad: Principiante

¿Qué versión se cubre? Este tutorial cubre Claude Code CLI — la versión de línea de comandos de Claude Code. Los servidores MCP se configuran mediante el comando claude mcp y los archivos de configuración .mcp.json o ~/.claude.json. Si prefiere la versión de escritorio, consulte la Guía de MCP para Claude Code Desktop.

Prerrequisitos

Antes de comenzar, asegúrese de tener lo siguiente:

¿Qué es MCP?

MCP (Model Context Protocol) es un estándar abierto que permite a asistentes de IA como Claude Code conectarse a herramientas y fuentes de datos externas. En lugar de que cada herramienta construya su propia integración personalizada, todas hablan el mismo protocolo.

Un servidor MCP es un programa pequeño que expone herramientas, datos o servicios al asistente de IA. Por ejemplo:

• Un servidor MCP de GitHub permite a Claude Code leer issues, crear pull requests y navegar por repositorios
• Un servidor MCP de base de datos permite a Claude Code consultar su base de datos con lenguaje natural
• Un servidor MCP de gestor de incidencias permite a Claude Code acceder directamente a JIRA, Linear o Notion

Claude Code admite dos tipos de servidores MCP:

• Servidores HTTP (recomendados): alojados en una URL, no requieren un proceso local
• Servidores Stdio: se ejecutan como un programa local en su máquina

Cómo funciona MCP en Claude Code

Claude Code CLI tiene soporte MCP integrado. Los servidores se añaden con el comando claude mcp add, que escribe la configuración del servidor en un archivo. Existen tres ámbitos:

• Local (predeterminado): privado para usted, activo solo en el directorio del proyecto actual
• Usuario (User): privado para usted, activo en todos sus proyectos
• Proyecto (Project): compartido con compañeros de equipo mediante .mcp.json incluido en el repositorio

Una vez añadido un servidor, sus herramientas están disponibles para Claude Code en cada sesión. Claude selecciona automáticamente la herramienta adecuada según su instrucción.

Paso 1: Verifique su configuración de MCP

Primero, confirme que su versión de Claude Code sea compatible con MCP:

claude --version

Resultado esperado: Un número de versión (v2.1.x o posterior). El soporte MCP está integrado en todas las versiones recientes de Claude Code.

Ahora revise qué servidores tiene ya configurados:

claude mcp list

Resultado esperado: Una lista de servidores MCP configurados, o un mensaje como "No MCP servers configured."

Paso 2: Encuentre un servidor MCP

Los servidores MCP de Claude Code están disponibles desde varias fuentes:

• Directorio MCP en Cataito: explore /mcp — más de 55 servidores MCP seleccionados listos para conectar
• Directorio de Anthropic: claude.ai/directory — conectores revisados por Anthropic
• GitHub: busque mcp-server — existen miles de servidores comunitarios
• npm: muchos servidores se instalan con npx

Para este tutorial, conectaremos el **servidor MCP de GitHub** — uno de los servidores más populares, que permite a Claude Code leer repositorios, issues y pull requests.

Paso 3: Añada un servidor MCP HTTP

Los servidores HTTP son la forma recomendada de conectarse a servidores MCP remotos. Están alojados en una URL y no requieren configuración local.

Abra una terminal y registre el servidor MCP de GitHub:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Resultado esperado: Un mensaje de confirmación como Added HTTP MCP server github with URL: ... seguido de una línea File modified: que muestra el archivo de configuración.

Añada un servidor Stdio (Alternativa)

Si el servidor se ejecuta como un comando local, use el transporte stdio:

claude mcp add my-db-server -- npx -y @modelcontextprotocol/server-postgres

Resultado esperado: El comando se completa sin errores, y Claude Code escribe la entrada del servidor en el archivo de configuración.

Paso 4: Verifique el estado de conexión

Confirme que el servidor esté conectado:

claude mcp list

Resultado esperado: El servidor aparece con un indicador de estado:

También puede inspeccionar un servidor específico:

claude mcp get github

Resultado esperado: Los detalles del servidor, incluyendo tipo de transporte, URL y estado.

Paso 5: Use herramientas MCP en una conversación

Ahora inicie una sesión de Claude Code y use las herramientas MCP:

claude

Luego escriba una instrucción que utilice el servicio conectado, por ejemplo:

List the open issues in the facebook/react repository

Resultado esperado: Claude Code llama automáticamente a las herramientas del servidor MCP de GitHub. La primera vez que Claude usa una herramienta, solicita su permiso. Apruebe para continuar. La llamada a la herramienta en la salida de Claude se etiqueta con el nombre del servidor, para que pueda confirmar que la respuesta provino del servidor MCP.

También puede escribir /mcp dentro de una sesión para ver qué herramientas MCP están disponibles.

Paso 6: Cambie el ámbito del servidor (Opcional)

Por defecto, los servidores se añaden en ámbito local (privado para usted, en el proyecto actual). Para registrar un servidor para todos sus proyectos:

claude mcp add --scope user github -- npx -y @modelcontextprotocol/server-github

Para compartir un servidor con compañeros de equipo mediante .mcp.json:

claude mcp add --scope project github -- npx -y @modelcontextprotocol/server-github

Paso 7: Elimine un servidor (Opcional)

Si ya no necesita un servidor, elimínelo:

claude mcp remove github

Resultado esperado: El servidor desaparece de claude mcp list.

Solución de problemas

Preguntas Frecuentes (FAQ)

¿Necesito un plan de pago para usar MCP con Claude Code? Sí. El soporte MCP requiere un plan de pago de Claude (Pro, Max o superior).

¿Puedo usar los mismos servidores MCP en CLI y Escritorio? Sí — puede importar servidores de Escritorio a CLI con claude mcp add-from-claude-desktop. Comparten el mismo formato de configuración.

¿Cuál es la diferencia entre ámbito local, de usuario y de proyecto? El ámbito local guarda el servidor en el archivo .mcp.json del proyecto; el ámbito de usuario lo guarda en ~/.claude.json; el ámbito de proyecto lo guarda en .mcp.json (compartido con compañeros de equipo).

¿Cómo puedo ver qué servidores MCP están disponibles en una sesión? Escriba /mcp dentro de una sesión de Claude Code.

¿Puedo exponer Claude Code como un servidor MCP para otras herramientas? Sí — ejecute claude mcp serve para exponer las herramientas de Claude Code a otros clientes MCP. Este es un caso de uso avanzado.

Próximos Pasos

• Explore el Directorio MCP en Cataito — más de 55 servidores MCP seleccionados listos para conectar
• Aprenda más comandos de Claude Code CLI en la Guía para principiantes de Claude Code CLI
• Consulte la Guía de MCP para Claude Code Desktop si prefiere una interfaz gráfica