# clio-mcp

Подключает Claude Code к Clio через MCP и даёт работать с делами, заметками, документами и биллингом. Подходит для запросов к данным практики из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Автор: oktopeak
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/oktopeak/clio-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/clio-mcp

## Что делает

clio-mcp подключает Claude Code к Clio через MCP. Сервер читает данные о делах, пользовательских полях, заметках, контактах, документах, папках, задачах, календаре и биллинге. Доступ идёт через API, поэтому клиентские сведения не нужно вручную переносить в чат.

Каждый вызов инструмента записывается в локальный журнал `~/.clio-mcp/audit.log`; токен авторизации хранится в зашифрованном виде. Для запуска нужно зарегистрировать собственное приложение Clio и задать `CLIO_CLIENT_ID`, `CLIO_CLIENT_SECRET` и `ENCRYPTION_KEY`. Без этих значений сервер не подключится к Clio.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `CLIO_CLIENT_ID`, `CLIO_CLIENT_SECRET`, `ENCRYPTION_KEY`, `CLIO_REDIRECT_PORT`, `CLIO_REGION`, `READ_ONLY`, `CLIO_API_BASE`, `CLIO_AUTH_URL`, `CLIO_TOKEN_URL`, `TOKEN_BROKER_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- найти дела и контакты в Clio по запросу
- получить заметки и пользовательские поля дела
- проверить документы и папки через Claude Code
- просмотреть задачи, календарь и биллинг
- записать действия к данным Clio через MCP

## Примеры запросов агенту
- Найди в Clio открытые дела, связанные с этим клиентом.
- Покажи заметки и пользовательские поля для дела с указанным названием.
- Проверь документы, задачи и записи биллинга по этому делу.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md