# pdfops-mcp

Работает с PDF-документами через внешнее API: находит поля AcroForm, заполняет бланки, объединяет файлы и собирает инвойсы без Chromium и системных утилит.

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

## Что делает

Сервер связывает ИИ-агента с облачным API PDFops, избавляя от развёртывания Chromium или библиотек вроде Poppler. Доступны пять инструментов: `pdf_inspect` извлекает структуру интерактивной формы, `pdf_fill` вносит в неё значения, `pdf_merge` склеивает страницы нескольких файлов по порядку, `pdf_invoice` создаёт готовый счёт из структурированных данных, а `pdfops_usage` показывает остаток лимита.

При локальной работе агент оперирует путями в файловой системе, поэтому само содержимое документов не перегружает контекст модели. В облачных средах или через удалённый адрес можно передавать ссылки `https://` либо base64-строки.

Для работы требуется доступ в интернет к сервису `https://pdfops.dev`: без сети обработка не запустится. Бесплатный тариф без токена ограничен 100 запросами на один IP в месяц, а размер одного PDF не может превышать 4 МБ.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://pdfops.dev/api/mcp`

## Установка

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

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

2. **Командой платформы**
```bash
claude mcp add pdfops-mcp -- npx -y pdfops-mcp
```

### Codex

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

2. **Командой платформы**
```bash
codex mcp add pdfops-mcp -- npx -y pdfops-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdfops-mcp": {
            "url": "https://pdfops.dev/api/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdfops-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "pdfops-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdfops-mcp": {
            "type": "http",
            "url": "https://pdfops.dev/api/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdfops-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pdfops-mcp"
            ]
        }
    }
}
```

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini mcp add pdfops-mcp npx -y pdfops-mcp
```

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

## Примеры запросов агенту
- Посмотри форму contract.pdf и перечисли все поля для заполнения.
- Заполни бланк ~/forms/nda.pdf данными клиента и склей результат с cover.pdf.
- Сформируй инвойс за пять часов консультаций по ставке 120 долларов.

## Похожие
- [Excel MCP Server](https://affpapa.org/nevibecode/mcp/excel-mcp-server.md) — MCP-сервер · ★ 4268
- [kordoc](https://affpapa.org/nevibecode/mcp/kordoc.md) — MCP-сервер · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP-сервер · ★ 1085
- [anymd](https://affpapa.org/nevibecode/mcp/anymd.md) — MCP-сервер · ★ 1054
- [Docling MCP](https://affpapa.org/nevibecode/mcp/docling-mcp.md) — MCP-сервер · ★ 779

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