Servidor MCP con Claude: definir herramientas antes de conectar una API

Preparar un servidor con MCP Builder →

Quiere que Claude consulte directamente la base de proyectos de su despacho, actualice un estado en su herramienta de gestión o compruebe la situación de una cuenta de cliente, sin que alguien copie y pegue esos datos a mano en cada conversación. Esa conexión directa entre un asistente de IA y una herramienta interna pasa, técnicamente, por lo que el protocolo llama un servidor MCP (Model Context Protocol): un programa que expone un número reducido de acciones precisas al asistente, en lugar de un acceso bruto a toda su base.

Hay que decirlo desde el principio, sin rodeos: el skill MCP Builder no construye ese servidor por usted dentro de una conversación. Le ayuda a escribir el código, en un entorno de desarrollo con una terminal — Claude Code, o cualquier editor equivalente donde el código pueda ejecutarse realmente. Nada de lo que produce este paquete funciona si simplemente lo añade a una conversación normal de Claude, ChatGPT o Gemini: el archivo obtenido al final es código fuente que hay que compilar y desplegar, no una respuesta que aparece en un chat.

Este artículo detalla lo que hace realmente este skill, por qué supone una persona desarrolladora o en proceso de formarse como tal, y dónde se detiene — antes del despliegue y de la conexión a una cuenta real.

Sumario

1. Por qué conectar Claude a una herramienta interna en lugar de copiar y pegar datos
2. Por qué este skill supone un entorno de desarrollo — y qué no puede hacer en un chat simple
3. Lo que produce realmente el paquete
4. Preparar un servidor MCP paso a paso
5. Lo que MCP Builder no hace
6. Formarse antes de conectar una herramienta real
7. Preguntas frecuentes

Por qué conectar Claude a una herramienta interna en lugar de copiar y pegar datos

Copiar un dato de un programa interno a una conversación de IA, obtener una respuesta y después trasladarla a mano al mismo programa funciona para un uso ocasional. Se convierte en una pérdida de tiempo repetida en cuanto la misma acción se repite cada semana: comprobar el estado de un expediente, listar proyectos atrasados, actualizar un campo. Un servidor MCP sustituye ese copiar y pegar por una acción definida una sola vez: el asistente puede entonces pedir que se listen los proyectos atrasados y recibir la respuesta directamente, sin que nadie abra el programa de origen entre medio.

Lo que añade un servidor MCP frente a un copiar y pegar manual

Un servidor MCP no da al asistente acceso libre a toda su base de datos: expone acciones precisas, definidas una a una, con sus parámetros y el formato de respuesta esperado. Esa precisión es deliberada: limita lo que el asistente puede hacer a lo explícitamente autorizado, en lugar de abrir un acceso amplio que sería difícil de auditar después.

El papel exacto del skill MCP Builder: escribir, no desplegar

MCP Builder ayuda a redactar ese código —la estructura del servidor, la definición de cada herramienta, la gestión de los errores esperados— a partir de la documentación de la API que quiere conectar. No despliega nada por sí mismo, no crea ninguna cuenta y no prueba la conexión con su herramienta real: esos pasos siguen siendo enteramente responsabilidad de quien desarrolla, en su propio entorno.

Por qué este skill supone un entorno de desarrollo — y qué no puede hacer en un chat simple

Hay que decirlo sin rodeos, como con Find-Skills: MCP Builder se dirige ante todo a una persona cómoda con un entorno de desarrollo, o en proceso de aprendizaje guiado. No es un juicio sobre quién debería usar la IA; es una descripción honesta de lo que este skill concreto hace según dónde se encuentre usted.

La distinción oficial entre servidor y cliente MCP

La documentación oficial del Model Context Protocol distingue con claridad el servidor —el programa que expone las herramientas— del cliente, la aplicación que se conecta a él para usarlas, como Claude Desktop o Claude Code. Escribir un servidor no basta: después hay que desplegarlo en una máquina accesible y declararlo en la configuración del cliente elegido para que la conexión exista realmente.

Lo que no hace importar el archivo del skill en Claude

