# Agency Handy

MCP-сервер для доступа к CRM Agency Handy из Claude Code, Cursor, Copilot и других клиентов.

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

## Что делает

Хостится Agency Handy по адресу `https://mcp.agencyhandy.com/` — ничего не нужно устанавливать локально. Вход через Agency Handy (OAuth 2.1 с PKCE) или API-ключ из настроек воркспейса.

Предоставляет инструменты с префиксом `ah_`: чтение клиентов, лидов, проектов, задач, тикетов, комментариев, счетов, предложений, заказов, подписок, сервисов, форм и кастомных полей; создание и обновление лидов, клиентов, задач, тикетов, комментариев, счетов, предложений и заказов; отправка счетов и предложений по почте клиенту; аналитика (`ah_dashboard_digest`, `ah_cash_risk`, `ah_client_churn_risk`). Для старта сессии вызывается `ah_health`, модель данных — в ресурсе `ah://full-context`.

Всё работает с правами того, кто подключился, в выбранном воркспейсе. Инструменты отправки писем и удаления меняют реальные данные клиентов — проверяйте команды перед подтверждением. Сервер не хранит данные воркспейса, только короткие логи запросов (инструмент, время, ID участника и воркспейса, IP-адрес, ошибки без ключей) до 14 дней.

## Требования
- Удалённый сервер: `https://mcp.agencyhandy.com/`

## Установка

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

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.agencyhandy.com/
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add agency-handy --url https://mcp.agencyhandy.com/
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agency-handy": {
            "url": "https://mcp.agencyhandy.com/"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agency-handy": {
            "type": "http",
            "url": "https://mcp.agencyhandy.com/"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http agency-handy https://mcp.agencyhandy.com/
```

## Когда брать
- получить список клиентов, проектов и задач из Agency Handy в агенте
- создать счёт, предложение или лид через ИИ-агента
- найти просроченные счета и клиентов с риском оттока
- отправить клиенту счёт или предложение командой агента
- обновить статус задачи или тикета из IDE

## Примеры запросов агенту
- Покажи всех клиентов с просроченными счетами через `ah_cash_risk`
- Создай задачу в проекте «Редизайн» с дедлайном на пятницу
- Отправь счёт 1024 клиенту по почте

## Похожие
- [FavCRM — Agentic CRM](https://affpapa.org/nevibecode/mcp/favcrm-agentic-crm.md) — MCP-сервер · 8514 установок
- [Onplana](https://affpapa.org/nevibecode/mcp/onplana.md) — MCP-сервер · ★ 5 у репозитория
- [Workast](https://affpapa.org/nevibecode/mcp/workast.md) — MCP-сервер · ★ 1 у репозитория
- [quote-to-cash](https://affpapa.org/nevibecode/skills/quote-to-cash.md) — скилл · 1800 установок
- [mycase-mcp](https://affpapa.org/nevibecode/mcp/mycase-mcp.md) — MCP-сервер · ★ 6 у репозитория
- [QuickBooks Online](https://affpapa.org/nevibecode/mcp/quickbooks-online.md) — MCP-сервер · ★ 14 у репозитория

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