Cargando

Agregar servidores MCP a Claude Code

Lección 605 min

Claude Code tiene un cliente MCP integrado, lo que significa que puedes conectar servidores MCP para expandir drásticamente su funcionalidad. Esto abre posibilidades realmente poderosas para personalizar tu flujo de trabajo de desarrollo.

Cómo funciona la integración de MCP

El Model Context Protocol permite que Claude Code se conecte a servicios externos a través de servidores MCP. Cada servidor puede proporcionar herramientas, prompts y recursos que amplían lo que Claude puede hacer.

El cliente MCP de Claude Code se conecta a dos servidores MCP con herramientas, prompts y recursos, cada uno llamando a un servicio externo.

En este ejemplo, conectaremos Claude Code a un servidor MCP personalizado que proporciona una herramienta de conversión de documentos. Esto permitirá que Claude lea y convierta documentos PDF y Word a formato markdown.

El cliente MCP dentro de Claude Code se conecta a nuestro servidor MCP, que contiene la herramienta document_path_to_markdown.

Agregar un servidor MCP a Claude Code

Configurar un servidor MCP es sencillo. Primero, detén cualquier sesión de Claude Code en ejecución, luego usa el comando MCP add:

bash
claude mcp add documents uv run main.py

Este comando toma dos argumentos:

  • El nombre del servidor (puede ser cualquier cosa que quieras - "documents" en este caso)
  • El comando para iniciar tu servidor MCP

Después de agregar el servidor, reinicia Claude Code y se conectará automáticamente a tu servidor MCP.

Probar la integración

Una vez conectado, Claude puede usar las herramientas proporcionadas por tu servidor MCP. En nuestro ejemplo, podemos pedirle a Claude que convierta archivos de documentos a formato markdown, y usará automáticamente la herramienta de conversión de documentos que creamos.

Claude Code ejecuta la herramienta MCP document_path_to_markdown en mcp_docs.docx, devolviendo markdown con una tabla de primitivas.

La herramienta convierte exitosamente el contenido del documento, mostrando cómo los servidores MCP pueden agregar capacidades completamente nuevas a Claude Code.

Existen muchos servidores MCP que pueden mejorar tu flujo de trabajo de desarrollo:

Extendiendo Claude con MCP: una tabla de seis servidores MCP y lo que cada uno permite hacer a Claude, listados a continuación.

  • sentry-mcp - Descubre y corrige automáticamente errores registrados en Sentry
  • playwright-mcp - Le da a Claude capacidades de automatización de navegador para pruebas y resolución de problemas
  • figma-context-mcp - Expone diseños de Figma a Claude
  • mcp-atlassian - Permite que Claude acceda a Confluence y Jira
  • firecrawl-mcp-server - Agrega capacidades de web scraping a Claude
  • slack-mcp - Permite que Claude publique mensajes o responda a hilos específicos

Construir tu flujo de trabajo personalizado

El verdadero poder viene de combinar múltiples servidores MCP que se ajusten a tus necesidades específicas de desarrollo. Por ejemplo, podrías configurar:

  • Un servidor de Sentry para obtener detalles de errores de producción
  • Un servidor de Jira para leer los requisitos de los tickets
  • Un servidor de Slack para notificar a tu equipo cuando el trabajo esté completo
  • Servidores personalizados para tus herramientas y procesos específicos

Esta flexibilidad hace que Claude Code sea increíblemente adaptable a diferentes entornos y flujos de trabajo de desarrollo. Tómate un tiempo para pensar en qué servicios y herramientas externas usas regularmente - probablemente exista un servidor MCP que pueda integrarlos con Claude Code.