Запускайте безпечніших агентів із документацією Flowtly MCP

Як залишатися в курсі

1. Запускайте команду синхронізації після виходу оновлень MCP.
2. Перезапускайте стек агентів, щоб підхопити зміни можливостей.
3. Додайте цю сторінку в закладки, щоб мати актуальні рекомендації Flowtly MCP.

Що всередині

• Правила автентифікації та API-ключів для MCP-ендпоїнтів.
• Схеми ресурсів для бази знань, блогу, релізів, інвесторів і оновлень продукту.
• JSON-RPC пейлоади та поради щодо запису/читання для агентів.

Транспорт і автентифікація

• Ендпоїнти: POST /mcp (вхід JSON-RPC), GET /health (liveness), POST /api/chat (проксі консолі; потрібен Authorization: Bearer <token>)
• Заголовки: Authorization Bearer token (переважно; fallback на FLOWTLY_API_KEY), optional instance header передається далі
• Content-Type: application/json
• Body: JSON-RPC 2.0 { "jsonrpc": "2.0", "id": "...", "method": "...", "params": {...} }

initialize

• Узгоджує можливості та простори імен.
• Приклад params: { "protocolVersion": "2024-11-05" }
• Повертає можливості (list, read, write) і простори імен (work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests).

resources/list

• Метод: resources/{namespace}/list (простір імен за замовчуванням: work-times, якщо не вказано)
• Простори імен включають work-times, projects, employees, vacations, holidays, responsibilities, cost-groups, logical, project-rates, transactions, transaction-attachments, suppliers, organization, candidates, resource-requests.
• Повертає URI для кожного простору імен (див. розклад нижче).

resources/read

• Метод: resources/{namespace}/read (простір імен за замовчуванням: work-times).
• Params включають uri, напр., /api/work-times
• allowPrefixes дозволяє збіги між просторами імен; {current} розвʼязується як /api/employees/me.
• Деякі ресурси додають значення за замовчуванням (work-times додає межі дат; employees додають itemsPerPage; holidays/vacations додають дефолти пагінації).
• Responsibilities проходять до 10 @id посилань, щоб збагачувати title/name.
• Логічний простір імен повертає серверні зведення замість сирих пейлоадів.
• Повертає payload contents з базового Flowtly API.

resources/write

• Лише ресурси з allowWrite приймають записи; POST, якщо URI не закінчується на id (тоді PATCH з application/merge-patch+json).
• /api/.../create примусово робить POST навіть якщо є id; можна перевизначити тип через params.contentType.
• Допоміжний logical write: resources/logical/write підтримує /logical/recruiting/resource-requests/update?id=<id> та /logical/recruiting/resource-request-candidates/update?id=<id> (PATCH).

Логічний простір імен (/logical/*)

• Зведення лише для читання: work-times, employees, projects, employee-work-times, project-rates, transactions, project-profitability.
• Зведення рекрутингу: company-onboarding/status, recruiting/open-roles, recruiting/candidates.
• Зведення відпусток: logical/holidays.
• Приклад: /logical/work-times/summary підтримує date[after]/date[before] (за замовчуванням останні 7 днів).

Форма помилки

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

Нотатки

• allowPrefixes дозволяє resources/read приймати URI, що починаються з дозволених префіксів.
• OpenAPI-стиль довідника доступний у public/mcp/openapi.json.

resources/list за простором імен