Leverera säkrare agenter med Flowtly MCP‑dokumentation

Så håller du dig aktuell

1. Kör sync‑kommandot ovan efter varje MCP‑uppdatering.
2. Starta om agentstacken för att plocka upp capability‑ändringar.
3. Bokmärk sidan för senaste Flowtly MCP‑guiden.

Innehåll

• Auth‑ och API‑nyckelregler för MCP‑endpoints.
• Resursscheman för knowledge base, blogg, releaser, investerare och produktuppdateringar.
• JSON‑RPC‑payloads och tips för skriv/läs för agenter.

Transport & Auth

• Endpoints: POST /mcp (JSON-RPC-ingång), GET /health (liveness), POST /api/chat (konsolproxy; kräver Authorization: Bearer <token>)
• Headers: Authorization Bearer token (föredras; fallback FLOWTLY_API_KEY), instance-header är valfri och vidarebefordras
• Content-Type: application/json
• Body: JSON-RPC 2.0 { "jsonrpc": "2.0", "id": "...", "method": "...", "params": {...} }

initialize

• Förhandlar capabilities och namespaces.
• Exempelparametrar: { "protocolVersion": "2024-11-05" }
• Returnerar capabilities (list, read, write) och namespaces (work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests).

resources/list

• Metod: resources/{namespace}/list (standard-namespace: work-times om utelämnad)
• Namespaces: work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests.
• Returnerar URIs per namespace (se uppdelning nedan).

resources/read

• Metod: resources/{namespace}/read (standard-namespace: work-times).
• Parametrar inkluderar uri, t.ex. /api/work-times
• allowPrefixes möjliggör cross-namespace-träffar; {current} blir /api/employees/me.
• Vissa resurser lägger till standardvärden (work-times lägger till datumgränser; employees lägger till itemsPerPage; holidays/vacations lägger till paginering).
• Responsibilities följer upp till 10 @id-länkar för att berika titel/namn.
• Namespace logical returnerar serversidesammanfattningar istället för råpayloads.
• Returnerar contents-payloaden från underliggande Flowtly-API.

resources/write

• Endast resurser med allowWrite accepterar skrivning; POST om inte URI slutar med id (då PATCH med application/merge-patch+json).
• /api/.../create tvingar POST även med id; typ kan styras via params.contentType.
• Logiskt write-hjälpmedel: resources/logical/write stöder /logical/recruiting/resource-requests/update?id=<id> och /logical/recruiting/resource-request-candidates/update?id=<id> (PATCH).

Namespace logical (/logical/*)

• Skrivskyddade sammanfattningar: work-times, employees, projects, employee-work-times, project-rates, transactions, project-profitability.
• Recruiting-sammanfattningar: company-onboarding/status, recruiting/open-roles, recruiting/candidates.
• Holidays-sammanfattningar: logical/holidays.
• Exempel: /logical/work-times/summary stöder date[after]/date[before] (standard senaste 7 dagarna).

Felformat

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

Noteringar

• allowPrefixes gör att resources/read accepterar URIs som startar med tillåtna prefix.
• OpenAPI-lik referens finns i public/mcp/openapi.json.

resources/list per namespace