4 de junio de 2026
MCP para .NET: dale herramientas reales a tu agente de IA (2026)
Qué es el Model Context Protocol, por qué un servidor MCP con Roslyn importa en C#, qué servidores usar y cómo configurar .mcp.json para Claude Code, Cursor y Copilot.
El Model Context Protocol (MCP) es un estándar abierto que permite a los agentes de IA usar herramientas reales (tu sistema de archivos, Git, una base de datos, un language server) en lugar de adivinar a partir del texto. Para los desarrolladores .NET el beneficio es concreto: un servidor MCP que entiende tu solución de C# a través de Roslyn le da al agente la visión del compilador sobre tu código, así puede renombrar con seguridad y encontrar las llamadas reales en vez de hacer una búsqueda de texto. Esta guía explica qué es MCP, qué servidores importan en un proyecto .NET y cómo conectarlos.
¿Qué es MCP?
MCP es un protocolo abierto, introducido por Anthropic y hoy ampliamente adoptado, que estandariza cómo un agente de IA se conecta a herramientas y datos externos. En vez de que cada herramienta invente su propia integración, expone un “servidor” MCP, y cualquier cliente compatible (Claude Code, Cursor, Copilot y otros) puede usarlo. Piénsalo como un puerto USB-C para agentes: un estándar, muchas herramientas.
Un servidor puede exponer tres cosas: herramientas (acciones que el agente puede invocar, como ejecutar una consulta), recursos (datos que puede leer, como un archivo o un esquema) y prompts (plantillas reutilizables). Para el trabajo diario en .NET, lo que importa son las herramientas y los recursos.
¿Por qué importa MCP en .NET en concreto?
Sin MCP, el agente razona sobre tu código como texto. Hace grep. Eso funciona para cambios pequeños y se rompe en una solución grande de C# donde el mismo nombre de método aparece en diez sitios y solo los tipos te dicen cuál es.
Con un servidor MCP que conoce Roslyn, el agente obtiene el modelo semántico de tu solución: símbolos, referencias, tipos, el grafo de llamadas real. Esa es la diferencia entre “encuentra la cadena Save” y “encuentra cada llamante de OrderService.Save”. En una base de código grande y fuertemente tipada, esa comprensión semántica es justo la ventaja de .NET que un agente debería estar usando.
¿Qué servidores MCP debería usar un proyecto .NET?
Una base práctica:
- Sistema de archivos - lectura y escritura acotadas al repo. Las manos del agente.
- Git - historial, diffs, blame, cambios en stage, para que el agente razone sobre qué cambió y por qué.
- Un servidor de C# con Roslyn - el modelo semántico de la solución (símbolos, referencias, tipos). La ventaja específica de .NET.
- Postgres (o tu base de datos) - leer el esquema antes de escribir una consulta en lugar de adivinar nombres de columnas.
No necesitas más para empezar. Añade servidores cuando tengas una necesidad concreta, no por si acaso.
¿Cómo configurar MCP para Claude Code?
Claude Code lee un .mcp.json en la raíz del repo de forma automática. Una configuración mínima que funciona sin tocar nada:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "."]
}
}
}
Para la capa semántica de C#, añade un servidor con Roslyn apuntando a tu .sln o .slnx. Una buena opción de la comunidad es SharpTools (kooshi/SharpToolsMCP), un servidor MCP basado en Roslyn para analizar y editar soluciones de C#. Sigue su README para añadirlo al .mcp.json.
Para Cursor y Copilot, apunta su configuración MCP a los mismos servidores. El protocolo es el mismo; solo cambia dónde va la configuración del cliente.
Un ejemplo funcionando
Nuestro starter gratuito trae un .mcp.json y notas sobre cómo añadir el servidor de Roslyn, conectado a una solución real (aunque mínima) de .NET 10: github.com/Khavel/dotnet-claude-starter. Clónalo para ver la configuración en contexto y copia la forma a tu propio repo.
Preguntas frecuentes
¿Necesito MCP para usar Claude Code con .NET? No. Claude Code funciona sin él. MCP hace al agente bastante mejor en soluciones grandes, sobre todo el servidor con Roslyn. Empieza con filesystem y git, y añade el servidor de C# cuando notes que el agente adivina.
¿MCP es específico de Claude Code? No. MCP es un estándar abierto. Los mismos servidores funcionan con Cursor, Copilot y otros clientes compatibles.
¿El servidor de Postgres necesita credenciales de producción? Usa una conexión de solo lectura a una base de datos de desarrollo o staging. El agente lee el esquema; no debería necesitar acceso de escritura ni datos de producción para ayudarte a escribir una consulta.
¿En qué se diferencia de simplemente abrir archivos en el editor? Abrir archivos le da al agente texto. Un servidor MCP le da herramientas y, con Roslyn, la comprensión del compilador sobre la solución en lugar de una búsqueda de texto.
¿Construyendo un SaaS de producción en .NET, agent-first?
Esto es la configuración; Sharpyard es el kit de producción construido sobre ella. Un starter de SaaS en .NET 10 y Angular con autenticación, multitenancy, pagos y la capa de operación para agentes (CLAUDE.md, la configuración MCP, tests de contrato) integrada de principio a fin. Únete a la lista de espera para el precio fundador.
Relacionado: Claude Code para desarrolladores .NET.
El kit completo de SaaS en .NET, nativo para agentes.
Únete a la lista de espera