Crea agentes más seguros con la documentación Flowtly MCP

Cómo mantenerte al día

1. Ejecuta el comando de sincronización después de cada actualización de MCP.
2. Reinicia tu stack de agentes para aplicar los cambios de capacidades.
3. Guarda esta página para consultar las últimas indicaciones de MCP.

Qué incluye

• Reglas de autenticación y claves API para endpoints MCP.
• Esquemas de recursos para base de conocimiento, blog, notas de versión, inversores y actualizaciones de producto.
• Payloads JSON-RPC y consejos de lectura/escritura para agentes.

Transport & Auth

• Endpoints: POST /mcp (entrada JSON-RPC), GET /health (liveness), POST /api/chat (proxy de consola; requiere Authorization: Bearer <token>)
• Headers: Authorization Bearer token (preferido; si no, FLOWTLY_API_KEY), el header instance es opcional y se reenvía
• Content-Type: application/json
• Body: JSON-RPC 2.0 { "jsonrpc": "2.0", "id": "...", "method": "...", "params": {...} }

initialize

• Negocia capacidades y namespaces.
• Ejemplo de params: { "protocolVersion": "2024-11-05" }
• Devuelve capacidades (list, read, write) y namespaces (work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests).

resources/list

• Método: resources/{namespace}/list (namespace por defecto: work-times si se omite)
• Namespaces: work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests.
• Devuelve URIs por namespace (ver detalle abajo).

resources/read

• Método: resources/{namespace}/read (namespace por defecto: work-times).
• Parámetros incluyen uri, p. ej. /api/work-times
• allowPrefixes habilita coincidencias entre namespaces; {current} se resuelve a /api/employees/me.
• Algunos recursos añaden valores por defecto (work-times añade límites de fecha; employees añade itemsPerPage; holidays/vacations añaden paginación por defecto).
• Responsibilities sigue hasta 10 enlaces @id para enriquecer título/nombre.
• El namespace logical devuelve resúmenes del servidor en lugar de payloads brutos.
• Devuelve el payload contents de la API Flowtly subyacente.

resources/write

• Solo recursos con allowWrite aceptan escrituras; POST salvo que la URI termine en id (entonces PATCH con application/merge-patch+json).
• /api/.../create fuerza POST aunque exista id; se puede forzar el tipo con params.contentType.
• Helper de escritura lógica: resources/logical/write soporta /logical/recruiting/resource-requests/update?id=<id> y /logical/recruiting/resource-request-candidates/update?id=<id> (PATCH).

Namespace logical (/logical/*)

• Resúmenes de solo lectura: work-times, employees, projects, employee-work-times, project-rates, transactions, project-profitability.
• Resúmenes de recruiting: company-onboarding/status, recruiting/open-roles, recruiting/candidates.
• Resúmenes de holidays: logical/holidays.
• Ejemplo: /logical/work-times/summary admite date[after]/date[before] (por defecto últimos 7 días).

Forma de error

• { "jsonrpc": "2.0", "id": "...", "error": { "code": -32000, "message": "Upstream Flowtly API failed", "data": { "status": 502 } } }

Notas

• allowPrefixes permite que resources/read acepte URIs que empiecen con prefijos permitidos.
• Referencia tipo OpenAPI disponible en public/mcp/openapi.json.

resources/list por namespace