Saltar al contenido principal

🔌 Integración MCP: GitHub Copilot & Claude Desktop

¿Qué es la integración MCP?​

MCP (Model Context Protocol) es un protocolo abierto que permite a los asistentes de IA como GitHub Copilot o Claude Desktop conectarse a fuentes de conocimiento externas.

Con la integración MCP, puedes:

  • ✅ Usar Alex directamente en VS Code (a través de GitHub Copilot)
  • ✅ Usar Alex directamente en Claude Desktop
  • ✅ Acceder al conocimiento de Business Central AL sin salir de tu editor
  • ✅ Comparar versiones de Business Central (BC 26 vs 27, etc.)
¿Por qué usar MCP?

En lugar de cambiar entre VS Code y la interfaz web de Alex, haces tus preguntas directamente en tu editor de código o en Claude Desktop. Alex responde instantáneamente con información precisa sobre Business Central AL.

Asistentes compatibles​

GitHub Copilot (VS Code)​

GitHub Copilot es el asistente de IA integrado en Visual Studio Code. Con la integración MCP:

  • Abre Copilot Chat en VS Code
  • Usa las herramientas de Alex: #mcp_alex_alex_al_query o #mcp_alex_alex_al_comparison
  • Haz tus preguntas sobre Business Central AL
  • Alex responde directamente en el chat

Ejemplo:

Use #mcp_alex_alex_al_query to ask: How do I create a table extension in AL?

Claude Desktop​

Claude Desktop es la aplicación de escritorio de Claude AI. Con la integración MCP:

  • Abre Claude Desktop
  • Autoriza las herramientas de Alex (ver sección "Uso" abajo)
  • Haz tus preguntas normalmente en la conversación
  • Claude usa automáticamente Alex para responder preguntas de Business Central

Ejemplo:

Explain the differences in table Customer between BC versions 26 and 27

Instalación​

Requisitos previos​

  • Node.js 18 o superior instalado en tu ordenador
  • Una cuenta Alex activa con créditos disponibles
  • GitHub Copilot (VS Code) o Claude Desktop instalado

Instalación automática (recomendada)​

