Twórz bezpieczniejszych agentów z dokumentacją Flowtly MCP

Jak być na bieżąco

1. Uruchom komendę sync po każdej aktualizacji MCP.
2. Zrestartuj stos agentów, aby wczytać nowe możliwości.
3. Dodaj tę stronę do zakładek, żeby mieć świeże wskazówki MCP.

Co w środku

• Zasady autoryzacji i kluczy API dla endpointów MCP.
• Schematy zasobów dla bazy wiedzy, bloga, release notes, inwestorów i aktualizacji produktu.
• Ładunki JSON-RPC oraz wskazówki do zapisów/odczytów dla agentów.

Transport i Auth

• Endpointy: POST /mcp (wejście JSON-RPC), GET /health (liveness), POST /api/chat (proxy konsoli; wymaga Authorization: Bearer <token>)
• Nagłówki: Authorization Bearer token (preferowany; fallback FLOWTLY_API_KEY), nagłówek instance opcjonalny i przekazywany dalej
• Content-Type: application/json
• Body: JSON-RPC 2.0 { "jsonrpc": "2.0", "id": "...", "method": "...", "params": {...} }

initialize

• Negocjuje możliwości i namespaces.
• Przykładowe parametry: { "protocolVersion": "2024-11-05" }
• Zwraca capabilities (list, read, write) i namespaces (work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests).

resources/list

• Metoda: resources/{namespace}/list (domyślny namespace: work-times, gdy pominięty)
• Namespaces: work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests.
• Zwraca URI per namespace (szczegóły poniżej).

resources/read

• Metoda: resources/{namespace}/read (domyślnie work-times).
• Parametry obejmują uri, np. /api/work-times
• allowPrefixes umożliwia dopasowania między namespaces; {current} rozwija się do /api/employees/me.
• Niektóre zasoby dodają domyślne wartości (work-times dodaje zakres dat; employees dodaje itemsPerPage; holidays/vacations dodają domyślną paginację).
• Responsibilities śledzi do 10 linków @id, aby wzbogacić tytuł/nazwę.
• Namespace logical zwraca serwerowe podsumowania zamiast surowych payloadów.
• Zwraca payload contents z bazowej API Flowtly.

resources/write

• Tylko zasoby z allowWrite przyjmują zapis; POST chyba że URI kończy się id (wtedy PATCH z application/merge-patch+json).
• /api/.../create wymusza POST nawet przy id; typ można nadpisać przez params.contentType.
• Pomocnik logical write: resources/logical/write obsługuje /logical/recruiting/resource-requests/update?id=<id> oraz /logical/recruiting/resource-request-candidates/update?id=<id> (PATCH).

Namespace logical (/logical/*)

• Podsumowania tylko do odczytu: work-times, employees, projects, employee-work-times, project-rates, transactions, project-profitability.
• Podsumowania rekrutacji: company-onboarding/status, recruiting/open-roles, recruiting/candidates.
• Podsumowania urlopów: logical/holidays.
• Przykład: /logical/work-times/summary obsługuje date[after]/date[before] (domyślnie ostatnie 7 dni).

Kształt błędu

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

Notatki

• allowPrefixes pozwala resources/read akceptować URI zaczynające się od dozwolonych prefiksów.
• Referencja w stylu OpenAPI dostępna w public/mcp/openapi.json.

resources/list według namespace