Cómo crear un servidor MCP en Claude Desktop: una guía práctica

Desde la presentación pública de Anthropic del Protocolo de contexto modelo (MCP) on **25 de noviembre.**MCP ha pasado rápidamente del concepto a un ecosistema práctico: se dispone de una especificación abierta y múltiples servidores de referencia, las implementaciones de la comunidad (servidores de memoria, acceso al sistema de archivos, capturadores web) están en GitHub y NPM, y MCP ya es compatible con clientes como Claude para escritorio y herramientas de terceros. El protocolo ha evolucionado (la especificación y los ejemplos de servidor se han actualizado hasta 2025), y los proveedores e ingenieros están publicando patrones para integraciones más seguras y eficientes en el uso de tokens.

Este artículo le guía a través de la creación de un servidor MCP y su conexión a Escritorio de Claudey consejos prácticos / de seguridad / de memoria que necesitará en producción.

¿Qué es el Protocolo de Contexto Modelo (MCP)?

Una definición en lenguaje sencillo

El Protocolo de Contexto Modelo (MCP) es un protocolo abierto y estandarizado Esto facilita que los hosts de LLM (las aplicaciones que ejecutan el modelo, por ejemplo, Claude Desktop) se comuniquen con servicios externos que exponen recursos (archivos, filas de la base de datos), (funciones que el modelo puede invocar), y ideas (plantillas que el modelo puede usar). En lugar de implementar integraciones N×M (cada modelo con cada herramienta), MCP proporciona un esquema cliente-servidor consistente y un contrato de tiempo de ejecución para que cualquier host de modelos compatible con MCP pueda usar cualquier servidor compatible con MCP; así, los desarrolladores pueden crear servicios una sola vez y permitir que cualquier modelo o interfaz de usuario compatible con MCP (por ejemplo, Claude Desktop) los use.

Por qué MCP importa ahora

Desde que Anthropic liberó el código fuente de MCP a finales de 2024, el protocolo se ha convertido rápidamente en una capa de interoperabilidad estándar para la integración de herramientas (Claude, extensiones de VS Code y otros entornos de agentes). MCP reduce el trabajo duplicado, acelera el desarrollo de conectores (Google Drive, GitHub, Slack, etc.) y facilita la conexión de almacenamiento de memoria persistente a un asistente.

¿Qué es la arquitectura MCP y cómo funciona?

A grandes rasgos, MCP define tres grupos de roles y varios patrones de interacción.

Componentes principales: clientes, servidores y el registro

Cliente MCP (host): El host o la aplicación LLM que requiere datos contextuales (Claude Desktop, un agente de VS Code o una aplicación web) se encarga de detectar y conectarse a uno o más servidores MCP.
Servidor MCP (proveedor de recursos): Un servicio de red que expone recursos (archivos, memoria, bases de datos, acciones) mediante el esquema MCP. Los servidores declaran sus capacidades y proporcionan puntos de conexión a los que el cliente puede llamar.
Registro / Descubrimiento: Componentes opcionales o archivos de configuración que ayudan al cliente a descubrir los servidores MCP disponibles, enumerar las capacidades y administrar los permisos o la instalación (las “extensiones” de escritorio son una capa de UX para esto).

Flujos de mensajes y negociación de capacidades

Las interacciones MCP suelen seguir este patrón:

Descubrimiento / registro: El cliente se informa sobre los servidores disponibles (locales, de red o registros seleccionados).
Anuncio de capacidades: El servidor comparte un manifiesto que describe los recursos, los métodos y los requisitos de autorización.
Solicitud/respuesta: El cliente emite solicitudes estructuradas (por ejemplo, “leer archivo X”, “buscar en la memoria Y” o “crear solicitud de extracción con estos archivos”) y el servidor responde con datos contextuales tipados.
Resultados de la acción y transmisión: Los servidores pueden transmitir resultados o proporcionar puntos de conexión para operaciones de larga duración. La especificación define esquemas para descriptores de recursos tipados y respuestas.

Modelo de seguridad y límites de confianza

MCP estandariza intencionadamente las superficies de control para que los LLM puedan actuar sobre los datos del usuario y realizar acciones. Esta capacidad requiere controles de seguridad rigurosos:

