Как подключить MOCO к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → MOCO, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

MOCO + Cursor

Дайте ИИ работать с вашим аккаунтом MOCO: находить проекты и клиентов, смотреть учтённое время по сотрудникам и проектам, проверять неоплаченные счета и загрузку команды, а также записывать время. Нужны поддомен MOCO и API-ключ из вашего профиля в MOCO.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

MOCO_SUBDOMAIN, MOCO_API_KEY

Шаг 1 — Получите учётные данные

1. В MOCO нажмите на свою фотографию профиля справа вверху, откройте в профиле вкладку Integrations и скопируйте личный API-ключ. Ему доступно ровно то, что может видеть и делать ваш пользователь MOCO.
2. Либо создайте ключ аккаунта в Settings → Extensions → API & Webhooks → API Keys с доступом только на чтение или полным доступом. Ключ только для чтения не может записывать время.
3. Вставьте ключ в MOCO_API_KEY.
4. Укажите в MOCO_SUBDOMAIN только первую часть адреса MOCO: для agency.mocoapp.com введите agency, без https:// и без .mocoapp.com. Тогда коннектор будет обращаться к https://agency.mocoapp.com/api/v1.
5. Установите коннектор. Шага Authorize with Provider нет: ключ хранится в зашифрованном виде и отправляется с каждым запросом.
6. Начните с moco_list_users: если он покажет ваших коллег с их ID, ключ и поддомен указаны верно.

Как не потерять авторизацию: коннектор использует ключ напрямую, так что входить заново не нужно. Если ключ в MOCO заменили или удалили, вставьте новый в MOCO_API_KEY.

Что видит ИИ: каждый список возвращает только те записи, которые доступны пользователю ключа. Если кажется, что проект или счёт пропал, дело обычно в правах доступа в MOCO, а не в коннекторе.

Запись времени: moco_create_activity единственный инструмент, который пишет в MOCO. Он создаёт одну запись времени для пользователя, которому принадлежит ключ: дата, ID проекта, ID задачи, длительность в целых секундах (2 часа это 7200) и необязательное описание. Проект ИИ находит через moco_list_projects, его задачи через moco_get_project. Каждый вызов создаёт новую запись, а повторный вызов запишет время дважды, поэтому ИИ сначала показывает дату, проект, задачу и длительность и ждёт вашего подтверждения.

Разрешения и режим только для чтения: чтобы коннектор только читал данные, отключите moco_create_activity на странице коннектора или используйте ключ аккаунта с доступом только на чтение. Не давайте ключ с полным доступом тем, кто должен только читать данные.

Отчёты и счета: moco_list_activities и moco_report_utilization всегда требуют дату начала и дату окончания (from и to, в формате YYYY-MM-DD). Записи времени можно ограничить одним сотрудником, одним проектом или только оплачиваемым временем; отчёт о загрузке сравнивает доступную и забронированную мощность команды. moco_list_invoices фильтрует по статусу (draft, created, sent, partially_paid, paid, overdue, ignored, можно несколько через запятую), дате счёта и компании.

Ограничения: списки отдают до 100 записей на страницу, и ИИ листает дальше до последней. На стандартных тарифах MOCO допускает около 120 запросов за две минуты; сверх этого приходит 429, тогда подождите немного и повторите.

Частые ошибки: 401 означает, что ключ неверный, удалён или относится к другому аккаунту MOCO, чем MOCO_SUBDOMAIN. Если не проходит ни один вызов, проверьте, что в MOCO_SUBDOMAIN указан только поддомен, а не полный адрес. 404 для отдельного проекта означает, что ID неверный или пользователь ключа не видит этот проект. Отклонённая запись времени называет поле, которое MOCO не принял, например задачу, которая не относится к проекту.

Коннектор не создаёт и не отправляет счета, не скачивает PDF, не настраивает вебхуки, не редактирует и не удаляет записи времени и не меняет проекты, компании и пользователей.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты MOCO.

Доступные инструменты

Примеры запросов

• «Сколько часов команда записала на проект Website Relaunch в сентябре и сколько из них оплачиваемые?»
• «Какие счета сейчас просрочены или оплачены частично и каким клиентам они принадлежат?»
• «Какой была загрузка команды в прошлом месяце? Сравни доступную и забронированную мощность.»
• «Запиши сегодня 2,5 часа на проект сайта Acme за ревью макета главной страницы. Покажи мне запись, прежде чем её создавать.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse