Чеклист настройки MCP
Сокращает время первого подключения MCP в Cursor с часов проб и ошибок до структурированного чеклиста — с безопасным хранением секретов и read-only по умолчанию.
Обновлён ·AgentPoint
Бесплатно·Обновлён ·Автор: AgentPoint
Платформы:DifyGigaChat / GigaChainGoogle Sheets
Зачем
SMB хочет дать агенту доступ к PostgreSQL или Bitrix24, но путается в mcp.json, PATH/npx, env-переменных и получает «красный» MCP без понятной диагностики.
Подойдёт, если нужно
- Первое подключение PostgreSQL read-only MCP
- Bitrix24 incoming webhook MCP в Cursor
- MCP не стартует: spawn ENOENT, No tools found
- Security review: allowlist, секреты в env, не в git
- Проверка tools после настройки (Agent prompt)
Не подойдёт, если нужно
Когда не подойдёт ↓
- Разработки custom MCP server с нуля
- Production без review прав и политики секретов
- Запуска непроверенных servers с полным доступом к диску
- Хранения реальных ключей в demo или в git
- Разработки custom MCP server с нуля
- Production без review прав и политики секретов
- Запуска непроверенных servers с полным доступом к диску
- Хранения реальных ключей в demo или в git
Как пользоваться
- 1
Опишите задачу. macOS + nvm, локальный PostgreSQL (БД shop, порт 5432). Нужен read-only MCP в Cursor для SELECT-аналитики. Дай чеклист: user readonly, mcp.json, env, проверка tools и типичный spawn ENOENT fix.
- 2
Получите черновик. Bitrix24 cloud, incoming webhook (crm.lead.list, crm.deal.list), только чтение на старте. Cursor Windows. Чеклист подключения MCP: конфиг, env BITRIX24_WEBHOOK_URL с плейсхолдером, security, тестовый prompt для Agent.
- 3
Проверьте результат. Cursor Mac: MCP postgres красный, MCP Logs — spawn npx ENOENT, в Terminal npx работает. Пошаговый troubleshooting: PATH, absolute paths, тест команды в терминале, перезапуск.
Для технарей: SKILL.md и экспорт
Установка и экспорт
Скачайте SKILL.md, metadata.json, правило Cursor или адаптер под вашу платформу. Файлы генерируются из текущей версии skill и кешируются в хранилище.
Адаптеры платформ
Частые вопросы
Куда класть mcp.json — глобально или в проект?
Global: ~/.cursor/mcp.json — сервер доступен во всех проектах. Project: .cursor/mcp.json в корне репозитория — только для этого проекта; project-level перекрывает global. Секреты не коммитьте — используйте env или envFile вне git.
Skill запускает MCP за меня?
Нет. Skill выдаёт чеклист и шаблон конфига. Установку и проверку выполняете локально в Cursor. Demo AgentPoint не имеет доступа к вашему MCP.
Почему spawn ENOENT при рабочем npx в терминале?
Cursor, запущенный из GUI, часто не наследует PATH shell (особенно nvm). Решение: absolute path к npx/node в command и env.PATH с путём к Node.
Можно ли сразу дать write-доступ в CRM?
Skill рекомендует начинать с read-only или минимального webhook scope и human confirmation перед write tools. Полный write — только после тестов и allowlist.
Платформы
История
v1.1.0 — expanded SKILL.md: MCP setup checklist (mcp.json, env/secrets, read-only, verify, troubleshooting ENOENT), 3 examples. Research: Cursor docs RU, mayai.ru, NxCode, AgentPoint MCP catalog. Trust labels aligned to prompt-only skill.
Частые вопросы
Куда класть mcp.json — глобально или в проект?
Global: ~/.cursor/mcp.json — сервер доступен во всех проектах. Project: .cursor/mcp.json в корне репозитория — только для этого проекта; project-level перекрывает global. Секреты не коммитьте — используйте env или envFile вне git.
Skill запускает MCP за меня?
Нет. Skill выдаёт чеклист и шаблон конфига. Установку и проверку выполняете локально в Cursor. Demo AgentPoint не имеет доступа к вашему MCP.
Почему spawn ENOENT при рабочем npx в терминале?
Cursor, запущенный из GUI, часто не наследует PATH shell (особенно nvm). Решение: absolute path к npx/node в command и env.PATH с путём к Node.
Можно ли сразу дать write-доступ в CRM?
Skill рекомендует начинать с read-only или минимального webhook scope и human confirmation перед write tools. Полный write — только после тестов и allowlist.
Похожие навыки
Нужно под ваш процесс?
Подстроим навык под ваши офферы, тон и ограничения. Или добавим новый, если такого нет.
Адаптировать под мой бизнес