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 сам — см. Как передать файл.