Déployez des agents plus sûrs avec la documentation Flowtly MCP

Rester à jour

1. Exécutez la commande de synchro après chaque mise à jour MCP.
2. Redémarrez votre stack d’agents pour appliquer les nouvelles capacités.
3. Ajoutez cette page en favori pour les dernières informations MCP.

Contenu

• Règles d’authentification et clés API pour les endpoints MCP.
• Schémas des ressources pour la base de connaissances, le blog, les release notes, les investisseurs et les mises à jour produit.
• Payloads JSON-RPC et conseils de lecture/écriture pour les agents.

Transport et authentification

• Endpoints : POST /mcp (entrée JSON-RPC), GET /health (liveness), POST /api/chat (proxy console ; nécessite Authorization: Bearer <token>)
• Headers : Authorization Bearer token (préféré ; bascule sur FLOWTLY_API_KEY), l’en-tête instance est optionnel et transmis
• Content-Type : application/json
• Body : JSON-RPC 2.0 { "jsonrpc": "2.0", "id": "...", "method": "...", "params": {...} }

initialize

• Négocie les capacités et namespaces.
• Exemple de params : { "protocolVersion": "2024-11-05" }
• Retourne les capacités (list, read, write) et les namespaces (work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests).

resources/list

• Méthode : resources/{namespace}/list (namespace par défaut : work-times si omis)
• Les namespaces incluent work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests.
• Renvoie les URIs par namespace (voir le détail ci-dessous).

resources/read

• Méthode : resources/{namespace}/read (namespace par défaut : work-times).
• Params incluent uri, ex. /api/work-times
• allowPrefixes autorise les correspondances cross-namespace ; {current} pointe vers /api/employees/me.
• Certaines ressources ajoutent des valeurs par défaut (work-times ajoute des bornes de dates ; employees ajoute itemsPerPage ; holidays/vacations ajoutent des valeurs de pagination).
• Responsibilities suit jusqu’à 10 liens @id pour enrichir titre/nom.
• Le namespace logical renvoie des synthèses serveur plutôt que des payloads bruts.
• Renvoie le payload contents de l’API Flowtly sous-jacente.

resources/write

• Seules les ressources avec allowWrite acceptent l’écriture ; POST sauf si l’URI se termine par un id (dans ce cas PATCH avec application/merge-patch+json).
• /api/.../create force un POST même si un id est présent ; vous pouvez forcer le type via params.contentType.
• Assistant d’écriture logical : resources/logical/write gère /logical/recruiting/resource-requests/update?id=<id> et /logical/recruiting/resource-request-candidates/update?id=<id> (PATCH).

Namespace logical (/logical/*)

• Synthèses en lecture seule : work-times, employees, projects, employee-work-times, project-rates, transactions, project-profitability.
• Synthèses recrutement : company-onboarding/status, recruiting/open-roles, recruiting/candidates.
• Synthèses congés : logical/holidays.
• Exemple : /logical/work-times/summary supporte date[after]/date[before] (7 derniers jours par défaut).

Forme des erreurs

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

Notes

• allowPrefixes permet à resources/read d’accepter les URIs qui commencent par les préfixes autorisés.
• Référence type OpenAPI disponible dans public/mcp/openapi.json.

resources/list par namespace