Añadir el paquete MCP Builder a una conversación de Claude da acceso a sus instrucciones, no a un servidor en funcionamiento. Ese simple gesto no crea ningún acceso a una API externa, y ninguna cuenta de producción debería conectarse antes de que el código haya sido revisado, probado y desplegado en un entorno controlado.

Lo que produce realmente el paquete

Sin mostrar código en este artículo —MCP Builder produce código, pero su funcionamiento puede describirse enteramente con palabras—. El paquete parte de la documentación de la API que quiere conectar y propone una estructura de servidor limitada a unas pocas acciones bien definidas, en lugar de una cobertura amplia y difusa de todas las posibilidades de esa API.

Pocas herramientas de solo lectura al principio

La primera versión de un servidor MCP debería exponer solo acciones de lectura —consultar una lista, comprobar un estado— antes de añadir acciones que modifiquen un dato. Esta restricción deliberada permite probar el comportamiento del servidor en una cuenta real sin riesgo de modificación accidental, antes de ampliar progresivamente su alcance.

Separar lectura y escritura, gestionar los secretos fuera de archivos compartidos

Las credenciales de acceso a la API —clave, token, contraseña— nunca deben aparecer en el código del servidor ni en un archivo compartido con otras personas o subido públicamente a un repositorio. Se gestionan mediante una configuración dedicada, propia de cada entorno de ejecución, lo que evita que un acceso completo a una cuenta de producción termine expuesto en un repositorio de código o en una captura de pantalla.

Preparar un servidor MCP paso a paso

Paso 1: Reunir la documentación de la API antes de escribir nada. Reúna la documentación oficial de la herramienta que quiere conectar —sus puntos de acceso, parámetros, formatos de respuesta y de error— en lugar de dejar que el paquete adivine un comportamiento a partir de ejemplos genéricos que pueden no corresponder a la versión realmente utilizada.

Paso 2: Elegir pocas acciones útiles, no una cobertura total. Liste entre tres y cinco acciones que respondan a una necesidad real y concreta, en lugar de querer exponer toda la API desde la primera versión; un alcance reducido se prueba y corrige con más facilidad que un servidor que intenta abarcarlo todo de golpe.

Paso 3: Escribir y probar el servidor en una cuenta de prueba, nunca directamente en producción. Use una cuenta separada de la real para las primeras pruebas, de modo que un error de configuración o un comportamiento inesperado no afecte a datos o clientes reales durante la puesta a punto.

Paso 4: Comprobar cada caso de error, no solo el resultado esperado. Pruebe qué ocurre cuando se deniega el acceso, cuando se pide una página siguiente o cuando la respuesta llega vacía; un servidor que oculta un fallo de autenticación detrás de una respuesta vacía silenciosa produce resultados engañosos una vez conectado a un uso real.

Paso 5: Desplegar y declarar el servidor en el cliente elegido solo después de esta comprobación. La documentación oficial del protocolo detalla cómo registrar un servidor en la configuración de Claude Code o Claude Desktop; esa declaración sigue siendo el último paso, después de revisar el código y probarlo en la cuenta de prueba.

Lo que MCP Builder no hace

El skill no garantiza ninguna seguridad por defecto: ayuda a estructurar el código, pero la revisión de los permisos concedidos, la gestión de los secretos y la limitación de lo que una herramienta expuesta puede hacer realmente siguen siendo enteramente responsabilidad de quien desarrolla y despliega el servidor. Una herramienta mal diseñada que concede más acceso del necesario sigue siendo un riesgo, sea cual sea la calidad del código generado por el paquete.

Tampoco garantiza la compatibilidad con las versiones actuales de los SDK utilizados: los ejemplos integrados en el skill pueden estar desactualizados, y las bibliotecas correspondientes evolucionan. Contrastar cada ejemplo con la documentación oficial vigente en el momento del desarrollo sigue siendo necesario antes de considerar un servidor listo.

