Weeek MCP Server
Python MCP-сервер для WEEEK API v1: задачи, проекты, доски, воронки, сделки и контакты, с режимом SSE для n8n
Установка
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp env.example .env
python -m src.serverВыполняется в склонированном репозитории github.com/AlekMel/weeek-mcp-server после записи WEEEK_TOKEN в .env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает весь публичный API WEEEK в инструменты MCP. Кроме задач, проектов, досок и колонок, агент получает CRM-часть WEEEK: воронки, статусы, сделки, организации и контакты, а также теги, пользовательские поля, портфели и пользователей. Для большинства сущностей есть полный набор операций, включая удаление. Сервер работает локально по stdio или в Docker по SSE с ключом доступа, что позволяет вызывать инструменты из n8n. Токены в логах скрываются, запросы повторяются при сбоях.
Для кого. Для команд на WEEEK, которым нужен полный доступ к API из агента или из автоматизаций n8n.
Подходит, если
- Нужны не только задачи, но и сделки, воронки и контакты WEEEK
- Нужно вызывать WEEEK из сценариев n8n через MCP
- Нужно массово создать задачи или проекты
Не подходит, если
- Нужен установщик в один клик для Claude Code: удобнее плагин claude-weeek
- Агенту нельзя давать инструменты удаления пользователей и проектов
Пример запроса к агенту
Найди в WEEEK все срочные задачи и покажи сделки на стадии переговоровОграничения
Пакета в реестре нет, сервер ставится из исходников с Python 3.10 или новее и запускается из папки репозитория. В README ссылка для клонирования оставлена шаблонной, используйте адрес этого репозитория. Нужен API-токен WEEEK. В SSE-режиме обязателен MCP_API_KEY, открывать порт в интернет без firewall и HTTPS нельзя. Последние изменения были в конце 2025 года.
Как отключить. Удалите блок weeek из конфигурации MCP клиента, для Docker выполните docker-compose down. Токен удалите в настройках WEEEK.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WEEEK_TOKEN обязательная, секрет | API-токен из настроек WEEEK |
| TRANSPORT | stdio по умолчанию или sse для сетевого доступа |
| MCP_API_KEY секрет | Ключ доступа к SSE-эндпоинтам, обязателен в SSE-режиме |
Проверка безопасности
- Может удалять пользователей, проекты, задачи и сделки
- SSE-режим открывает API рабочего пространства по сети
Коротко о README
README на русском проводит через установку из исходников, получение токена WEEEK и настройку .env. Описаны локальный запуск, Docker и Docker Compose, SSE-режим с ключом, развертывание на VPS с firewall и nginx. Отдельный раздел показывает вызовы инструментов из n8n. Приведены конфигурации Claude Desktop и Cursor для stdio и SSE и полный список инструментов по разделам API.
Частые вопросы
Чем отличается от плагина claude-weeek?
Этот сервер покрывает весь API, включая CRM и удаление, и умеет SSE для n8n. Плагин ограничен задачами без удаления, зато ставится через маркетплейс и содержит скиллы.
Как подключить к удаленному серверу?
Запустите Docker с TRANSPORT=sse и MCP_API_KEY и укажите в клиенте url вида http://host:3847/sse с заголовком Authorization: Bearer.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании