Agency Handy — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для доступа к CRM Agency Handy из Claude Code, Cursor, Copilot и других клиентов.
MIT ★ 1 обновлён 2026-10-11
claude mcp add --transport http mcp https://mcp.agencyhandy.com/Что делает 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 дней.
Какие задачи решает
- получить список клиентов, проектов и задач из Agency Handy в агенте
- создать счёт, предложение или лид через ИИ-агента
- найти просроченные счета и клиентов с риском оттока
- отправить клиенту счёт или предложение командой агента
- обновить статус задачи или тикета из IDE
Примеры запросов агенту
- Покажи всех клиентов с просроченными счетами через
ah_cash_risk - Создай задачу в проекте «Редизайн» с дедлайном на пятницу
- Отправь счёт 1024 клиенту по почте
Как установить Agency Handy
Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.agencyhandy.com/Командой платформы: удалённый сервер
codex mcp add agency-handy --url https://mcp.agencyhandy.com/Файл настроек
{
"mcpServers": {
"agency-handy": {
"url": "https://mcp.agencyhandy.com/"
}
}
}Файл настроек
{
"servers": {
"agency-handy": {
"type": "http",
"url": "https://mcp.agencyhandy.com/"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http agency-handy https://mcp.agencyhandy.com/По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об Agency Handy
Как установить Agency Handy в Claude Code?
Выполните claude mcp add --transport http agency-handy https://mcp.agencyhandy.com/, затем запустите /mcp и выберите Authenticate, чтобы войти через Agency Handy.
Что делает Agency Handy?
Подключает ИИ-агента к вашему воркспейсу Agency Handy. Агент может читать клиентов, проекты, задачи, счета, предложения, создавать и обновлять их, отправлять документы клиентам и анализировать риски по просроченным счетам и оттоку клиентов.
Нужен ли API-ключ для работы Agency Handy?
OAuth-вход рекомендован: добавьте URL сервера, войдите в Agency Handy, выберите воркспейс и разрешите доступ. API-ключ нужен только для клиентов без поддержки OAuth — сгенерируйте его в разделе Settings → Workspace Config → API Key и передайте в заголовке Authorization: Bearer YOUR_API_KEY.