Blog

Cómo Crear, Desplegar y Alojar Servidores de Minecraft (MCP) en Netlify

Ashley Goolam

Ashley Goolam

15 July 2025

Cómo Crear, Desplegar y Alojar Servidores de Minecraft (MCP) en Netlify

¿Estás listo para potenciar tus flujos de trabajo de IA con el Servidor MCP en Netlify? Imagina dar a tus agentes de IA —como Claude, Cursor o VS Code Copilot— una línea directa a las herramientas y datos de tu plataforma, todo alojado en la impecable infraestructura sin servidor de Netlify. En esta guía divertida y conversacional, exploraremos qué es el Servidor MCP en Netlify, por qué es increíble y cómo construirlo, desplegarlo y alojarlo paso a paso. Además, lo probaremos con un ejemplo genial para asegurarnos de que funciona. ¡Vamos a sumergirnos y hacer tu IA más inteligente!

💡
¿Quieres una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje junto con máxima productividad?

¡Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
button

¿Qué es un servidor MCP y por qué Netlify?

El Protocolo de Contexto de Modelo (MCP) es como un adaptador universal para agentes de IA. Es un estándar abierto y ligero que permite a los clientes de IA (por ejemplo, Claude Desktop o Cursor) comunicarse con servidores que exponen herramientas, datos y prompts. Esto significa que tu IA puede interactuar con las características de tu aplicación en tiempo real, haciéndola consciente del contexto y mucho más útil.

Alojar tu Servidor MCP en Netlify es una obviedad. La plataforma sin servidor de Netlify es escalable, de bajo mantenimiento y perfecta para desplegar servidores MCP. Se encarga del trabajo pesado —picos de tráfico, actualizaciones y seguridad— para que puedas concentrarte en construir integraciones de IA geniales. Ya sea que estés añadiendo IA a un blog, un sitio de comercio electrónico o una aplicación personalizada, el Servidor MCP en Netlify lo hace sin problemas.

sitio web oficial de netlify

¿Por qué te encantará alojar servidores MCP en Netlify?

Aquí te explicamos por qué el Servidor MCP en Netlify cambia las reglas del juego:

¿Listo para dar vida a tu IA? ¡Vamos a configurar tu Servidor MCP en Netlify!

desplegar en netlify

Construyendo, Desplegando y Alojanado Servidores MCP en Netlify

Requisitos previos

Antes de empezar, asegúrate de tener:

Paso 1: Configura tu proyecto de Netlify

Configurar la estructura del proyecto:

Estructura de ejemplo:

/mcp-netlify
  /netlify
    /functions
      mcp.js

Crear un sitio de Netlify:

Paso 2: Implementar la función del servidor MCP

Crea el archivo mcp.js en /netlify/functions para definir tu Servidor MCP en Netlify. Esto utiliza el SDK de MCP para exponer herramientas, recursos y prompts a los clientes de IA.

Aquí tienes un ejemplo para mcp.js:

import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
import { toFetchResponse, toReqRes } from "fetch-to-node";
import { z } from "zod";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import {
  CallToolResult,
  ReadResourceResult,
  JSONRPCError
} from "@modelcontextprotocol/sdk/types.js";

// Controlador de función sin servidor de Netlify que maneja todas las solicitudes entrantes
export default async (req: Request) => {

  try {

    // para MCP sin estado, solo usaremos las solicitudes POST que se envían
    // con información de eventos para la fase de inicialización y solicitudes de recursos/herramientas
    if (req.method === "POST") {

      // Convierte el objeto Request en un objeto Request de Node.js
      const { req: nodeReq, res: nodeRes } = toReqRes(req);
      const server = getServer();

      const transport = new StreamableHTTPServerTransport({
        sessionIdGenerator: undefined,
      });

      await server.connect(transport);

      const body = await req.json();
      await transport.handleRequest(nodeReq, nodeRes, body);

      nodeRes.on("close", () => {
        console.log("Request closed");
        transport.close();
        server.close();
      });

      return toFetchResponse(nodeRes);

    }

    return new Response("Method not allowed", { status: 405 });

  } catch (error) {

    console.error("MCP error:", error);
    return new Response(
      JSON.stringify({
        jsonrpc: "2.0",
        error: {
          code: -32603,
          message: "Internal server error",
        },
        id: '',
      } satisfies JSONRPCError),
      {
        status: 500,
        headers: { "Content-Type": "application/json" }
      }
    );
  }
};

