External AI Ecosystem Gateway

Una puerta de enlace de Python orientada a la seguridad que expone herramientas con permisos limitados a clientes asistentes compatibles con MCP, a la vez que media el acceso a sistemas externos como Slack. Demuestra aislamiento de inquilinos, autorización delegada, confirmación humana para escrituras sensibles, ejecución idempotente, verificación de webhooks firmados, almacenamiento de concesiones listo para la revocación y un registro de auditoría encadenado por hash.

Esta es una implementación de portafolio/referencia, no un proveedor de identidad de producción. El adaptador de autenticación de desarrollo basado en cabeceras debe reemplazarse por el middleware de validación OIDC descrito en docs/security.md antes del despliegue.

Arquitectura

Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

Related MCP server: Nervora

Inicio rápido

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

Listar herramientas:

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

Ejecute la suite de pruebas con pytest. Cuando no se ha configurado ningún token de Slack, los conectores se ejecutan en un modo de espacio aislado seguro y devuelven la solicitud que emitirían.

Propiedades de seguridad

• Cada principal y clave de idempotencia tiene un espacio de nombres de inquilino.

• Las políticas de herramientas combinan roles de mínimo privilegio con ámbitos delegados.

• Las escrituras sensibles requieren un token de corta duración vinculado al sujeto, al inquilino, a la herramienta y a los argumentos.

• Las firmas de webhook utilizan comparación en tiempo constante y rechazan solicitudes obsoletas.

• Los registros de auditoría forman una cadena SHA-256, de modo que la eliminación o modificación es detectable.

• Las concesiones OAuth admiten revocación y nunca exponen tokens de actualización a través de los resultados de las herramientas.

Consulte docs/security.md para obtener la lista de verificación de endurecimiento de producción y el modelo de amenazas.

Licencia

MIT