En los intercambios que mantenemos con directivos interesados en conectar Claude a sus herramientas internas, la primera pregunta casi siempre es si esto sustituye a un desarrollador. No: estructura el trabajo de alguien que ya sabe leer y modificar código, o que está aprendiendo a hacerlo con acompañamiento, no el de alguien que nunca ha abierto un entorno de desarrollo.

Formarse antes de conectar una herramienta real

Escribir, probar y desplegar un servidor MCP supone unas bases de desarrollo que se aprenden, incluso para un perfil venido de la arquitectura o la gestión más que del código. La formación Dominar Claude de Educasium dedica módulos a Claude Code y a la construcción de skills y conectores a partir de necesidades de negocio reales, pensados para perfiles que nunca han desarrollado antes. Para un directivo o un independiente del régimen correspondiente, el FIFPL financia parte del coste de una formación certificada Qualiopi según los criterios 2026 fijados en 300 €/día y 900 €/año, con el e-learning limitado al 50 % del criterio diario.

Preguntas frecuentes

¿Puede MCP Builder funcionar en una conversación normal de Claude.ai, sin terminal?

No, no para producir un resultado utilizable: el paquete ayuda a escribir código que después hay que ejecutar, probar y desplegar en un entorno de desarrollo. En una conversación sin esa capacidad puede obtener una descripción en texto de lo que haría ese servidor, pero de ahí no sale ningún archivo funcional, y presentar esa descripción como un servidor listo para usar sería engañoso. Si solo necesita entender la arquitectura prevista antes de que alguien la desarrolle, pedir esa descripción sigue siendo útil, siempre que no se confunda con un servidor realmente desplegado.

¿Hace falta ser desarrollador para usar este skill?

Hace falta, como mínimo, saber ejecutar código en un entorno como Claude Code, entender la estructura de un proyecto y leer documentación técnica de una API. No es necesariamente el nivel de un desarrollador profesional, pero es más que el uso de un simple chat: una formación centrada en esas bases sigue siendo la vía más fiable para un perfil que descubre este uso. Sin esas bases, es mejor que el servidor lo construya alguien que ya las tenga, en lugar de desplegar en producción un código no comprendido.

¿El servidor producido por el paquete se conecta automáticamente a mi cuenta real?

No, nunca automáticamente. El código escrito por el paquete debe revisarse, probarse en una cuenta separada y luego desplegarse y declararse manualmente en la configuración del cliente MCP elegido; ninguno de estos pasos se activa solo, y conectar directamente una cuenta de producción sin pasar por una cuenta de prueba expone a un riesgo evitable. Esta ausencia de automatización es deliberada: deja en manos de quien desarrolla el control final sobre lo que realmente se conecta a una cuenta de producción.

¿Qué diferencia hay entre un servidor MCP y un simple skill de Claude?

Un skill aporta instrucciones textuales que Claude sigue dentro de una conversación, sin acceso directo a un sistema externo. Un servidor MCP, en cambio, expone acciones realmente ejecutables hacia una herramienta real —una base de datos, una API, un programa de gestión—, lo que supone código que se ejecuta de verdad en algún lugar, a diferencia de un skill, que sigue siendo enteramente texto. Esta diferencia explica por qué un servidor MCP necesita un entorno de ejecución mientras que un skill funciona en cualquier conversación.

Conectar Claude a una herramienta interna aporta un ahorro de tiempo real una vez el servidor está en marcha, pero la preparación —documentación, alcance reducido, pruebas en una cuenta separada— condiciona directamente su fiabilidad una vez desplegado. Ese es el papel del paquete de preparación de servidor MCP Builder, que debe usarse en un entorno de desarrollo, junto con la documentación oficial del Model Context Protocol para comprobar cada paso del despliegue.

Antes de construir un servidor a medida, comprobar que un skill existente no cubre ya parte de la necesidad sigue siendo un paso útil: nuestra guía para buscar un skill antes de construir uno detalla cómo hacer esa búsqueda.

Formación 100 % financiable vía OPCO/FIFPL. Programa certificado Qualiopi. Para aprender a preparar un servidor MCP en el marco de nuestra formación Dominar Claude, contacte con Educasium e indique su situación (asalariado, independiente, directivo) y su objetivo.