Consentimiento explícito del usuario / avisos Se recomienda su uso cuando los servidores pueden acceder a datos privados o realizar acciones privilegiadas (por ejemplo, escribir en repositorios).
El principio del mínimo privilegio se manifiesta: Los servidores deben declarar los ámbitos mínimos y los clientes deben solicitar únicamente las capacidades necesarias.
Transporte y autorización: Para integraciones sensibles, utilice TLS, credenciales tokenizadas y puntos de conexión locales. La comunidad y los proveedores de plataformas (p. ej., Microsoft en Windows) están experimentando con registros y funcionalidades de la interfaz de usuario para reducir los riesgos.

¿Por qué integrar Claude con servidores MCP?

La integración de Claude con los servidores MCP desbloquea tres clases prácticas de capacidades:

Contexto práctico en tiempo real

En lugar de copiar e insertar instantáneas obsoletas en las solicitudes, Claude puede solicitar contexto actualizado (archivos, historial de conversaciones, filas de la base de datos) al momento de la consulta. Esto se traduce en menos consultas aproximadas y resultados más recientes. Las demostraciones de Anthropic muestran a Claude realizando tareas como crear solicitudes de extracción en GitHub o leer archivos locales mediante MCP.

Herramientas pequeñas y componibles en lugar de un adaptador gigante

Puedes crear servidores MCP especializados —uno para el calendario, otro para el sistema de archivos, otro para el almacenamiento vectorial en memoria— y reutilizarlos en diferentes instancias o clientes de Claude (escritorio, IDE, web). Esta modularidad ofrece una mejor escalabilidad que las integraciones a medida.

Memoria persistente y estandarizada

MCP permite servicios de memoria: almacenamientos persistentes que codifican el historial de conversaciones, las preferencias personales y el estado estructurado del usuario. Dado que MCP estandariza el modelo de recursos, varios clientes pueden reutilizar el mismo servidor de memoria y mantener un contexto de usuario coherente entre aplicaciones. Ya existen varios servicios de memoria comunitarios y patrones de extensión.

Mejor experiencia de usuario y control local (Claude Desktop)

En clientes de escritorio, MCP permite que los servidores locales accedan directamente al sistema de archivos del usuario (con su consentimiento), lo que facilita integraciones que requieren privacidad sin necesidad de API en la nube. Las extensiones de escritorio de Anthropic son un ejemplo de cómo simplificar la instalación y la detección de servidores MCP en máquinas locales.

Cómo crear un servidor MCP

Lo que necesitas antes de empezar

Escritorio de ClaudeInstala la última versión de Claude Desktop para tu sistema operativo y asegúrate de que la compatibilidad con MCP/Extensiones esté habilitada en la configuración. Algunas funciones pueden requerir un plan de pago (Claude Pro o equivalente).
máquina reveladoraSe recomienda Node.js (versión 16/18 o superior) o Python 3.10 o superior, además de ngrok o una solución de túnel local si se desea exponer un servidor local a internet para realizar pruebas. En producción, utilice TLS.
El proyecto MCP proporciona SDK y plantillas en la documentación principal y en el repositorio de GitHub; instale el SDK de Python o Node siguiendo las instrucciones oficiales en la documentación/repositorio.

Opción A: Instalar un servidor MCP existente (por ejemplo).

Anthropic proporciona servidores de ejemplo, incluyendo memoria, sistema de archivos y herramientas.

Clonar los servidores de referencia:

git clone https://github.com/modelcontextprotocol/servers.git
cd servers

En su interior encontrará carpetas como las siguientes:

filesystem/
fetch/
memory/
weather/

Para instalar un servidor de ejemplo:

cd memory
npm install
npm run dev

Esto inicia el servidor MCP, normalmente en:

http://localhost:3000

Comprueba que el punto final del manifiesto funciona y que al llamar a una herramienta se devuelve un JSON con el tipo correcto.

Opción B — Crea tu propio servidor MCP (recomendado para aprender)

1) Crea una carpeta de proyecto

mkdir my-mcp-server
cd my-mcp-server
npm init -y

2) Instale el SDK del servidor MCP

npm install @modelcontextprotocol/server

3) Crea un archivo de servidor básico

Crea server.js:

touch server.js

Pegue la implementación mínima del servidor MCP:

import { createServer } from "@modelcontextprotocol/server";

const server = createServer({
  name: "my-custom-server",
  version: "0.1.0",

  tools: [
    {
      name: "hello_world",
      description: "Returns a simple greeting",
      input_schema: {
        type: "object",
        properties: {
          name: { type: "string" }
        },
        required: 
      },
      output_schema: {
        type: "object",
        properties: {
          message: { type: "string" }
        }
      },
      handler: async ({ name }) => {
        return { message: `Hello, ${name}!` };
      }
    }
  ]
});