function getServer(): McpServer {

  // inicializa nuestra instancia del servidor MCP que
  // adjuntará toda nuestra funcionalidad y datos.
  const server = new McpServer(
    {
      name: "acme-devtool-server",
      version: "1.0.0",
    },
    { capabilities: { logging: {} } }
  );


  server.tool(
    "run-analysis-report",
    "Checks the data available in Acme Devtool and returns all of the important data regarding the latest numbers.",
    {
      days: z.number().describe("Number of days to analyze").default(7),
    },
    async (
      { days },
    ): Promise<CallToolResult> => {

      const random = Math.random() * 100;

      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              lastNDays: days,
              data: Array.from({ length: days }, (_, i) => `Day ${i + 1} had ${random * days} growth.`),
            }),
          },
        ],
      };
    }
  );

  // proporcionando un recurso para agentes que puedan necesitar tomar un informe dado
  // y analizar la información en él
  server.resource(
    "interpreting-reports",
    "acme://interpreting-reports",
    { mimeType: "text/plain" },
    async (): Promise<ReadResourceResult> => {
      return {
        contents: [
          {
            uri: "acme://interpreting-reports",
            text: `Reports from Acme will include an array of text that informs the growth of over that number of days. It's unstructured text but is consistent so parsing the information can be based on looking at a single line to understand where the data is.`,
          },
        ],
      };
    }
  );

  return server;
};

// Asegúrate de que esta función responda a la ruta /mcp
// Esta puede ser cualquier ruta que desees, pero deberás asegurarte de que la
// configuración del servidor mcp que uses/compartas coincida con esta ruta.
export const config = {
  path: "/mcp"
};

Esto crea un endpoint MCP sin servidor en /.netlify/functions/mcp. Personaliza tools, resources y prompts según las necesidades de tu aplicación (por ejemplo, llamadas a API, consultas a bases de datos).

Paso 3: Instalar dependencias

En la carpeta de tu proyecto, inicializa un proyecto Node.js e instala el SDK de MCP:

npm init -y
npm install @modelcontextprotocol/sdk

Paso 4: Desarrollo y pruebas locales

  1. Instalar la CLI de Netlify:
npm install -g netlify-cli

2. Ejecutar localmente:

netlify dev

Esto inicia un servidor local en http://localhost:8888. Tu Servidor MCP en Netlify estará disponible en:

http://localhost:8888/.netlify/functions/mcp

3. Probar con el Inspector MCP:

Usa el Inspector MCP para verificar tu servidor:

npx @modelcontextprotocol/inspector npx mcp-remote@next http://localhost:8888/mcp

Abre http://localhost:6274 en tu navegador para explorar las herramientas y recursos de tu servidor de forma interactiva.

probar con el inspector mcp

Paso 5: Despliega tu servidor MCP en Netlify

Tienes dos opciones de despliegue:

Opción 1: Despliegue basado en Git

  1. Sube tu proyecto a un repositorio de GitHub, GitLab o Bitbucket.
  2. En Netlify, vincula el repositorio a tu sitio en **Site configuration > Build & deploy** (Configuración del sitio > Compilación y despliegue).
  3. Netlify se despliega automáticamente en cada push a tu rama principal.
instalar netlify en el repositorio de github

Opción 2: Despliegue con CLI

Despliega directamente con la CLI de Netlify:

netlify deploy

Para producción:

netlify deploy --prod

Después del despliegue, tu Servidor MCP en Netlify estará activo en:

https://your-site-name.netlify.app/.netlify/functions/mcp

Toma nota de la URL para el siguiente paso.

Paso 6: Conecta clientes MCP a tu servidor MCP de Netlify

