Contractor Foreman by Cotlet — MCP-сервер для Claude Code
MCP-сервер связывает ИИ-агента с Contractor Foreman, чтобы работать с проектами, сметами, ежедневными журналами и счетами. Доступны также REST API и интерфейс Python.
claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connectЧто делает Contractor Foreman by Cotlet
Сервер открывает агенту доступ к данным Contractor Foreman через инструменты MCP. С ними можно получать сведения о проектах, проверять расписание, работать со сметами, счетами и платежами, а также обращаться к журналам работ, заказам и инспекциям. Всего в проекте предусмотрено 89 инструментов. Отдельно доступны REST API и вызовы из Python, включая готовые скрипты в каталоге examples/.
Локальная версия работает на Python и использует авторизованную сессию Google Chrome. Команда contractor-foreman-mcp connect получает браузерные cookies через Chrome DevTools Protocol и сохраняет сессию в ~/.config/contractor-foreman-api-mcp/session.json. Пароль аккаунта сервер не считывает. Для работы нужны Python 3.11 или новее, Google Chrome 144 или новее и права на соответствующие разделы Contractor Foreman.
Подключение к Claude Code, Codex и другим поддерживаемым клиентам настраивается через MCP по HTTP или stdio. Важное ограничение: локальная версия предназначена только для некоммерческого использования, а после завершения сессии потребуется обновить авторизацию через Chrome. Сервер обращается к тем же внутренним API приложения, поэтому изменения в Contractor Foreman могут повлиять на его работу.
Какие задачи решает
- Получать список проектов Contractor Foreman по запросу агента
- Проверять расписание и ежедневные журналы работ
- Просматривать сметы, счета и сведения об оплатах
- Обращаться к заказам, инспекциям и заявкам на изменение работ
- Передавать данные Contractor Foreman в Python-скрипты через REST API
Примеры запросов агенту
- Найди проекты в Contractor Foreman, в названии которых есть Oak St.
- Покажи сметы и неоплаченные счета для выбранного проекта в Contractor Foreman.
- Получи ежедневные журналы работ и проверь последние записи по проекту.
Как установить Contractor Foreman by Cotlet
1Командой платформы: удалённый сервер
claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connect2Командой платформы
claude mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from contractor-foreman-api-mcp <команда>
1Командой платформы: удалённый сервер
codex mcp add contractor-foreman-by-cotlet --url https://cotlet.dev/mcp/v1/contractor-foreman/connect2Командой платформы
codex mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from contractor-foreman-api-mcp <команда>
Файл настроек
{
"mcpServers": {
"contractor-foreman-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/contractor-foreman/connect"
}
}
}{
"mcpServers": {
"contractor-foreman-by-cotlet": {
"command": "uvx",
"args": [
"contractor-foreman-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from contractor-foreman-api-mcp <команда>
Файл настроек
{
"servers": {
"contractor-foreman-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/contractor-foreman/connect"
}
}
}{
"servers": {
"contractor-foreman-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"contractor-foreman-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from contractor-foreman-api-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http contractor-foreman-by-cotlet https://cotlet.dev/mcp/v1/contractor-foreman/connect2Командой платформы
gemini mcp add contractor-foreman-by-cotlet uvx contractor-foreman-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from contractor-foreman-api-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Contractor Foreman by Cotlet
Как установить Contractor Foreman by Cotlet в Claude Code?
Для подключения к размещённому MCP-серверу выполни claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connect. Для локального запуска выполни claude mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcp.
Что делает Contractor Foreman by Cotlet?
Он предоставляет ИИ-агенту доступ к данным Contractor Foreman через MCP. Сервер поддерживает работу с проектами, расписанием, сметами, счетами, платежами и другими разделами приложения.
Что нужно для локального запуска MCP-сервера?
Нужны Python 3.11 или новее, Google Chrome 144 или новее с авторизованным аккаунтом Contractor Foreman и доступ к используемым модулям. Команда contractor-foreman-mcp connect получает сессию из Chrome.
