Servidor MCP: Habla con tu Arquitectura desde tus Herramientas IA Favoritas

Llevo más de un año usando asistentes de codificación IA a diario. Claude Code para refactorizaciones complejas, Cursor para ediciones rápidas, GitHub Copilot para autocompletado. Pero siempre había una brecha frustrante: estas herramientas no podían ver mi documentación de arquitectura.

Cada vez que le pedía a Claude que "agregara un nuevo endpoint al servicio de pagos", adivinaba. No sabía que nuestro servicio de pagos se comunica con Stripe, usa Redis para caché, y tiene requisitos de seguridad específicos documentados en nuestros ADRs. Pasaba más tiempo corrigiendo a la IA que escribiendo código yo mismo.

Hoy, estamos cerrando esa brecha. Archyl ahora expone un servidor MCP (Model Context Protocol) completo con 56 herramientas que dan a los asistentes IA visibilidad total sobre tu arquitectura.

¿Qué es MCP?

El Model Context Protocol es el estándar abierto de Anthropic para conectar asistentes IA con herramientas y fuentes de datos externas. Piénsalo como un adaptador universal entre los LLMs y los sistemas con los que necesitan interactuar.

En lugar de copiar y pegar contexto en los prompts, MCP permite que los asistentes IA consulten directamente tus herramientas. Pueden leer datos, tomar acciones y mantenerse sincronizados con tus sistemas reales.

Y el servidor MCP de Archyl significa que tu documentación de arquitectura se convierte en una fuente de datos de primera clase para cualquier asistente IA.

¿Qué Puedes Hacer Con Él?

Aquí es donde se pone emocionante. Con el servidor MCP de Archyl, tu asistente IA puede:

Consultar Tu Arquitectura

Haz preguntas naturales y obtén respuestas reales:

• "¿Qué elementos están vinculados al sistema Payment Processor?"
• "¿De qué contenedores depende el User Service?"
• "Muéstrame todos los sistemas que interactúan con nuestra base de datos PostgreSQL"
• "¿Qué ADRs afectan el flujo de autenticación?"

La IA no adivina. Consulta tu arquitectura realmente documentada y devuelve información precisa y estructurada.

Navegar el Modelo C4

Tu IA entiende la jerarquía completa:

• Listar todos los proyectos en tu organización
• Profundizar desde sistemas a contenedores a componentes
• Explorar relaciones y dependencias
• Entender el stack tecnológico en cada nivel

Cuando preguntas "¿qué tecnologías usa el Order Service?", la IA devuelve el stack realmente documentado, no una suposición alucinada.

Modificar Documentación

Esta es la funcionalidad estrella. El servidor MCP soporta operaciones de escritura:

• Crear nuevos sistemas, contenedores y componentes
• Agregar relaciones entre elementos
• Crear y actualizar ADRs
• Escribir documentación de proyecto
• Definir flujos de usuario

Pídele a Claude que "documente el nuevo servicio de notificaciones que acabamos de construir" y puede crear los elementos C4, vincularlos a sistemas existentes, e incluso redactar un ADR explicando la decisión de diseño.

Mantenerse Sincronizado

La IA siempre ve el estado más reciente. Sin contexto obsoleto, sin documentación desactualizada. Cuando tu compañero actualiza la arquitectura, tu asistente IA lo ve inmediatamente.

56 Herramientas, Una Integración

No construimos una prueba de concepto mínima. El servidor MCP expone funcionalidad completa:

Proyectos y Configuración: Listar, obtener y gestionar proyectos. Configurar proveedores IA y ajustes de descubrimiento.

Modelo C4 (Los 4 Niveles): CRUD completo para sistemas, contenedores, componentes y elementos de código. Crear relaciones, gestionar overlays, manejar la jerarquía completa del modelo.

Documentación: Crear y actualizar documentación de arquitectura. Vincular docs a elementos C4 específicos.

ADRs: Gestión completa de Architecture Decision Records. Crear, actualizar, listar y vincular ADRs a los elementos que afectan.

Flujos de Usuario: Definir y visualizar recorridos de usuario a través de tu sistema.

Descubrimiento: Disparar descubrimiento de arquitectura impulsado por IA en tus repositorios conectados.

Equipos: Consultar estructura de equipos y acceso a proyectos.

Cada herramienta devuelve datos estructurados sobre los que los asistentes IA pueden razonar. Sin parsear HTML, sin scrapear UIs, sin integraciones frágiles.

Comenzar en 2 Minutos

Así es como conectas Claude Code (o cualquier herramienta compatible con MCP):

Paso 1: Crear una Clave API

