Розробникам · MCP

MCP-сервер

Як підключити Claude Code чи інший MCP-клієнт до Bordee і які інструменти є для контактів, угод, розмов, задач, воронок і розсилок.

Що це

У кожного простору є MCP-сервер (Model Context Protocol): https://acme.bord.ee/mcp, транспорт streamable HTTP. Через нього AI-агент — Claude Code, Claude Desktop чи будь-який MCP-клієнт — читає й змінює дані CRM. Той самий сервер використовує асистент Bordee.

Підключення

Потрібен токен доступу: «Лише читання» — щоб агент лише читав, «Читання й зміни» — щоб і змінював. Claude Code:

claude mcp add --transport http bordee https://acme.bord.ee/mcp \
  --header "Authorization: Bearer $BORDEE_TOKEN"

Клієнт з файлом налаштувань:

{
  "mcpServers": {
    "bordee": {
      "type": "http",
      "url": "https://acme.bord.ee/mcp",
      "headers": {"Authorization": "Bearer <токен>"}
    }
  }
}

Права

Агент діє з правами власника токена: роль, правила доступу, модулі. Чужий запис для нього — «не знайдено».
Інструменти, що змінюють дані, видно лише токену з доступом «Читання й зміни».
Інструменти модуля є, поки модуль увімкнено.
Ліміт той самий, що в API: 120 запитів на хвилину на токен.

Інструменти

Розділ	Інструменти
Загальне	crm_whoami — бізнес, власник токена, дозволи, модулі, мови, співробітники
Контакти й компанії	contacts_search, contact_show, contact_update, contact_comment, companies_search, company_show, contacts_import_preview, contacts_import
Угоди	deals_pipelines, deals_search, deal_show, deal_create, deal_update, deal_move, deal_comment
Розмови	conversations_search, conversation_show, conversation_reply, conversation_update (статус, менеджер, пауза ботів)
Задачі	tasks_search, task_create, task_update; backlog_lists, backlog_items, backlog_item, backlog_upsert, backlog_set_status, backlog_comments, backlog_comment
Воронки	funnels_search, funnel_show, funnel_create, funnel_update, funnel_publish, funnel_start
Розсилки	broadcasts_search, broadcast_show, broadcast_create, broadcast_update, broadcast_send, broadcast_cancel

Зміни йдуть через ті самі сервіси, що й адмінка: з перевірками, стрічкою й подіями. Воронка змінюється в чернетці й публікується окремою дією. Імпорт контактів спершу рахує нові записи, збіги й помилки, а потім пише.

Що попросити

«Знайди угоди без руху понад два тижні й постав відповідальним задачі передзвонити».
«Підсумуй розмову з Іриною Коваль і запропонуй відповідь».
«Переклади воронку welcome англійською».
«Підготуй розсилку для тегу VIP на п’ятницю о 10:00».