# Perfex CRM

Подключает установку Perfex CRM к ИИ-агентам для работы со сделками, счетами и клиентами. Даёт 148 инструментов с фильтрацией по правам доступа.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: themesic
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/themesic/perfex-rest-api-examples
- Обновлён: 2026-10-13
- HTML: https://affpapa.org/nevibecode/mcp/perfex-crm

## Что делает

Сервер связывает среду ассистента с REST API Perfex CRM версии 3.0 через транспорт HTTP JSON-RPC 2.0. Агент получает 148 инструментов для чтения и изменения CRM-записей. В список входят лиды, задачи, счета, проекты, заметки и статьи базы знаний. Доступные операции определяются правами выданного токена.

Авторизация выполняется через заголовок `Authtoken`, созданный в панели управления. Запросы идут к эндпоинту `/api/mcp` на собственном сервере. Поддерживаются пакетные вызовы до 50 операций и ключи идемпотентности.

Без установленного коммерческого модуля REST API от Themesic и включённого MCP эндпоинт работать не будет.

## Требования
- Удалённый сервер: `https://{perfex_host}/api/mcp`

## Установка

### Claude Code (родная платформа)

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http perfex-crm https://{perfex_host}/api/mcp
```

### Codex

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add perfex-crm --url https://{perfex_host}/api/mcp
```

### Cursor

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "perfex-crm": {
            "url": "https://{perfex_host}/api/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "perfex-crm": {
            "type": "http",
            "url": "https://{perfex_host}/api/mcp"
        }
    }
}
```

### Gemini CLI

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http perfex-crm https://{perfex_host}/api/mcp
```

## Когда брать
- создавать и обновлять лиды или контакты клиентов из диалога с агентом
- выставлять счета и проверять статусы проектов в Perfex CRM
- управлять статьями базы знаний и заметками привязанных сущностей
- выполнять пакетные операции в CRM до 50 действий за один вызов

## Примеры запросов агенту
- Найди в Perfex CRM открытые задачи по проекту редизайна и выведи их список
- Создай новый лид с контактом ivan@example.com и прикрепи заметку о звонке
- Проверь статус последнего неоплаченного счёта для клиента Acme Corp

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24271
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7548

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md