Ve a tu perfil de Archyl, haz clic en "Claves API", y crea una nueva clave. Dale un nombre descriptivo como "Claude Code" y selecciona los scopes que necesitas (solo lectura o acceso completo).

Copia la clave inmediatamente — no la verás de nuevo.

Paso 2: Configurar tu Cliente MCP

Agrega Archyl a tu configuración MCP. Para Claude Code, agrega esto a tu configuración:

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "tu_clave_api_aqui"
      }
    }
  }
}

Paso 3: Comienza a Hablar con tu Arquitectura

Eso es todo. Pregúntale a tu asistente IA sobre tu arquitectura y míralo obtener datos reales desde Archyl.

Prueba estos prompts:

• "Lista todos mis proyectos de Archyl"
• "¿Qué sistemas existen en el proyecto E-commerce Platform?"
• "Muéstrame las relaciones del Payment Gateway"
• "Crea un nuevo ADR explicando por qué elegimos PostgreSQL"

Por Qué Esto Importa

La documentación de arquitectura siempre ha tenido un problema de descubribilidad. La escribes, vive en un wiki o en un diagrama en algún lugar, y luego nadie la lee. Los ingenieros hacen preguntas en Slack en lugar de consultar la documentación.

MCP cambia el modelo de interacción. La documentación no es algo que vas a leer — es algo que tu asistente IA conoce. Cuando preguntas "¿cómo funciona el procesamiento de pagos?", la respuesta viene de tu arquitectura real, no de los datos de entrenamiento de la IA.

Esto tiene implicaciones profundas:

El onboarding se vuelve instantáneo. Los nuevos ingenieros preguntan a su IA sobre la arquitectura del sistema y obtienen respuestas precisas desde el primer día.

El contexto siempre está disponible. Al escribir código, la IA sabe exactamente qué servicios existen, cómo se conectan, y qué decisiones los moldearon.

La documentación se mantiene actualizada. Porque se usa activamente, las inexactitudes se notan y se corrigen. La documentación muerta es documentación que nadie lee.

Las sugerencias de IA están fundamentadas. Cuando Claude sugiere un diseño, está informado por tu arquitectura real, no por patrones genéricos.

El Panorama General

Estamos entrando en una era donde los asistentes IA son verdaderos colaboradores en el desarrollo de software. Pero solo son tan buenos como el contexto al que tienen acceso.

La mayoría de las interacciones con IA hoy son pobres en contexto. Pegas algo de código, agregas una breve descripción, y esperas que la IA descifre el resto. Los resultados son mediocres porque la IA trabaja a ciegas.

Las integraciones MCP invierten este modelo. Tu IA tiene acceso persistente y consultable a todo lo que necesita: tu código (vía integración de repositorio), tu arquitectura (vía Archyl), tus issues (vía integraciones de Jira/Linear), tu documentación (vía integraciones de Notion/Confluence).

La IA se convierte en un verdadero miembro del equipo con acceso al conocimiento del equipo.

El servidor MCP de Archyl es nuestra contribución a esta visión. Tu arquitectura no debería estar encerrada en una herramienta de diagramas. Debería ser accesible para todas las herramientas que tu equipo usa, incluyendo tus asistentes IA.

¿Qué Sigue?

Esta es la versión 1. Esto es lo que estamos construyendo a continuación:

Sugerencias proactivas: El servidor MCP podría monitorear cambios de arquitectura y sugerir actualizaciones de documentación.

Enlaces cruzados: Conectar ADRs a commits específicos, vincular documentación a eventos de CI/CD, crear una red de conocimiento interconectado.

Consultas personalizadas: Definir consultas específicas de la organización como "muéstrame todos los servicios propiedad del equipo de pagos."

Registro de auditoría: Rastrear cada interacción MCP para cumplimiento y depuración.

Pruébalo Ahora

El servidor MCP está disponible hoy en todos los planes de Archyl. Si ya estás usando Claude Code, Cursor u otra herramienta compatible con MCP, puedes conectarte en minutos.

Crea una clave API, agrega la configuración, y comienza a hablar con tu arquitectura.

Y si aún no usas Archyl, regístrate gratis y descubre cómo funciona la documentación de arquitectura impulsada por IA. Conecta un repositorio, ejecuta el descubrimiento, y luego conecta tu asistente IA favorito.

Tu arquitectura es demasiado importante para estar encerrada en diagramas estáticos. Deja que tus asistentes IA la exploren.

¿Quieres aprender más sobre las capacidades de IA de Archyl? Consulta nuestro post sobre Descubrimiento de Arquitectura Impulsado por IA, o comienza con lo básico en nuestra Introducción al Modelo C4.