MCP-сервер

Framix предоставляет Remote MCP-сервер (Model Context Protocol) — это надстройка над Workspace API. Подключив его как коннектор в Claude Desktop, Cursor или любой MCP-совместимый клиент, вы даёте нейросети управлять вашей группой обычными словами:

• «Покажи новые лиды за последнюю неделю и помечай обработанными те, где есть телефон»
• «Добавь в каталог 5 товаров: …»
• «Создай лендинг для кофейни и сохрани его HTML на главную страницу сайта X»
• «Сколько записей на завтра и какие из них не подтверждены?»

Нейросеть работает строго в рамках прав вашего ключа: MCP-тулзы — это тонкая обёртка над теми же REST-эндпоинтами, и каждая операция проходит ту же проверку скоупов, что и прямой вызов API. Что не разрешено ключом — ИИ сделать не сможет.

Чем это отличается от обычного API

Если коротко: MCP — это «руки» для нейросети поверх того же ключа.

Шаг 1. Создайте API-ключ

1. Откройте Настройки группы → API-ключи (/account/settings/api-keys).
2. Нажмите «Создать ключ», задайте имя (напр. «Claude Desktop»).
3. Выберите скоупы. Принцип — минимально необходимые:
   • только чтение аналитики/лидов → crm:read, projects:read;
   • наполнение каталога → products:read, products:write;
   • полный контент-менеджмент → projects, pages, products, services, crm на чтение и запись.
4. Скопируйте токен fmxk_... — он показывается один раз.

Чем уже скоупы ключа, тем меньше нейросеть может сделать «не то». Для экспериментов начните с *:read.

Шаг 2. Подключите коннектор

Эндпоинт один для всех клиентов:

POST https://framix.app/api/mcp

Транспорт — Streamable HTTP (stateless JSON-RPC 2.0). Авторизация — заголовком:

Authorization: Bearer fmxk_ваш_токен

Claude Desktop / Cursor / Windsurf

В конфиге MCP-коннекторов добавьте HTTP-сервер с заголовком авторизации:

{
  "mcpServers": {
    "framix": {
      "url": "https://framix.app/api/mcp",
      "headers": {
        "Authorization": "Bearer fmxk_ваш_токен"
      }
    }
  }
}

Где лежит конфиг:

• Claude Desktop — claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\). Также можно добавить через Settings → Connectors.
• Cursor — ~/.cursor/mcp.json или Settings → MCP.

После сохранения перезапустите клиент. Он автоматически вызовет initialize и tools/list — в списке инструментов появятся framix_*.

Клиенты, требующие команду запуска (mcp-remote)

Если клиент умеет только локальные stdio-серверы, используйте мост mcp-remote:

{
  "mcpServers": {
    "framix": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://framix.app/api/mcp",
        "--header",
        "Authorization: Bearer fmxk_ваш_токен"
      ]
    }
  }
}

Шаг 3. Пользуйтесь

Просто пишите задачу словами — нейросеть сама подберёт инструменты. Несколько примеров диалогов:

Наполнить каталог

Добавь товар «Зерно Эфиопия Иргачефф», цена 890 ₽, остаток 40, артикул COF-ETH-01.

ИИ вызовет framix_create_product с price: 89000 (копейки) и нужными полями.

Обработать лиды

Покажи новые заявки и переведи в работу те, где указан телефон.

framix_list_leads → framix_set_lead_status по каждой подходящей.

Собрать страницу

Сделай продающий лендинг для студии йоги и сохрани его на главную страницу сайта «Дзен».

framix_list_sites → framix_list_pages → framix_save_page_html.

Доступные инструменты

Все тулзы с префиксом framix_. Денежные значения — в копейках (89000 = 890 ₽), длительность — в минутах. Точные параметры приходят в inputSchema ответа tools/list и совпадают с телами REST-эндпоинтов.

Ручная проверка (curl)

Полезно убедиться, что ключ работает, до настройки клиента.

Список инструментов:

curl https://framix.app/api/mcp \
  -H "Authorization: Bearer fmxk_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Вызов инструмента (новые лиды):

curl https://framix.app/api/mcp \
  -H "Authorization: Bearer fmxk_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"framix_list_leads","arguments":{"status":"new","size":20}}}'

Создать товар (цена в копейках):

curl https://framix.app/api/mcp \
  -H "Authorization: Bearer fmxk_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"framix_create_product",
                 "arguments":{"name":"Тестовый товар","price":89000,"stock":10}}}'

Успешный ответ инструмента приходит в result.content[0].text (это JSON соответствующего эндпоинта).

Диагностика

Ошибка конкретного инструмента (нет скоупа, ресурс не найден, невалидные данные) возвращается не как ошибка протокола, а как результат tools/call с isError: true — нейросеть видит текст ошибки и может среагировать.

Безопасность

• Права нейросети = скоупы ключа. Для read-only сценариев выпускайте ключ только с *:read.
• Финансы (баланс, платежи, карты) и управление самими ключами через MCP недоступны — это безусловное ограничение, как и у Workspace API.
• Ключ хранится у вас в конфиге MCP-клиента; на стороне Framix — только его SHA-256-хэш. Потеряли или засветили — отзовите в /account/settings/api-keys и выпустите новый.
• Для каждого клиента/сценария лучше отдельный ключ с говорящим именем — так проще отозвать только нужный.