server.listen(3000);
console.log("MCP server running on http://localhost:3000");

Esto es una Servidor MCP completo Exponiendo una sola herramienta: hello_world.

¿Cómo conectar Claude Desktop a un servidor MCP?

A continuación se presenta una guía práctica para crear un servidor MCP sencillo y registrarlo en Claude Desktop. Esta sección es práctica: abarca la configuración del entorno, la creación del manifiesto del servidor, la exposición de los endpoints que espera el cliente y la configuración de Claude Desktop para usar el servidor.

1) Abra el área de conexión para desarrolladores de Claude Desktop.

En Claude Desktop: Configuración → Desarrollador (o Configuración → Conectores (Dependiendo de la versión del cliente). Existe la opción de agregar un servidor MCP remoto/local o "Agregar conector". La interfaz de usuario exacta puede cambiar entre versiones; si no la ve, consulte el menú "Desarrollador" de la aplicación de escritorio o las notas de la última versión.

Servidor MCP en el escritorio de Claude

2) Si está configurando un servidor local: Cree o localice el archivo de configuración

Tras iniciar la aplicación de escritorio Claude, esta configura automáticamente todos los servidores MCP encontrados en un archivo llamado ClaudeDesktopConfig.json. El primer paso consiste en localizar y abrir este archivo, o crearlo si aún no existe:

Para los usuarios de Windows, el archivo se encuentra en “%APPDATA%\Claude\claude_desktop_config.json”.

Para los usuarios de Mac, el archivo se encuentra en “~/Library/Application Support/Claude/claude_desktop_config.json”.

3) Agrega el servidor a Claude Desktop

Existen dos patrones de UX para que Claude Desktop reconozca su servidor MCP:

Extensiones de escritorio / Instaladores con un clicAnthropic ha documentado las «Extensiones de Escritorio», que empaquetan manifiestos e instaladores para que los usuarios puedan añadir servidores con un solo clic (recomendado para una distribución más amplia). Puede empaquetar su manifiesto y los metadatos del servidor para facilitar la instalación.

**Registro del servidor local (modo desarrollador)**Para pruebas locales:

Coloca el manifiesto en una ruta local conocida o sírvelo en https://localhost:PORT/.well-known/mcp-manifest.json.
En la configuración de Claude Desktop, abra el panel MCP/Extensiones y seleccione “Agregar servidor local” o “Agregar servidor por URL”, y pegue la URL del manifiesto o el token.
Conceda los permisos necesarios cuando el cliente lo solicite. Claude enumerará los recursos del servidor y los presentará como herramientas/memorias disponibles.

Ahora optamos por instalar el MCP local:Agregue un mcpServers . que muestra el nombre de tu servidor y la ruta/comando absoluto para iniciarlo. Guarda y reinicia Claude Desktop.

Tras reiniciar, la interfaz de usuario de Claude mostrará las herramientas MCP (icono de Búsqueda y Herramientas) y le permitirá probar las operaciones disponibles (p. ej., «¿Qué tiempo hace en Sacramento?»). Si el host no detecta su servidor, consulte la documentación. mcp.log y archivos mcp-server-<name>.log para la salida STDERR.

4) Probar la integración

En el chat de Claude, escribe:

Call the hello_world tool with name="Alice"

Claude invocará tu servidor MCP y responderá utilizando la salida de la herramienta.

¿Cómo implemento un servicio de memoria sobre MCP (consejos avanzados)?

Los servicios en memoria se encuentran entre los servidores MCP más potentes, ya que conservan y exponen el contexto del usuario entre sesiones. Las siguientes buenas prácticas y consejos de implementación reflejan la especificación, la documentación de Claude y los patrones de la comunidad.

Modelo y diseño de datos de memoria

Estructurado frente a no estructurado: Almacena tanto datos estructurados (p. ej., nombre, indicadores de preferencia) como fragmentos de conversación no estructurados. Utiliza metadatos tipados para un filtrado rápido.
Segmentación e incrustaciones: Divide los documentos o conversaciones largas en fragmentos semánticamente coherentes y almacena sus representaciones vectoriales para facilitar la búsqueda por similitud. Esto mejora la recuperación de datos y reduce el uso de tokens durante la recuperación.
Señales de actualidad y relevancia: Registra marcas de tiempo y puntuaciones de relevancia; permite consultas que priorizan los recuerdos recientes o de alta relevancia.
Etiquetas de privacidad: Etiquete los elementos con etiquetas de sensibilidad (privado, compartido, efímero) para que el cliente pueda solicitar el consentimiento.

