Документация

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.

Без плагина

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

Терминал
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:

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

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

Claude Code работает в терминале, поэтому файлы с диска он может загрузить через REST API сам — см. Как передать файл.

Эта страница для агентов: Markdown · llms.txt