Тот же набор методов, но для ИИ-клиента: Cursor, Claude Code и похожие. Клиент видит, кто вы и в каком проекте сидите. В конфиг подставляется ваш ключ, не общий на всю команду.
Кто вызывает
Ключ привязан к одному пользователю и одному проекту. При подключении клиент получает имя, email и название проекта. Инструмент brifly_session возвращает ту же пару. Сменить пользователя или проект из клиента нельзя: для другой пары нужен другой ключ.
Адреса
POST /mcp и GET /mcp. Прод: https://api-external.brifly.online/mcp.
Имя инструмента
Путь метода, слэши заменены на _. Пример: ai-operator-tasks/list → ai-operator-tasks_list.
Аргумент
Поле data совпадает с телом POST /v1/.... Scope ключа проверяется так же, как у HTTP-метода. Чужой data.projectId возвращает PROJECT_MISMATCH.
Учебный пример магазина «Северная полка». Это не запись из вашей базы. Клиент вызывает инструмент списка задач. Имя инструмента — путь метода, слэши заменены на _.
Запрос
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "content-factory-tasks_list",
"arguments": {
"data": {
"projectId": "11111111-1111-4111-8111-111111111111",
"page": 1,
"pageSize": 20
}
}
}
}Ответ (успех, 200)
{
"success": true,
"data": {
"items": [
{
"id": "33333333-3333-4333-8333-333333333333",
"title": "Пост про кружку к выходным",
"description": "Короткий текст для карточки, тон спокойный.",
"status": "in_progress",
"priority": "normal",
"channel": "site",
"scenarioType": "product_post",
"templateId": "22222222-2222-4222-8222-222222222222",
"productId": "55555555-5555-4555-8555-555555555555",
"product": {
"id": "55555555-5555-4555-8555-555555555555",
"name": "Кружка эмаль, 350 мл"
},
"template": {
"id": "22222222-2222-4222-8222-222222222222",
"title": "Короткий пост для витрины"
},
"messageTextsCount": 1,
"archivedAt": null,
"projectId": "11111111-1111-4111-8111-111111111111",
"createdAt": "2026-10-16T09:00:00.000Z",
"updatedAt": "2026-10-16T09:12:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}
}Пример cURL
curl -X POST "https://api-external.brifly.online/mcp" \
-H "Content-Type: application/json" \
-H "X-Api-Key: {{api_key}}" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "content-factory-tasks_list", "arguments": {"data": {"projectId": "11111111-1111-4111-8111-111111111111", "page": 1, "pageSize": 20}}}}'