Patrones de API para operaciones de memoria

Implementar al menos tres operaciones:

write: Acepta un elemento de memoria con metadatos, devuelve un acuse de recibo y el ID de almacenamiento.
query: Acepta una consulta en lenguaje natural o un filtro estructurado y devuelve los k recuerdos que mejor coinciden (opcionalmente con metadatos de explicabilidad).
delete/update: Admite operaciones de ciclo de vida y solicitudes explícitas del usuario para olvidar.

Las respuestas del diseño deben incluir la procedencia (de dónde proviene el recuerdo) y una puntuación de confianza/similitud para que el cliente y el modelo puedan decidir con qué frecuencia utilizar el recuerdo.

Estrategias de aumento de recuperación para Claude

Ventanas de contexto breves: Devuelve fragmentos de memoria concisos en lugar de documentos completos; deja que Claude solicite el contexto completo si es necesario.
Capa de resumen: Opcionalmente, almacene un breve resumen de cada entrada de memoria para reducir el número de tokens. Utilice la generación de resúmenes incrementales en las escrituras.
Inyección controlada: Proporcionar memoria como un “paquete de contexto” adjuntable que el cliente pueda inyectar selectivamente en las solicitudes en lugar de inundar el modelo con todo.

Seguridad y gobernanza para MCP de memoria

Consentimiento y registro de auditoría: Registra cuándo se creó un recuerdo y si el usuario consintió en compartirlo con el modelo. Presenta opciones de interfaz de usuario claras en Claude Desktop para revisar y revocar recuerdos.
Limitación de velocidad y validación: Protéjase contra la inyección rápida o la exfiltración validando los tipos y bloqueando las solicitudes de ejecución de código inesperadas desde los servidores.
Cifrado en reposo y en tránsito: Utilice cifrado robusto para los elementos almacenados y TLS para todos los puntos de conexión de MCP. Para los almacenes en la nube, utilice cifrado de sobre o claves gestionadas por el cliente, si están disponibles.

Conclusión: Cómo crear un servidor MCP en Claude Desktop

El artículo es una receta compacta y pragmática para pasar de cero a un servidor Claude + memoria funcional en tu portátil:

Prueba un flujo de trabajo: Pídele a Claude que «recuerde» un dato breve y verifica que el servidor lo haya almacenado; luego, pídele que lo recuerde en una solicitud posterior. Observa los registros y ajusta el orden de recuperación.
Requisitos previos de instalación: Node.js >= 18, Git, Claude Desktop (última versión).
Clonar un servidor de referencia: bifurcar el modelcontextprotocol/servers ejemplos o un servidor de memoria comunitaria en GitHub.
Instalar y ejecutar: npm install → npm run dev (o siga las instrucciones del archivo README del repositorio). Confirme el punto final del manifiesto (p. ej., http://localhost:3000/manifest) devuelve JSON. ()
Conector de registro en Claude Desktop: Configuración → Desarrollador / Conectores → Agregar conector → apuntar a http://localhost:3000 y aprobar los alcances.

La integración de Claude (o cualquier host) con servidores MCP le permite crear un conector una sola vez y tenerlo disponible en todos los clientes MCP (Claude Desktop, IDE u otros marcos de agentes), lo que reduce drásticamente el mantenimiento y acelera la paridad de funciones entre las herramientas.

Los desarrolladores pueden acceder a la última API de Claude AI (a la fecha de publicación de este artículo), como por ejemplo: Claude Sonnet 4.5 API y API de Claude Opus 4.1 a través de CometAPI, la última versión del modelo Se actualiza constantemente con el sitio web oficial. Para empezar, explora las capacidades del modelo en el Playground y consultar el Guía de API Para obtener instrucciones detalladas, consulte la sección "Antes de acceder, asegúrese de haber iniciado sesión en CometAPI y de haber obtenido la clave API". CometAPI Ofrecemos un precio muy inferior al oficial para ayudarte a integrarte.

¿Listo para ir?→ Regístrate en CometAPI hoy !

Si quieres conocer más consejos, guías y novedades sobre IA síguenos en VK, X y Discord!