# flatmark

Переводит файлы PDF, Word, PowerPoint, Excel и HTML в Markdown прямо через MCP. Пригодится, когда нужно передать агенту таблицы или сканы документов.

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

## Что делает

Файлы размером до 8 МБ сервер обрабатывает сразу за один вызов через MarkItDown. Если документ тяжелее (до 25 МБ и до 200 страниц), flatmark отправляет его в очередь Docling. Там работают оптическое распознавание текста (OCR) и детекция таблиц, а результат можно забрать поллингом или через вебхук с подписью.

Инфраструктура сервиса расположена в Германии. Анонимный доступ работает без ключа, но с заниженными лимитами, поэтому для постоянной работы надёжнее задать `FLATMARK_API_KEY`. На бесплатном тарифе начисляется 100 кредитов в месяц, причём банковскую карту привязывать не требуют.

## Требования
- Удалённый сервер: `https://api.flatmark.dev/mcp/`

## Установка

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

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

### Codex

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

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "flatmark": {
            "url": "https://api.flatmark.dev/mcp/"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "flatmark": {
            "type": "http",
            "url": "https://api.flatmark.dev/mcp/"
        }
    }
}
```

### Gemini CLI

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

## Когда брать
- сконвертировать таблицы из Excel в чистый Markdown
- извлечь текст со сканированных PDF через OCR
- разобрать слайды PowerPoint без сторонних десктопных программ
- передать HTML-страницу в контекст агента в виде структурированного текста

## Примеры запросов агенту
- Преобразуй файл `report.pdf` в Markdown через flatmark.
- Сделай OCR для скана `invoice.pdf` и сохрани таблицы в формате md.
- Сконвертируй презентацию `slides.pptx` в Markdown-документ.

## Похожие
- [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