clio-mcp — MCP-сервер для Claude Code: данные Clio
Подключает Claude Code к Clio через MCP и даёт работать с делами, заметками, документами и биллингом. Подходит для запросов к данным практики из чата.
claude mcp add --env CLIO_CLIENT_ID=<CLIO_CLIENT_ID> --env CLIO_CLIENT_SECRET=<CLIO_CLIENT_SECRET> --env ENCRYPTION_KEY=<ENCRYPTION_KEY> --env CLIO_REDIRECT_PORT=<CLIO_REDIRECT_PORT> --env CLIO_REGION=<CLIO_REGION> --transport stdio clio-mcp -- npx -y @oktopeak/clio-mcpЧто делает clio-mcp
clio-mcp подключает Claude Code к Clio через MCP. Сервер читает данные о делах, пользовательских полях, заметках, контактах, документах, папках, задачах, календаре и биллинге. Доступ идёт через API, поэтому клиентские сведения не нужно вручную переносить в чат.
Каждый вызов инструмента записывается в локальный журнал ~/.clio-mcp/audit.log; токен авторизации хранится в зашифрованном виде. Для запуска нужно зарегистрировать собственное приложение Clio и задать CLIO_CLIENT_ID, CLIO_CLIENT_SECRET и ENCRYPTION_KEY. Без этих значений сервер не подключится к Clio.
Какие задачи решает
- найти дела и контакты в Clio по запросу
- получить заметки и пользовательские поля дела
- проверить документы и папки через Claude Code
- просмотреть задачи, календарь и биллинг
- записать действия к данным Clio через MCP
Примеры запросов агенту
- Найди в Clio открытые дела, связанные с этим клиентом.
- Покажи заметки и пользовательские поля для дела с указанным названием.
- Проверь документы, задачи и записи биллинга по этому делу.
Как установить clio-mcp
Командой платформы
claude mcp add --env CLIO_CLIENT_ID=<CLIO_CLIENT_ID> --env CLIO_CLIENT_SECRET=<CLIO_CLIENT_SECRET> --env ENCRYPTION_KEY=<ENCRYPTION_KEY> --env CLIO_REDIRECT_PORT=<CLIO_REDIRECT_PORT> --env CLIO_REGION=<CLIO_REGION> --transport stdio clio-mcp -- npx -y @oktopeak/clio-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add clio-mcp --env CLIO_CLIENT_ID=<CLIO_CLIENT_ID> --env CLIO_CLIENT_SECRET=<CLIO_CLIENT_SECRET> --env ENCRYPTION_KEY=<ENCRYPTION_KEY> --env CLIO_REDIRECT_PORT=<CLIO_REDIRECT_PORT> --env CLIO_REGION=<CLIO_REGION> -- npx -y @oktopeak/clio-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"clio-mcp": {
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>",
"CLIO_REDIRECT_PORT": "<CLIO_REDIRECT_PORT>",
"CLIO_REGION": "<CLIO_REGION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"clio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>",
"CLIO_REDIRECT_PORT": "<CLIO_REDIRECT_PORT>",
"CLIO_REGION": "<CLIO_REGION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e CLIO_CLIENT_ID=<CLIO_CLIENT_ID> -e CLIO_CLIENT_SECRET=<CLIO_CLIENT_SECRET> -e ENCRYPTION_KEY=<ENCRYPTION_KEY> -e CLIO_REDIRECT_PORT=<CLIO_REDIRECT_PORT> -e CLIO_REGION=<CLIO_REGION> clio-mcp npx -y @oktopeak/clio-mcpВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о clio-mcp
Как установить clio-mcp в Claude Code?
Выполните `claude mcp add clio-mcp -e CLIO_CLIENT_ID=<CLIO_CLIENT_ID> -e CLIO_CLIENT_SECRET=<CLIO_CLIENT_SECRET> -e ENCRYPTION_KEY=<ENCRYPTION_KEY> -- npx -y @oktopeak/clio-mcp`.
Что делает clio-mcp?
Он подключает Claude Code к Clio и предоставляет доступ к данным о делах, заметках, документах, папках и биллинге через MCP.
Что нужно подготовить для запуска clio-mcp?
Нужно зарегистрировать приложение Clio и передать его CLIO_CLIENT_ID, CLIO_CLIENT_SECRET вместе с ENCRYPTION_KEY.
