Upliora
Inicio/Blog/MCP Servers para Claude: Guía de Configuración en Español [2026]
Volver al Blog
Tutoriales IA2 de febrero de 202614 min

MCP Servers para Claude: Guía de Configuración en Español [2026]

Configura MCP Servers para Claude Code y Claude Desktop. Tutorial en español con ejemplos: filesystem, GitHub, bases de datos, APIs personalizadas.

MCP Servers para Claude: Guía de Configuración en Español [2026]

MCP (Model Context Protocol) es el estándar de Anthropic para conectar Claude con herramientas externas. Piensa en MCP como el "USB-C de la IA": un protocolo universal que permite a cualquier aplicación comunicarse con modelos de lenguaje de forma estandarizada.

¿Qué es MCP y Por Qué es Importante?

MCP resuelve un problema fundamental: los LLMs están aislados del mundo real. Sin MCP, Claude no puede:

  • Leer archivos de tu ordenador
  • Ejecutar código
  • Consultar bases de datos
  • Interactuar con APIs

Con MCP, Claude se convierte en un agente que puede actuar, no solo responder.

Arquitectura de MCP

code 
1Tu App (Claude Desktop/Code)
2         ↓
3    Cliente MCP
4         ↓
5    Servidor MCP ←→ Herramienta Externa
6         ↓              (GitHub, DB, etc.)
7    Recursos/Tools

Configuración Básica de MCP

Ubicación del Archivo de Configuración

macOS/Linux:

code 
1~/.claude/claude_desktop_config.json

Windows:

code 
1%APPDATA%\Claude\claude_desktop_config.json

Estructura del Archivo

json 
1{
2  "mcpServers": {
3    "nombre-servidor": {
4      "command": "comando-a-ejecutar",
5      "args": ["argumentos"],
6      "env": {
7        "VARIABLE": "valor"
8      }
9    }
10  }
11}

MCP Servers Oficiales de Anthropic

1. Filesystem Server

Permite a Claude leer y escribir archivos en directorios específicos.

json 
1{
2  "mcpServers": {
3    "filesystem": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "@anthropic-ai/mcp-server-filesystem",
8        "/Users/tu-usuario/proyectos",
9        "/Users/tu-usuario/documentos"
10      ]
11    }
12  }
13}

Capacidades:

  • Leer archivos de texto y binarios
  • Escribir y modificar archivos
  • Listar directorios
  • Crear y eliminar archivos

2. GitHub Server

Integración completa con repositorios de GitHub.

json 
1{
2  "mcpServers": {
3    "github": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-github"],
6      "env": {
7        "GITHUB_TOKEN": "ghp_tu_token_aqui"
8      }
9    }
10  }
11}

Capacidades:

  • Crear y revisar PRs
  • Gestionar issues
  • Buscar en repositorios
  • Ver commits y branches

3. PostgreSQL Server

Consultas directas a bases de datos PostgreSQL.

json 
1{
2  "mcpServers": {
3    "postgres": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
6      "env": {
7        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/db"
8      }
9    }
10  }
11}

Capacidades:

  • Ejecutar consultas SELECT
  • Describir esquemas de tablas
  • Listar tablas y relaciones

4. Brave Search Server

Búsquedas web en tiempo real.

json 
1{
2  "mcpServers": {
3    "brave-search": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-brave-search"],
6      "env": {
7        "BRAVE_API_KEY": "tu-api-key"
8      }
9    }
10  }
11}

MCP Servers de la Comunidad

n8n MCP Server

El más potente para automatización. Conecta Claude con los 1,084 nodos de n8n.

json 
1{
2  "mcpServers": {
3    "n8n": {
4      "command": "npx",
5      "args": ["-y", "n8n-mcp-server"],
6      "env": {
7        "N8N_API_KEY": "tu-api-key",
8        "N8N_BASE_URL": "http://localhost:5678"
9      }
10    }
11  }
12}

Capacidades:

  • Ejecutar workflows de n8n
  • Crear automatizaciones
  • Conectar con 500+ apps (Slack, Gmail, Notion, etc.)

Obsidian MCP Server

Para usuarios de Obsidian que quieren Claude integrado con sus notas.

json 
1{
2  "mcpServers": {
3    "obsidian": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-obsidian"],
6      "env": {
7        "OBSIDIAN_VAULT_PATH": "/ruta/a/tu/vault"
8      }
9    }
10  }
11}

Slack MCP Server

json 
1{
2  "mcpServers": {
3    "slack": {
4      "command": "npx",
5      "args": ["-y", "@anthropic-ai/mcp-server-slack"],
6      "env": {
7        "SLACK_BOT_TOKEN": "xoxb-tu-token"
8      }
9    }
10  }
11}

Configuración Completa de Ejemplo

Aquí tienes una configuración real con múltiples servers:

