bc-mcp-proxy-daemon

Proxy MCP (Model Context Protocol) para Microsoft Dynamics 365 Business Central con autenticación OAuth2 Client Credentials (service principal / daemon).

Actúa como puente entre clientes MCP stdio (como Claude Code) y el endpoint MCP de Business Central, gestionando automáticamente la obtención y renovación de tokens OAuth2 mediante MSAL.

Requisitos

• Python >= 3.11
• Un App Registration en Azure AD con permisos para Business Central
• Credenciales: tenant_id, client_id, client_secret

Instalación

pip install bc-mcp-proxy-daemon

Desde el código fuente:

git clone git@github.com:BlackCoronel/bc-mcp-proxy-daemon.git
cd bc-mcp-proxy-daemon
pip install -e .

Configuración

Todos los parámetros se pueden configurar por argumentos CLI o variables de entorno. Los argumentos CLI tienen prioridad sobre las variables de entorno.

Parámetros obligatorios

Parámetros opcionales

Uso

Ejecución directa

python -m bc_mcp_proxy \
  --TenantId "tu-tenant-id" \
  --ClientId "tu-client-id" \
  --ClientSecret "tu-client-secret" \
  --Company "CRONUS España S.A." \
  --Environment Production

Con variables de entorno

export BC_TENANT_ID="tu-tenant-id"
export BC_CLIENT_ID="tu-client-id"
export BC_CLIENT_SECRET="tu-client-secret"
export BC_COMPANY="CRONUS España S.A."
export BC_ENVIRONMENT="Production"

python -m bc_mcp_proxy

Integración con Claude Code

Añade el proxy como servidor MCP en tu configuración de Claude Code (.claude/settings.json o similar):

{
  "mcpServers": {
    "bc": {
      "command": "python",
      "args": [
        "-m", "bc_mcp_proxy",
        "--TenantId", "tu-tenant-id",
        "--ClientId", "tu-client-id",
        "--ClientSecret", "tu-client-secret",
        "--Company", "CRONUS España S.A.",
        "--Environment", "Production"
      ]
    }
  }
}

Arquitectura

Claude Code (stdio) ←→ bc-mcp-proxy (stdio server) ←→ Business Central (Streamable HTTP)
                              │
                          MSAL OAuth2
                     (client credentials)

• proxy.py — Servidor MCP stdio que reenvía list_tools y call_tool al endpoint remoto de BC
• auth.py — Proveedores de tokens: MsalClientCredentialsTokenProvider (OAuth2) o StaticTokenProvider (bearer fijo)
• config.py — Dataclass con toda la configuración del proxy
• __main__.py — CLI parser y entry point

Dependencias

• mcp >= 1.0 — SDK del Model Context Protocol
• msal >= 1.28.0 — Microsoft Authentication Library
• httpx >= 0.27 — Cliente HTTP async

Licencia

MIT