Vald Forcedecks MCP Connector

ForceDecks MCP Connector

Repositorio de documentación y especificaciones para que cualquier desarrollador implemente un servidor MCP (Model Context Protocol) capaz de conectarse a la External ForceDecks API de VALD y exponer tests, trials (reps) y recordings a clientes MCP.

Proyecto independiente (sin Odoo/n8n). Incluye *Speckit* (spec/speckit.yaml), guías de autenticación OAuth2 (client credentials) y ejemplos de consumo.

Características

• MCP tools: listar tests con modifiedFromUtc, leer trials de un testId, descargar recordings (opcional, con permiso), y sincronizar result definitions.
• Docs completas: región/base URL, autenticación, paginación "modifiedFromUtc", ejemplos cURL/Python y buenas prácticas.
• CI: workflows para lint de Markdown/YAML y validación de la spec.
• Plantillas: Issues/PRs, CODEOWNERS, SECURITY, CONTRIBUTING.

Estructura

forcedecks-mcp-connector/
├── .devcontainer/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   └── workflows/
├── assets/
├── docs/
├── examples/
├── spec/
├── .editorconfig
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── RELEASE.md
├── SECURITY.md
└── versions.md

Inicio rápido

1. Lee docs/overview.md y docs/mcp_architecture.md.
2. Revisa docs/authentication.md y configura Client ID/Secret y tenant/region.
3. Implementa tu servidor MCP siguiendo spec/speckit.yaml.
4. Prueba con examples/requests.http.

© 2025-10-04 ForceDecks MCP Connector. MIT License.