json 
1{
2  "mcpServers": {
3    "filesystem": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "@anthropic-ai/mcp-server-filesystem",
8        "/Users/dev/proyectos"
9      ]
10    },
11    "github": {
12      "command": "npx",
13      "args": ["-y", "@anthropic-ai/mcp-server-github"],
14      "env": {
15        "GITHUB_TOKEN": "ghp_xxxxx"
16      }
17    },
18    "postgres": {
19      "command": "npx",
20      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
21      "env": {
22        "POSTGRES_CONNECTION_STRING": "postgresql://localhost:5432/mydb"
23      }
24    },
25    "n8n": {
26      "command": "npx",
27      "args": ["-y", "n8n-mcp-server"],
28      "env": {
29        "N8N_API_KEY": "n8n_api_xxxxx",
30        "N8N_BASE_URL": "http://localhost:5678"
31      }
32    }
33  }
34}

Crear tu Propio MCP Server

MCP es un protocolo abierto. Puedes crear servers personalizados para cualquier herramienta.

Estructura Básica (TypeScript)

typescript 
1import { Server } from "@anthropic-ai/mcp-server";
2 
3const server = new Server({
4  name: "mi-servidor-custom",
5  version: "1.0.0"
6});
7 
8// Definir una herramienta
9server.tool("mi_herramienta", {
10  description: "Descripción de lo que hace",
11  parameters: {
12    type: "object",
13    properties: {
14      param1: { type: "string", description: "Descripción" }
15    }
16  },
17  handler: async ({ param1 }) => {
18    // Lógica de la herramienta
19    return { resultado: "éxito" };
20  }
21});
22 
23server.start();

Publicar en npm

bash 
1npm publish --access public

Troubleshooting de MCP

Error: "Server not found"

  1. Verifica que npx funciona: npx --version
  2. Reinstala el server: npx -y @anthropic-ai/mcp-server-xxx
  3. Revisa la ruta del archivo de configuración

Error: "Permission denied"

bash 
1chmod +x ~/.claude/claude_desktop_config.json

Error: "Connection refused"

Para servers que conectan a servicios locales (Postgres, n8n):

  1. Verifica que el servicio está corriendo
  2. Revisa que el puerto es correcto
  3. Comprueba firewall/antivirus

Ver Logs de MCP

bash 
1# macOS/Linux
2tail -f ~/.claude/logs/mcp.log
3 
4# Windows
5Get-Content "$env:APPDATA\Claude\logs\mcp.log" -Wait

Seguridad con MCP

Principios Básicos

  1. Mínimo privilegio: Solo da acceso a los directorios necesarios
  2. Tokens rotados: Cambia API keys regularmente
  3. Variables de entorno: Nunca hardcodees secrets en el JSON
  4. Auditoría: Revisa qué hace Claude con los permisos

Ejemplo Seguro

json 
1{
2  "mcpServers": {
3    "filesystem": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "@anthropic-ai/mcp-server-filesystem",
8        "/Users/dev/proyecto-actual"
9      ]
10    }
11  }
12}

NO hagas esto:

json 
1{
2  "args": ["@anthropic-ai/mcp-server-filesystem", "/"]
3}

MCP vs Alternativas

CaracterísticaMCPOpenAI FunctionsLangChain Tools
EstandarizadoSíNoNo
Protocolo abiertoSíNoSí
EcosystemCreciendoGrandeGrande
SetupMedioFácilComplejo
Mejor paraClaudeGPTMulti-modelo

Conclusión

MCP es el futuro de la integración de IA con herramientas externas. Con una configuración inicial sencilla, transformas Claude de un chatbot a un agente capaz de interactuar con todo tu stack tecnológico.

Recursos adicionales:

Posts Relacionados

Cómo Usar Claude Code en Terminal: Tutorial Paso a Paso [2026]

Tutorial completo de Claude Code CLI. Aprende a usar el agente de código de Anthropic en terminal para automatizar desarrollo, refactoring y tareas complejas.

Gemini 3 Deep Think: Cómo Usar el Modo Razonamiento de Google [2026]

Guía de Gemini 3 Deep Think, el modo de razonamiento avanzado de Google. Cómo activarlo, cuándo usarlo, comparativa con GPT-5.2 Thinking y casos de uso.

Crear Chatbot WhatsApp con n8n Gratis: Tutorial Completo [2026]

Crea un chatbot de WhatsApp con IA usando n8n gratis. Tutorial paso a paso: configuración, integración con ChatGPT/Claude, y automatización de respuestas.

JS

Javier Santos Criado

Consultor de IA y Automatización | Fundador de Javadex

Experto en implementación de soluciones de Inteligencia Artificial para empresas. Especializado en automatización con n8n, integración de LLMs, y desarrollo de agentes IA.

javadex.esYouTubeTikTokLinkedIn

¿Quieres más contenido de IA?

Explora nuestras comparativas y guías

Ver ComparativasYouTube @JavadexAI