mcp-crm

Учебный проект: сервер Model Context Protocol, который предоставляет CRM MCP-клиенту через stdio.

Вход выполняется через Microsoft Entra с использованием потока с кодом устройства. Полученный идентификационный токен обменивается на токен доступа к CRM, поэтому запросы к CRM выполняются от имени вошедшего пользователя и возвращают только те данные, которые этот пользователь имеет право видеть.

Требования

• Node.js 20+

• Регистрация приложения в Entra с включённым потоком с кодом устройства (публичный клиент)

• CRM API, который принимает токен Entra по адресу POST /api/auth/entra и отдаёт GET /api/accounts

Related MCP server: Relay MCP

Настройка

npm install

Создайте файл .env в корне проекта:

ENTRA_CLIENT_ID=<your app registration's client id>
ENTRA_TENANT_ID=<your directory tenant id>
CRM_API_BASE_URL=https://your-crm.example.com

Все три значения обязательны — сервер выдаст ошибку при запуске, если какого-то из них нет. .env находится в gitignore; не коммитьте его.

Запуск

npx tsx src/index.ts     # run directly
npx tsc                  # type-check and build to dist/

Сервер общается по MCP через stdio, поэтому его обычно запускает клиент, а не вручную. Чтобы зарегистрировать его в Claude Code:

{
  "mcpServers": {
    "crm": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/mcp-crm/src/index.ts"]
    }
  }
}

Журнал выводится в stderr, поскольку stdout несёт протокол MCP.

Инструменты

Порядок входа

start_crm_login не может ждать завершения входа в Entra, поэтому он разделён на два этапа:

1. Вызовите start_crm_login. Он вернёт код устройства и URL, который нужно открыть.

2. Завершите вход в браузере.

3. Вызовите crm_login_status для подтверждения. Как только он сообщит о вошедшем пользователе, search_crm_accounts заработает.

Токен хранится только в памяти — перезапуск сервера означает, что нужно входить заново.

Лицензия

ISC