Windows (PowerShell)​

  1. Clona el repositorio (https://github.com/pmoisontech/Alex-MCP-Proxy) o descarga el código:

    git clone https://github.com/pmoisontech/Alex-MCP-Proxy.git
    cd Alex-MCP-Proxy/mcp-server-proxy

  2. Ejecuta el instalador:

    .\install-mcp.ps1

  3. Sigue las instrucciones:

    • Introduce la URL del backend Alex (predeterminado: https://alex.app.pmats.ai/api)
    • Introduce tu nombre de usuario de Alex
    • Introduce tu contraseña de Alex
    • Elige VS Code y/o Claude Desktop

  4. Reinicia tu asistente:

    • VS Code: Cierra y reinicia VS Code completamente
    • Claude Desktop: Cierra todas las ventanas y reinicia Claude

Linux / macOS / WSL​

  1. Clona el repositorio (https://github.com/pmoisontech/Alex-MCP-Proxy) o descarga el código:

    git clone https://github.com/pmoisontech/Alex-MCP-Proxy.git
    cd Alex-MCP-Proxy/mcp-server-proxy

  2. Ejecuta el instalador:

    ./install-mcp.sh

  3. Sigue las instrucciones:

    • Introduce la URL del backend Alex (predeterminado: https://alex.app.pmats.ai/api)
    • Introduce tu nombre de usuario de Alex
    • Introduce tu contraseña de Alex
    • Elige VS Code y/o Claude Desktop

  4. Reinicia tu asistente:

    • VS Code: Cierra y reinicia VS Code completamente
    • Claude Desktop: Cierra todas las ventanas y reinicia Claude
Generación de clave API

El instalador creará automáticamente una clave API para tu cuenta de Alex. Esta clave es válida durante 3 meses por defecto y permite al proxy MCP autenticarse con Alex.

Instalación manual​

Si prefieres configurar manualmente, consulta el README del proxy MCP para instrucciones detalladas.

Uso​

Con GitHub Copilot (VS Code)​

  1. Abre VS Code e inicia un proyecto AL
  2. Abre Copilot Chat (icono de chat en la barra lateral)
  3. Usa las herramientas de Alex:

Para preguntas generales sobre AL:

Use #mcp_alex_alex_al_query to ask: How does the Customer table work in Business Central?

Para comparar versiones:

Use #mcp_alex_alex_al_comparison to ask: What changed in table Sales Header between BC 26 and BC 27?
Atajo

Escribe #mcp para ver todas las herramientas MCP disponibles. Selecciona #mcp_alex_alex_al_query o #mcp_alex_alex_al_comparison de la lista.

Con Claude Desktop​

  1. Abre Claude Desktop
  2. Abre Settings → All connectors
  3. Encuentra "alex" con 2 herramientas (alex_al_query, alex_al_comparison)
  4. Autoriza las herramientas:
    • Haz clic en el menú desplegable "Blocked"
    • Selecciona "Always allow"
    • Ambas herramientas deberían mostrar ✅ (autorizado)
  5. Haz tus preguntas normalmente en la conversación

Claude detectará automáticamente cuándo usar Alex para responder preguntas de Business Central.

Ejemplos de preguntas:

  • "How do I create a table extension in AL?"
  • "Show me an example of a codeunit that posts a sales order"
  • "What's new in the Sales Order page in BC 27?"
  • "Compare the Item table between versions 26 and 27"

Herramientas disponibles​

alex_al_query​

✅ Herramienta predeterminada para todas las preguntas sobre Business Central AL (excepto comparaciones de versiones).

Usos:

  • Información sobre sintaxis AL, objetos, patrones
  • Solución de problemas de código AL
  • Mejores prácticas de Business Central
  • Ejemplos de código para funcionalidades específicas
  • Estructura de tablas, páginas, codeunits

Ejemplos:

  • "How do I create a table extension in AL?"
  • "What's the syntax for posting a sales order in AL?"
  • "Show me examples of using RecordRef in Business Central"
  • "How to implement OnValidate trigger in AL?"

alex_al_comparison​

⚠️ Usar SOLO para comparar versiones de Business Central (BC 26 vs 27, etc.).

Usos:

  • Comparar código AL entre dos versiones BC
  • Identificar cambios importantes (breaking changes)
  • Descubrir nuevas funcionalidades en una versión
  • Rastrear objetos AL obsoletos o deprecados
  • Analizar cambios de API entre versiones

Ejemplos:

  • "What changed in the Sales Header table between BC 26 and BC 27?"
  • "Compare the Item table between version 25 and 26"
  • "Show me breaking changes in Codeunit 80 from BC 24 to BC 25"
  • "What's new in the Sales Invoice page between version 26 and 27?"

Versiones soportadas: BC 14 a 28 y posteriores. Formato:

  • Versión principal: "BC 26" (usa la última versión menor disponible)
  • Versión completa: "BC 26.5" o "BC 26.5.0.0"

Actualizar el proxy​

Si el proxy MCP ha sido actualizado (nuevas funcionalidades, correcciones de errores):

  1. Actualiza el código:

    cd Alex-MCP-Proxy/mcp-server-proxy
    git pull origin main
    npm install

  2. Reinicia tu asistente:

    • VS Code: Cierra y reinicia completamente
    • Claude Desktop: Cierra todas las ventanas y reinicia
Cambios importantes

Para actualizaciones importantes con cambios de configuración, ejecuta el instalador de nuevo (./install-mcp.sh o .\install-mcp.ps1). Tu configuración existente (clave API, etc.) será preservada.

Solución de problemas​

Alex no aparece en GitHub Copilot​

Soluciones:

  1. Verifica que el archivo mcp.json esté en la ubicación correcta:
    • Windows: %APPDATA%\Code\User\mcp.json
    • Linux/macOS: ~/.config/Code/User/mcp.json
  2. Verifica que la ruta a mcp-proxy-client.js sea absoluta (no relativa)
  3. Reinicia VS Code completamente
  4. Verifica que tu clave API sea correcta en el archivo

Alex no aparece en Claude Desktop​

Soluciones:

  1. Verifica el archivo de configuración:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux/macOS: ~/.config/Claude/claude_desktop_config.json
  2. Cierra todas las ventanas de Claude Desktop y reinicia
  3. Verifica el icono connectors en la parte inferior derecha de Claude
  4. Consulta los logs: %APPDATA%\Claude\logs\ (Windows)

Herramientas bloqueadas en Claude Desktop​

Las herramientas de Alex aparecen pero están marcadas como "Blocked" (🚫):

Solución:

  1. Abre Settings → All connectors
  2. Encuentra "alex" en la lista
  3. Haz clic en el menú desplegable "Blocked"
  4. Selecciona "Always allow"
  5. Las herramientas deberían mostrar ahora ✅

Error "401 Unauthorized"​

Tu clave API no es válida o ha expirado.

Solución:

  1. Inicia sesión en la interfaz web de Alex
  2. Ve a Configuración → Claves API
  3. Crea una nueva clave API
  4. Reemplaza la clave en tu archivo de configuración (variable ALEX_API_KEY)

Alex no responde​

Soluciones:

  1. Verifica tu conexión a Internet
  2. Verifica que la URL del backend sea https://alex.app.pmats.ai/api
  3. Verifica que tengas créditos disponibles en tu cuenta de Alex
  4. Espera unos segundos (la primera respuesta puede tardar un momento)

Seguridad y privacidad​

  • Tu clave API es personal y confidencial - nunca la compartas
  • La conexión al backend de Alex usa HTTPS (cifrado)
  • Tus preguntas y código no se almacenan permanentemente
  • Cada usuario tiene una cuenta aislada
Compartir clave API

NUNCA compartas tu clave API. Si crees que ha sido comprometida, revócala inmediatamente en tu configuración y crea una nueva.

Soporte​

Si encuentras un problema no cubierto en esta documentación:

  1. Verifica que Node.js esté instalado (node --version debería mostrar ≥18)
  2. Verifica que tus archivos de configuración sean JSON válido
  3. Prueba el instalador automático si configuraste manualmente
  4. Consulta GitHub issues
  5. Contacta con soporte con una descripción precisa del error

Más información​