# Basis

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

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: basis1tech
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/basis1tech/basis-oss/tree/HEAD/mcp
- Обновлён: 2026-11-15
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/basis

## Что делает

Basis передаёт агенту инструменты для чтения и проверки книг Excel, анализа формул и связей между ячейками. Книгу можно открыть как сессию, изменить входные значения и получить результаты. Для файлов доступны `path`, `url` или `base64`.

Сервер обращается к Basis API и загружает туда переданные книги; для работы нужны Node.js 20.19 или новее, ключ `BASIS_API_KEY` и сетевое соединение. При установке через `npx` пакет скачивается при первом запуске. Удалённый MCP-сервер тоже доступен, но не может читать файлы с компьютера по `path`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.basis1.tech/mcp`
- Переменные окружения: `BASIS_API_KEY`, `BASIS_BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы**
```bash
claude mcp add --env BASIS_API_KEY=<BASIS_API_KEY> --env BASIS_BASE_URL=<BASIS_BASE_URL> --transport stdio mcp -- npx -y @basis1/mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://api.basis1.tech/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp --url https://api.basis1.tech/mcp
```

2. **Командой платформы**
```bash
codex mcp add mcp --env BASIS_API_KEY=<BASIS_API_KEY> --env BASIS_BASE_URL=<BASIS_BASE_URL> -- npx -y @basis1/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://api.basis1.tech/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@basis1/mcp"
            ],
            "env": {
                "BASIS_API_KEY": "<BASIS_API_KEY>",
                "BASIS_BASE_URL": "<BASIS_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://api.basis1.tech/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@basis1/mcp"
            ],
            "env": {
                "BASIS_API_KEY": "<BASIS_API_KEY>",
                "BASIS_BASE_URL": "<BASIS_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp https://api.basis1.tech/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e BASIS_API_KEY=<BASIS_API_KEY> -e BASIS_BASE_URL=<BASIS_BASE_URL> mcp npx -y @basis1/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- прочитать содержимое книги Excel
- проверить формулы и зависимости ячеек
- сопоставить две книги и найти изменения
- изменить входные значения модели и получить результаты

## Примеры запросов агенту
- Разбери книгу `model.xlsx` и покажи её структуру.
- Проверь формулы в `forecast.xlsx` и проследи связи между ячейками.
- Сравни `before.xlsx` и `after.xlsx`, перечисли изменения в ячейках.

## Похожие
- [cost-basis-engine](https://affpapa.org/nevibecode/skills/cost-basis-engine.md) — скилл · 471 установка
- [xlsx](https://affpapa.org/nevibecode/skills/xlsx.md) — скилл · 187223 установки
- [data-analysis](https://affpapa.org/nevibecode/skills/data-analysis.md) — скилл · 8300 установок
- [xlsx-manipulation](https://affpapa.org/nevibecode/skills/xlsx-manipulation.md) — скилл · 6900 установок
- [minimax-xlsx](https://affpapa.org/nevibecode/skills/minimax-xlsx.md) — скилл · 3900 установок
- [excel-analysis](https://affpapa.org/nevibecode/skills/excel-analysis.md) — скилл · 3031 установка

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