Configura tu cliente de IA (Claude Desktop, Cursor, Windsurf o VS Code Copilot) para que se conecte a tu Servidor MCP en Netlify desplegado. Usa una de estas configuraciones:

Para pruebas locales

{
  "mcpServers": {
    "my-netlify-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote@next",
        "http://localhost:8888/mcp"
      ]
    }
  }
}

Para servidor desplegado

{
  "mcpServers": {
    "my-netlify-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote@next",
        "https://your-site-name.netlify.app/mcp"
      ]
    }
  }
}

Reemplaza your-site-name.netlify.app con la URL real de tu sitio de Netlify.

Configuración del cliente

Claude Desktop:

  1. Ve a **Settings > Developer > Edit Config** (Configuración > Desarrollador > Editar configuración).
  2. Abre claude_desktop_config.json, pega la configuración y guarda.
  3. Reinicia Claude Desktop.
configuración mcp de edición de claude

Cursor:

  1. Ve a **Settings > Tools and Integrations > Add a Custom MCP Server** (Configuración > Herramientas e Integraciones > Añadir un Servidor MCP Personalizado).
  2. Pega la configuración y guarda.
  3. Cambia a **Agent Mode** (Modo Agente) en el panel de chat.
editar configuración mcp del cursor

VS Code Copilot:

  1. Abre **Settings** (Configuración) (Ctrl+, o Cmd+,).
  2. Busca “MCP” y actívalo en **Features > Chat** (Características > Chat).
  3. Haz clic en **Edit in settings.json** (Editar en settings.json), pega la configuración y guarda.
editar configuración mcp de vs code

Paso 7: Prueba tu servidor MCP

Vamos a probar tu Servidor MCP en Netlify con un prompt de ejemplo en tu cliente MCP:

Usando el Servidor MCP en Netlify, ¿puedes ejecutar un informe de los últimos 3 días?

Si usaste el ejemplo de mcp.js anterior, la IA debería responder con algo como:

probando el servidor mcp remoto

Esto confirma que tu servidor está funcionando. Personaliza tu mcp.js para añadir herramientas reales (por ejemplo, integraciones de API, consultas a bases de datos) para tareas más complejas.

Paso 8: Inspeccionar y depurar

npx @modelcontextprotocol/inspector npx mcp-remote@next https://your-site-name.netlify.app/mcp

Mejores prácticas para servidores MCP en Netlify

Consejos para la resolución de problemas

¿Por qué alojar servidores MCP en Netlify?

El Servidor MCP en Netlify es una combinación perfecta para flujos de trabajo impulsados por IA. La plataforma sin servidor de Netlify escala sin esfuerzo, por lo que tu servidor MCP puede manejar miles de solicitudes de IA sin colapsar. Además, su despliegue basado en Git y su CLI facilitan las actualizaciones. Ya sea que estés construyendo un chatbot, una herramienta de gestión de contenido o una integración de comercio electrónico, alojar tu Servidor MCP en Netlify asegura que tus agentes de IA tengan acceso en vivo y dinámico a las características de tu plataforma.

Por ejemplo, podrías crear una herramienta MCP para obtener datos de usuario de la API de tu aplicación o activar flujos de trabajo automatizados basados en prompts de IA. La configuración sin servidor significa que no necesitas administrar servidores, solo codificar, desplegar y dejar que Netlify haga el resto.

Conclusión

¡Y ahí lo tienes! Acabas de aprender a construir, desplegar y alojar un Servidor MCP en Netlify, convirtiendo a tus agentes de IA en potencias de productividad. Desde configurar una simple función sin servidor hasta conectarla con Claude, Cursor o VS Code, esta guía facilita la integración de la IA con tu plataforma. Nuestro prompt de prueba —“procesa la consulta: ¡Hola, Netlify!”— muestra lo sencillo que es empezar.

¿Listo para ir más allá? Añade herramientas personalizadas a tu mcp.js, como llamadas a API o consultas a bases de datos, y observa cómo tu IA hace cosas asombrosas.

💡
¿Quieres una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje junto con máxima productividad?

¡Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
button

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs

Registrarse gratisDescargar