API и MCP нужны для подключения ПланЦели к внешним инструментам: AI-агентам, автоматизациям, ботам и личным скриптам. Доступ работает через персональный токен и доступен в тарифе Pro.
Что нужно для подключения
- аккаунт ПланЦели;
- активный тариф Pro;
- созданный API/MCP-токен;
- инструмент, который умеет отправлять API-запросы или подключать MCP-сервер.
1. Создайте токен в ПланЦели
- Войдите в ПланЦели.
- Откройте настройки внутри сервиса.
- Найдите блок API и MCP.
- Введите название токена, например AI-помощник.
- Нажмите Создать токен.
- Скопируйте токен сразу после создания. Повторно он не показывается.
2. Проверьте API
Подставьте токен в запрос:
curl https://planceli.ru/api/v1/me \
-H "Authorization: Bearer ВАШ_ТОКЕН"
Если токен рабочий, сервис вернёт данные вашего аккаунта. Если вернулся ответ с ошибкой доступа, проверьте тариф Pro и сам токен.
3. Подключите MCP
Добавьте MCP-сервер ПланЦели в конфиг вашего AI-инструмента:
{
"mcpServers": {
"planceli": {
"command": "node",
"args": ["путь/к/scripts/mcp-server.mjs"],
"env": {
"PLANCELI_API_BASE": "https://planceli.ru",
"PLANCELI_API_TOKEN": "ВАШ_ТОКЕН"
}
}
}
}
Что можно делать через API и MCP
- получать данные аккаунта;
- читать годовые, квартальные и недельные цели;
- читать и сохранять записи дня;
- получать список мечт;
- добавлять мечты;
- получать прогресс;
- собирать недельный отчёт.
4. Отзовите токен, если он больше не нужен
Откройте настройки ПланЦели, найдите нужный токен в блоке API и MCP и удалите его. После удаления старый токен перестанет работать.
Безопасность
Токен даёт доступ к данным аккаунта. Не публикуйте его в статьях, чатах, репозиториях и скриншотах. Для каждого внешнего сервиса создавайте отдельный токен. Если токен попал посторонним, удалите его и создайте новый.