# Claude Code

Источник: https://dev.smartpdf.ru/docs/claude-code

Подключить SmartPDF к Claude Code можно плагином — одной командой, или командой `claude mcp add`.

## Плагин SmartPDF

В плагине MCP-сервер и навык `smartpdf` для файлов с компьютера. Ключ Claude Code спросит при установке и сохранит в защищённом хранилище системы.

```
/plugin marketplace add kirmoz1997/smartpdf-agents
/plugin install smartpdf@smartpdf
```

Из терминала — `claude plugin marketplace add kirmoz1997/smartpdf-agents`, затем `claude plugin install smartpdf@smartpdf --config api_key=sk_live_…`. Навыку для файлов с диска нужна ещё переменная `SMARTPDF_API_KEY` с тем же ключом. Исходники — [github.com/kirmoz1997/smartpdf-agents](https://github.com/kirmoz1997/smartpdf-agents).

## Без плагина

Ключ лучше хранить в переменной окружения — Claude Code подставит его при подключении, в настройки он не попадёт.

Claude Code — Терминал:

```bash
export SMARTPDF_API_KEY=sk_live_…   # ключ из личного кабинета
claude mcp add --transport http smartpdf https://mcp.smartpdf.ru/mcp \
  --scope user --header 'Authorization: Bearer ${SMARTPDF_API_KEY}'
```

- Одинарные кавычки обязательны: Claude Code подставит ключ из переменной при подключении, в настройки он не попадёт.

- Проверка — claude mcp list: smartpdf ✓ connected.

## Область видимости

- `--scope user` — во всех ваших проектах (рекомендуем);
- `--scope project` — в файле `.mcp.json` проекта, его можно закоммитить: ключ в нём остаётся ссылкой на переменную;
- без `--scope` — только в текущем проекте.

Тот же сервер в `.mcp.json`:

```json
{
  "mcpServers": {
    "smartpdf": {
      "type": "http",
      "url": "https://mcp.smartpdf.ru/mcp",
      "headers": { "Authorization": "Bearer ${SMARTPDF_API_KEY}" }
    }
  }
}
```

## Локальные файлы

Claude Code работает в терминале, поэтому файлы с диска он может загрузить через REST API сам — см. [Как передать файл](https://dev.smartpdf.ru/docs/files).