# mcp-pipedrive

MCP-сервер, который открывает агенту доступ к Pipedrive CRM: сделки, контакты, воронки, задачи и ещё десятки сущностей через обычный диалог.

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

## Что делает

Сервер закрывает REST API Pipedrive обеих версий и отдаёт агенту набор инструментов по категориям: сделки, персоны, организации, проекты, воронки, лиды, продукты, заметки, активности, файлы, вебхуки и другие. Часть разделов нужна редко, поэтому категории можно включать выборочно через `PIPEDRIVE_TOOLSETS`. Есть режим только для чтения — `PIPEDRIVE_READ_ONLY` блокирует любые записи.

Внутри обработка ошибок с подсказками, повтор запросов с нарастающей паузой при ответах 429 и 5xx, кеш на часто читаемые данные и лимит частоты запросов. Схемы описаны на TypeScript, входные данные проверяются через Zod, так что неверный аргумент возвращается понятной ошибкой. Отдельно от инструментов есть read-only ресурсы (воронки, кастомные поля, пользователи) и готовые промпты для типовых операций.

Для запуска нужен Node.js 18 или новее и токен из настроек Pipedrive, в командах он идёт как `PIPEDRIVE_API_TOKEN`, плюс домен компании в `PIPEDRIVE_COMPANY_DOMAIN`. Без токена сервер не авторизуется. Режим только для чтения стоит включить до первого запуска на живом аккаунте — так агент не тронет реальные сделки, пока вы не убедитесь, что он видит нужные данные.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PIPEDRIVE_API_TOKEN`, `PIPEDRIVE_COMPANY_DOMAIN`, `PIPEDRIVE_TOOLSETS`, `PIPEDRIVE_READ_ONLY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env PIPEDRIVE_API_TOKEN=<PIPEDRIVE_API_TOKEN> --env PIPEDRIVE_COMPANY_DOMAIN=<PIPEDRIVE_COMPANY_DOMAIN> --env PIPEDRIVE_TOOLSETS=<PIPEDRIVE_TOOLSETS> --env PIPEDRIVE_READ_ONLY=<PIPEDRIVE_READ_ONLY> --transport stdio mcp-pipedrive -- npx -y @nubiia/mcp-pipedrive
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-pipedrive --env PIPEDRIVE_API_TOKEN=<PIPEDRIVE_API_TOKEN> --env PIPEDRIVE_COMPANY_DOMAIN=<PIPEDRIVE_COMPANY_DOMAIN> --env PIPEDRIVE_TOOLSETS=<PIPEDRIVE_TOOLSETS> --env PIPEDRIVE_READ_ONLY=<PIPEDRIVE_READ_ONLY> -- npx -y @nubiia/mcp-pipedrive
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-pipedrive": {
            "command": "npx",
            "args": [
                "-y",
                "@nubiia/mcp-pipedrive"
            ],
            "env": {
                "PIPEDRIVE_API_TOKEN": "<PIPEDRIVE_API_TOKEN>",
                "PIPEDRIVE_COMPANY_DOMAIN": "<PIPEDRIVE_COMPANY_DOMAIN>",
                "PIPEDRIVE_TOOLSETS": "<PIPEDRIVE_TOOLSETS>",
                "PIPEDRIVE_READ_ONLY": "<PIPEDRIVE_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-pipedrive": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@nubiia/mcp-pipedrive"
            ],
            "env": {
                "PIPEDRIVE_API_TOKEN": "<PIPEDRIVE_API_TOKEN>",
                "PIPEDRIVE_COMPANY_DOMAIN": "<PIPEDRIVE_COMPANY_DOMAIN>",
                "PIPEDRIVE_TOOLSETS": "<PIPEDRIVE_TOOLSETS>",
                "PIPEDRIVE_READ_ONLY": "<PIPEDRIVE_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e PIPEDRIVE_API_TOKEN=<PIPEDRIVE_API_TOKEN> -e PIPEDRIVE_COMPANY_DOMAIN=<PIPEDRIVE_COMPANY_DOMAIN> -e PIPEDRIVE_TOOLSETS=<PIPEDRIVE_TOOLSETS> -e PIPEDRIVE_READ_ONLY=<PIPEDRIVE_READ_ONLY> mcp-pipedrive npx -y @nubiia/mcp-pipedrive
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Покажи все сделки в воронке «Продажи», которые стоят на стадии переговоров дольше недели
- Создай контакт для нового клиента и привяжи его к организации из письма
- Какие активности по этой сделке просрочены и кто за них отвечает?

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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